Yufluent Clawhub Publish Yufluentcn Record Outcome

效果回传

将此前 Listing / SEO / 广告等技能返回的 run_id 与卖家反馈的销量、点击、曝光等登记到 Yufluent 效果闭环，用于后续模型优化和效果归因。

注意：本技能不走 POST /v1/skills/*/run，仅走 POST /v1/agent/outcomes（与 OpenClaw 对话共用同一 tk-*）。不调用 Harness 生成内容。

快速开始（3 步，60 秒）

1. 注册获取 API 密钥 → https://claw.changzhiai.com/login （新用户即送体验积分，无需绑卡）
2. 设置环境变量：export TOKENAPI_KEY=*** 或写入 .env 文件
3. 运行：参照下方 Examples 示例执行 python scripts/run.py ...

还没注册？前往 https://claw.changzhiai.com/login 免费获取密钥。

OpenClaw 与 Yufluent（必读）

OpenClaw 对话与本技能共用同一 tk-*。接入见 https://claw.changzhiai.com/app/openclaw。

Agent 硬性规则：

• 禁止用对话模型自行构造 POST /v1/agent/outcomes 请求或编造效果数据。
• 必须通过 python scripts/run.py ... 登记效果。
• 只需 TOKENAPI_KEY，不要另配 Key

Instructions（Agent 工作流）

1. 触发时机：用户说「Listing 上架了」「这周卖了 20 单」且对话里出现过 run_id=hr_xxx。
2. 收集参数：
   • --run-id（必填）：之前技能输出中的 run_id
   • --event：事件类型（默认 published，可选 sale）
   • --orders / --impressions / --clicks：效果数据
   • --notes：备注如 "Amazon US 首周"
3. 调用：

   python scripts/run.py \
     --run-id "hr_abc123" \
     --event sale \
     --orders 20 \
     --notes "Amazon US 首周"
   

4. 无需计费：仅登记，不消耗 Harness Token。

参数说明

环境变量

触发词

• "帮我记录效果"
• "上架后有销量了"
• "run_id 回传"
• "效果登记"
• "Listing 出单了"
• "登记一下"

Examples

商品上架回传

python scripts/run.py \
  --run-id "hr_abc123" \
  --event published \
  --external-id "B0XXXXXXX" \
  --notes "Amazon US 上架"

销量回传

python scripts/run.py \
  --run-id "hr_abc123" \
  --event sale \
  --orders 20 \
  --revenue-cny 15000 \
  --impressions 5000 \
  --clicks 320 \
  --notes "首周数据"

工作原理

跑 Listing/SEO 技能 → 输出 run_id → 过段时间有销量 → 调 record-outcome 回传
                                                    ↓
                                            Yufluent 累计效果数据
                                                    ↓
                                        后续模型优化 / 归因分析

合规声明

• 仅登记用户主动提供的数据，不抓取平台后台
• 不自动获取 ASIN、订单号或任何卖家敏感数据

版本记录