📚 Harness 学习计划 / 产出归档 / 营销活动创建Agent化方案

营销活动创建 Agent 化方案

讨论日期：2026-08-25
状态：方案讨论完成，待输出 PRD
范围：优惠券活动、规则活动、直降活动

一、背景

当前运营创建营销活动（优惠券/规则/直降）的流程：

运营准备 Excel（含各渠道金额）→ 逐渠道手工打开创建表单 → 逐字段填写 → 提交

核心痛点：

二、核心设计原则

Agent 不做"自动执行"，做"智能填表 + 人工确认"。

运营输入（Excel/自然语言）→ Agent 解析 → 填表 → 汇总确认 → 批量创建 → 结果反馈
                                  ↑                    ↑
                            智能解析阶段          人工确认阶段

两个关键设计：

原则 说明
确认优先 任何批量创建前，必须先展示汇总表让运营确认
可回退 确认阶段运营可以修改任意字段，校准后再提交

三、Agent 交互流程

完整流程

┌─────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│ 运营输入     │ →  │ Agent 解析   │ →  │ 确认 + 微调  │ →  │ 批量执行     │
│ Excel/文字   │    │ 结构化提取   │    │ 汇总表展示   │    │ 逐行创建     │
└─────────────┘    └──────────────┘    └──────────────┘    └──────────────┘
                                                              ↓
                                                      ┌──────────────┐
                                                      │ 结果反馈     │
                                                      │ 成功/失败明细│
                                                      └──────────────┘

步骤详解

Step 1：运营输入

两种输入方式：

方式 示例 场景
自然语言 "在 US/UK/EU 创建满 100 减 20 的商品券，9.1-9.15" 简单活动，参数少
Excel 导入 含渠道/金额/时间/商品的多行表格 主要场景，批量活动

Excel 示例（运营当前提供的内容）：

渠道    优惠券名称        类型    门槛    优惠    开始时间            结束时间            商品范围
US      中秋促销-满减券    满减    100     20     2026-09-01 00:00   2026-09-15 23:59   兔笼分类
UK      中秋促销-满减券    满减    78      16     2026-09-01 00:00   2026-09-15 23:59   兔笼分类
EU      中秋促销-满减券    满减    92      18     2026-09-01 00:00   2026-09-15 23:59   兔笼分类
DE      中秋促销-满减券    满减    90      18     2026-09-01 00:00   2026-09-15 23:59   兔笼分类

Step 2：Agent 解析并填表

Agent 需要做的事情：

  1. 列映射：识别 Excel 列对应 API 哪个字段

    • "渠道" → countryCode
    • "门槛" → satisfyMoney
    • "优惠" → deductionMoney
    • "商品范围" → 模糊匹配 → 查商品分类 API 获取 ID

  2. 参数校验：

    • 渠道是否有效？（US/UK/EU/DE/JP/KR/AU...）
    • 金额是否合法？（正数，币种单位正确）
    • 时间是否合理？（开始 < 结束，不早于当前时间）
    • 商品分类是否存在？

  3. 缺失字段补全：

    • 运营没填的字段 → 用默认值（如"每人限领 1 张"）
    • 或标记为"需确认"

Step 3：确认 + 微调

Agent 展示汇总表，运营可以：

┌──────────────────────────────────────────────────────────────────┐
│  📋 即将创建以下 4 张优惠券，请确认：                               │
│                                                                  │
│  渠道 │ 名称           │ 类型 │ 门槛  │ 优惠 │ 时间              │ 商品  │
│  US   │ 中秋促销-满减券 │ 满减 │ $100  │ $20  │ 9.1-9.15         │ 兔笼  │ ✏️
│  UK   │ 中秋促销-满减券 │ 满减 │ £78   │ £16  │ 9.1-9.15         │ 兔笼  │ ✏️
│  EU   │ 中秋促销-满减券 │ 满减 │ €92   │ €18  │ 9.1-9.15         │ 兔笼  │ ✏️
│  DE   │ 中秋促销-满减券 │ 满减 │ €90   │ €18  │ 9.1-9.15         │ 兔笼  │ ✏️
│                                                                  │
│  ⚠️ 第 3 行 EU 金额与 DE 相同，请确认是否正确                       │
│                                                                  │
│  [导出 Excel 修改后重新导入]  [单行编辑]  [确认创建]                │
└──────────────────────────────────────────────────────────────────┘

微调能力：

Step 4：批量执行 + 结果反馈

┌──────────────────────────────────────────────────────────────────┐
│  ✅ 创建完成：3 成功，1 失败                                        │
│                                                                  │
│  渠道 │ 结果   │ 详情                                             │
│  US   │ ✅ 成功 │ 券 ID：12345                                    │
│  UK   │ ✅ 成功 │ 券 ID：12346                                    │
│  EU   │ ✅ 成功 │ 券 ID：12347                                    │
│  DE   │ ❌ 失败 │ 原因：该渠道已存在同时间段同商品范围的券           │
│                                                                  │
│  [重试失败项] [导出结果 Excel]                                      │
└──────────────────────────────────────────────────────────────────┘

四、Agent 需要处理的边界场景

场景 Agent 行为
Excel 列名不规范（如"渠道"写成"站点"） Agent 做模糊列名匹配，匹配不到时让运营手动映射
商品范围写的是"兔笼"而非分类 ID Agent 调商品分类 API 模糊搜索 → 匹配到 ID
某行数据不完整（缺少金额） 标记为"需补充"，不参与批量创建
创建中途某渠道失败 不中断，其他渠道继续创建，最后汇总失败项
运营想修改已创建的活动 不支持 Agent 修改，引导到现有编辑页面

五、Agent Tool 设计（初稿）

Tool 输入 输出
parse_activity_excel Excel 文件 结构化数据（含校验结果）
preview_activities 结构化数据 汇总表（含异常标记）
batch_create_activities 确认后的数据 逐行执行结果
search_product_category 分类名称 分类 ID 列表
search_product_sku SKU 名称/编码 SKU 列表

六、待讨论