明日Dmp人群投放

基于明日DMP开放平台API，提供RTQ投放订单管理功能，支持创建、查询、修改投放订单。采用10步标准化工作流程，包含请求类型识别、凭证检查、参数引导、格式校验、参数确认、任务记录等完整流程。适用于精准广告投放、人群包投放、属性定向投放等场景。

---

概述

本技能基于明日DMP开放平台API，提供RTQ投放订单管理功能，帮助您将圈选的人群包投放到广告平台进行精准投放。

⚠️ 重要声明：

1. 凭证安全责任：您的 Access Key（AK）和 Secret Key（SK）是访问明日 DMP API 的唯一凭证，属于您的敏感私密信息。您对凭证的妥善保管（包括但不限于防止泄露、撤销权限）负全部责任。因凭证泄露、遗失或不当使用导致的一切损失及法律责任，均由您自行承担。
2. 数据合法性责任：使用本技能进行人群圈选、洞察、同步、投放等操作时，您须保证所使用的数据来源合法合规，并已取得必要的用户授权。因数据来源违法、侵权或违反相关法律法规所引发的一切法律责任与纠纷，均由您自行承担，本技能开发者不承担任何连带责任。
3. 操作结果责任：本技能的所有 API 调用结果（包括人群创建、任务状态、数据结果等）均由明日DMP平台提供，本技能开发者对 API 返回内容的准确性、完整性不作任何保证，对因此产生的业务损失不承担责任。
4. 使用即视为同意：继续使用本技能，即表示您已阅读并同意上述免责声明。

🔑 前置准备

使用本技能前，您需要先获取明日DMP API凭证和RTQ投放凭证：

📧 申请方式（二选一）：

方式一：邮件申请

• 发送至：[e-mail]
• 邮件主题：【明日DMP API开通申请】
• 邮件内容：请注明公司名称、联系人、联系方式及使用场景

方式二：在线表单申请

• 填写申请表单：https://doc.weixin.qq.com/forms/ANEAJwfLAAoADMAHwbhAPICNUE0vDRd8f#/fill
• 提交后等待审核通过（通常1-3个工作日）

🔒 凭证格式：

• Access Key：xxxxxxxxxxxxxxxx
• Secret Key：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
• RTQ机房名称：如"明日RTQ机房"
• RTQ Access Key：xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

💡 温馨提示：首次使用时，我会自动引导您完成凭证配置，无需担心！

工作流程

请求类型自动识别

当您发起请求时，系统会自动识别请求类型并进入相应流程：

1. 技能咨询请求（"有哪些功能"、"能做什么"）

• 展示RTQ投放订单管理功能的详细说明
• 直接结束，等待您的下一步需求

2. 查询订单请求（"查询投放订单123456"）

• 直接调用查询脚本
• 展示订单详情（订单ID、订单名称、投放时间、订单状态等）
• 直接结束

3. 修改订单请求（"修改投放订单123456"）

• ⚠️ 强制确认机制：修改前必须经过用户明确确认
• 进入订单修改流程
• 第一步：询问用户要修改哪些参数（订单名称、投放时间、性别、年龄等）
• 第二步：收集完整的修改参数
• 第三步：展示参数确认表格，清晰列出所有修改内容
• 第四步：等待用户明确回复"确认"、"是"、"可以"等确认词
• 第五步：用户确认后才调用修改脚本执行修改
• 重要：如果用户回复"取消"或"修改"，则不执行修改操作

4. 创建投放请求（包含"投放"、"订单"、"RTQ"等关键词）

• 进入完整的创建流程（见下方）

创建投放订单完整流程

流程执行规则:

• ✅ 必须执行：第一步~第十步（所有步骤都必须执行）
• ⚠️ 严格禁止跳过任何步骤，特别是第八步（任务记录检查）
• 📌 第八步虽然用户可以选择不安装，但必须执行检查和询问流程

第一步：请求类型识别 [必须执行]

系统会根据您的需求关键词，识别出请求类型。

识别规则：

• 包含"投放"、"订单"、"RTQ"、"创建投放" → 创建投放请求
• 包含"查询"、"订单ID" → 查询订单请求
• 包含"修改"、"调整" → 修改订单请求
• 包含"有哪些功能"、"能做什么" → 技能咨询请求

第二步：鉴权技能检查与凭证配置 [必须执行]

确认请求类型后，系统会立即检查鉴权技能是否已安装，并配置API凭证：

完整检查流程：

步骤2.1：检查鉴权技能是否已安装

系统会自动检查鉴权技能（mingdata-dmp-auth，skill_id: 9164）是否已安装：

检查路径：~/.skills/9164/ 或通过技能列表查询

如果已安装 → 继续步骤2.2（检查凭证）

如果未安装 → 展示以下内容，等待用户选择：

💡 检测到您尚未安装【明日DMP鉴权技能】

该技能是使用人群投放功能的必需组件，负责管理API访问凭证和签名生成。

功能包括：
- 安全存储API访问凭证（Access Key和Secret Key）
- 自动生成API请求签名
- 统一管理所有明日DMP API调用

是否需要自动下载并安装鉴权技能？
1. 是 - 自动下载并启用鉴权功能
2. 否 - 取消本次操作（不安装无法使用投放功能）

请回复：是/否

用户回复处理：

• 用户回复"是"：

  • 使用 terminal 工具执行：openclaw skills install mingdata-dmp-auth
  • 等待命令执行完成
  • 安装成功：提示 ✅ 鉴权技能安装成功 → 继续步骤2.2
  • 安装失败：展示以下内容，等待用户选择：

    ❌ 鉴权技能自动安装失败
    
    请选择处理方式：
    A. 手动安装 - 前往 ClawHub 安装后告诉我"已安装完成"：
       👉 https://clawhub.ai/mingri26/dmp-auth
       步骤：① 打开链接 → ② 点击「Download」→ ③ 回复"已安装完成"
    B. 取消操作 - 终止本次投放订单创建
    
    请回复：A/B
    

  • 用户回复 A：等待用户确认安装完成 → 继续步骤2.2
  • 用户回复 B：提示 已取消操作 → 终止流程

• 用户回复"否"：

  • 提示：已取消操作，不安装鉴权技能无法使用投放功能。
  • 终止流程

步骤2.2：检查凭证配置

鉴权技能安装成功后，检查是否已配置API凭证：

检查路径：~/.mingdata_dmp_credentials

如果凭证已配置 → 继续第三步（参数完整性检查）

如果凭证未配置 → 展示凭证获取指引：

🔑 明日DMP API凭证获取指南

您需要先获取明日DMP的API访问凭证和RTQ投放凭证，才能使用人群投放功能。

📧 申请方式（二选一）：

方式一：邮件申请
- 发送开通申请至：[e-mail]
- 邮件主题：【明日DMP API开通申请】
- 邮件内容：请注明公司名称、联系人、联系方式及使用场景

方式二：在线表单申请
- 填写在线申请表单：https://doc.weixin.qq.com/forms/ANEAJwfLAAoADMAHwbhAPICNUE0vDRd8f#/fill
- 提交后等待审核通过（通常1-3个工作日）

🔒 需要的凭证信息：
- Access Key：API访问密钥
- Secret Key：API密钥
- RTQ机房名称：如"明日RTQ机房"
- RTQ Access Key：RTQ投放密钥

获取凭证后，请按以下格式提供给我：
Access Key: xxxxxxxxxxxxxxxxxxxx
Secret Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
RTQ机房名称: 明日RTQ机房
RTQ Access Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

凭证配置后：

• 系统会自动保存凭证到本地配置文件（~/.mingdata_dmp_credentials）
• 后续操作将自动使用已保存的凭证
• 凭证过期时会自动提示重新配置

第三步：参数完整性检查 [必须执行]

凭证检查通过后，系统会检查必填参数是否齐全。

RTQ投放订单必填参数：

• 订单名称（dealName）
• 投放开始日期（startDate）
• 投放结束日期（endDate）
• 流量类型（flowType）
• 性别定向（gender）
• 年龄定向（age）
• 是否使用人群包（isTag）
• 人群包列表（audiences，当isTag=true时必填）

第三步之一：人群ID验证 [使用人群包时必须执行]

⚠️ 强制人群验证机制（v1.1.0新增）

当用户提供人群ID时，系统会强制执行人群验证，获取真实的人群名称和量级，禁止使用默认值：

验证流程：

1. 调用 /audience/manage/taskList 接口查询人群状态
2. 验证人群是否存在
3. 检查人群状态（成功/失败/等待中/计算中）
4. 强制获取真实的人群名称和量级（禁止使用audienceCount: 0）
5. 构建完整的audiences参数

验证结果处理：

✅ 人群状态为"成功"（audienceStatus=1）且量级>0

✅ 人群验证成功！
  - 人群ID：125621
  - 人群名称：测试一下1
  - 人群量级：5,043,357
  - 人群状态：成功
  - 创建时间：2025-10-14 19:01:25

继续创建订单...

❌ 人群量级为0（数据错误）

⚠️ 警告：人群量级为0，可能导致投放数据不准确
⚠️ 请确认人群ID 125621 是否正确

❌ 错误：人群量级为0，禁止创建订单
❌ 这可能是数据错误，请检查人群ID或重新圈选人群

❌ 人群不存在或ID无效

❌ 人群ID 13216 不存在或无效
❌ 人群验证失败，无法创建订单

⚠️ 不能自动改用属性定向，请用户明确选择：

选项1：使用属性定向（性别+年龄）创建订单
  - 需要提供性别和年龄参数
  - 不使用人群包，仅基于基础属性定向

选项2：检查人群ID是否正确，或等待人群计算完成后重试

选项3：查询可用的人群列表，选择正确的人群ID

请告知用户选择哪个选项，不要自动决定。

⏳ 人群正在计算中（audienceStatus=2或3）

⏳ 人群ID 125621 正在计算中
  - 人群名称：美妆女性人群
  - 当前状态：计算中
  - 创建时间：2025-07-15 15:35:39

建议：
1. 等待人群计算完成后再创建订单
2. 或者先使用属性定向创建订单

请用户明确选择，不要自动决定。

❌ 人群创建失败（audienceStatus=0）

❌ 人群ID 125621 创建失败，不能使用

建议：
1. 使用属性定向（性别+年龄）创建订单
2. 重新圈选人群

请用户明确选择，不要自动决定。

💡 验证优势（v1.1.0强化）：

• ✅ 强制验证人群量级：禁止使用audienceCount: 0的默认值，确保数据准确
• ✅ 获取真实人群信息：自动从API获取人群名称和量级，避免硬编码
• ✅ 不自动改用属性定向：验证失败时提示用户选择，而非自动决定
• ✅ 提升数据准确性：确保投放订单使用真实的人群量级数据

第四步：主动询问缺失参数 [必须执行]

参数不完整时，系统会主动询问并提供选项枚举。

参数1：订单名称（dealName）

请提供投放订单名称：
- 建议：美妆人群投放订单、母婴用户精准投放等
- 长度限制：≤100字符
- 您的订单名称：[等待用户输入]

参数2：投放时间（startDate / endDate）

请设置投放时间：
- 格式：YYYY-MM-DD
- 开始日期：[等待用户输入]
- 结束日期：[等待用户输入]
- 示例：2026-06-10 至 2026-06-20

参数3：流量类型（flowType）

请选择投放的流量类型：
1. pc（PC端流量）
2. mobile（移动端流量）
3. ott（OTT/智能电视流量）

💡 说明：
- PC端需要额外指定cookieType（mzuid/muid）
- 移动端和OTT端无需额外参数

您的选择：[等待用户输入]

参数4：性别定向（gender）

请选择目标性别：
1. male（男性）
2. female（女性）
3. all（不限）

您的选择：[等待用户输入]

参数5：年龄定向（age）

请选择目标年龄段（可多选，用逗号分隔）：
- 15-17（15-17岁）
- 18-19（18-19岁）
- 20-24（20-24岁）
- 18-24（18-24岁，自动转换为18-19+20-24）
- 25-29（25-29岁）
- 30-34（30-34岁）
- 25-34（25-34岁，自动转换为25-29+30-34）
- 35-39（35-39岁）
- 40-44（40-44岁）
- 35-44（35-44岁，自动转换为35-39+40-44）
- 45-49（45-49岁）
- 50-54（50-54岁）
- 45-54（45-54岁，自动转换为45-49+50-54）
- 55-59（55-59岁）
- 60-100（60-100岁）
- 55+（55岁以上，自动转换为55-59+60-100）
- all（全年龄）

💡 说明：
- 系统会自动将用户友好的年龄段转换为API所需的枚举值
- 例如：输入"18-24"会自动转换为"18-19"和"20-24"两个枚举值
- 支持多个年龄段组合，用逗号分隔

示例：18-24,25-34
您的选择：[等待用户输入]

参数6：是否使用人群包定向（isTag）

您是否需要使用自定义人群包进行精准定向？

1. 是（使用人群包，需要提供人群ID和名称）
2. 否（仅使用性别、年龄等基础定向）

💡 说明：
- 选择"是"可以使用DMP圈选的精准人群包
- 选择"否"仅使用性别、年龄等基础定向条件

您的选择：[等待用户输入]

参数7：人群包列表（audiences，当isTag=true时必填）

请提供要投放的人群包信息：

格式：人群ID,人群名称（多个人群用分号分隔）
示例：123456,美妆女性人群;789012,高消费人群

您的人群包：[等待用户输入]

第五步：参数格式校验 [必须执行]

系统会检查参数格式是否正确：

• 订单名称：≤100字符
• 投放时间：YYYY-MM-DD格式，结束日期≥开始日期
• 流量类型：pc/mobile/ott枚举值
• 性别：male/female/all枚举值
• 年龄：有效年龄段格式（18-24,25-34,35-44,45-54,55+）
• 人群包：有效JSON格式，包含audienceId和audienceName

格式错误时会提示正确格式示例。

第六步：参数确认 [必须执行]

⚠️ 这是强制性步骤，绝对不能跳过！

必须执行的完整确认流程：

1. 生成参数确认表格

   • 以表格形式展示所有参数
   • 包含所有关键信息（见下方表格格式）
   • 使用清晰的格式，便于用户检查

2. 等待用户明确确认

   • 必须等待用户回复"确认"、"是"、"可以"等明确的确认词
   • 不允许在用户未确认前直接调用API
   • 用户可以选择"修改"、"取消"或"确认"

3. 处理用户响应

   • 用户确认 → 进入第七步（执行创建）
   • 用户要求修改 → 返回第四步（参数补充）
   • 用户取消 → 终止流程，提示"已取消本次操作"

参数确认表格格式：

📋 投放订单参数确认

| 参数名称 | 参数值 |
|----------|--------|
| 订单名称 | 美妆女性精准投放 |
| 开始日期 | 2026-06-10 |
| 结束日期 | 2026-06-20 |
| 流量类型 | mobile（移动端） |
| 性别定向 | female（女性） |
| 年龄定向 | 25-34,35-44 |
| 使用人群包 | 是 |
| 人群包列表 | 123456-美妆女性人群 |

⚠ 请仔细核对以上参数，确认无误后订单将立即创建。

是否确认创建投放订单？
请回复：确认 / 取消 / 修改

第七步：执行创建 [必须执行]

⚠️ 前置条件：必须在用户明确确认后才能执行

执行流程：

1. 调用scripts/create_rtq_deal.py脚本
2. 脚本通过鉴权技能调用明日DMP API
3. 处理API返回结果
   • 成功 → 获取订单ID → 进入第八步（任务记录检查）
   • 失败 → 展示错误信息并终止流程

第八步：任务记录检查 [⚠️ 禁止跳过]

⚠️ 严重警告：

• 这是强制性步骤，每次创建订单时都必须执行
• 即使用户不需要记录，也必须执行检查并向用户展示检查结果
• 直接从第七步跳到第九步视为严重流程错误

必须执行的完整检查流程：

1. 检查skill-logger技能是否已安装

   检查路径：~/.skills/skill-logger/ 或通过技能列表查询
   

2. 如果已安装 → 自动调用记录功能，保存任务信息，并向用户展示记录结果

   • 记录内容：订单ID、订单名称、创建时间、参数配置
   • 必须向用户展示：

   ✅ 任务记录技能已安装
   ✅ 任务已自动记录到历史
      - 任务ID：RTQ投放订单_20260605090454
      - 存储路径：/home/sandbox/.skill-logger/task_history.json
   

3. 如果未安装 → 必须询问用户，不能直接跳过

   💡 检测到您尚未安装【任务记录技能】
   
   该技能可以自动记录您的所有投放订单任务，方便后续查询和管理。
   
   功能包括：
   - 自动记录订单ID、订单名称、创建时间
   - 保存完整的参数配置
   - 追溯历史操作记录
   
   是否需要自动下载并安装任务记录技能？
   1. 是 - 自动下载并启用任务记录功能
   2. 否 - 本次不安装（不影响投放功能，但无法记录任务历史）
   
   请回复：是/否
   

4. 等待用户明确回复

   • 用户回复"是"：

     • 使用 terminal 工具执行：openclaw skills install skill-logger
     • 等待命令执行完成
     • 安装成功：提示 ✅ 任务记录技能安装成功 → 继续第九步（记录任务）
     • 安装失败：展示以下内容，等待用户选择：

       ❌ 任务记录技能自动安装失败
       
       请选择处理方式：
       A. 手动安装 - 前往 ClawHub 安装后告诉我"已安装完成"：
          👉 https://clawhub.ai/mingri26/dmp-skill-logger
          步骤：① 打开链接 → ② 点击「Download」→ ③ 回复"已安装完成"
       B. 跳过安装 - 本次不记录任务历史，直接进入下一步
       
       请回复：A/B
       

     • 用户回复 A：等待用户确认安装完成 → 继续第九步（记录任务）→ 进入第十步
     • 用户回复 B：提示 已跳过任务记录 → 直接进入第十步

   • 用户回复"否"：

     • 提示：已跳过任务记录，不影响主流程。
     • 直接进入第十步

第九步：记录任务 [条件执行]

如果用户选择安装任务记录技能，则执行任务记录：

• 任务类型：RTQ投放订单创建
• 订单ID：从API返回结果中获取
• 订单名称：用户提供的订单名称
• 创建时间：当前时间
• 投放时间：开始日期至结束日期
• 人群包：人群ID和人群名称
• 定向条件：性别、年龄等

第十步：结果展示 [必须执行]

成功时：

展示订单创建成功信息：

✅ 投放订单创建成功！

📋 订单信息：
- 订单ID：30000933
- 订单名称：美妆女性精准投放
- 投放时间：2026-06-10 至 2026-06-20
- 订单状态：可用
- 创建时间：2026-06-05 10:30:00

📊 投放配置：
- 流量类型：移动端（mobile）
- 性别定向：女性
- 年龄定向：25-34岁，35-44岁
- 人群包：123456-美妆女性人群

💡 后续操作建议：

投放订单创建成功后，您可以进行以下操作：

1. **查询订单状态**
   - 功能：查看订单详情、投放进度
   - 操作方式：告诉我"查询投放订单30000933"

2. **修改订单参数**
   - 功能：调整投放时间、人群包、定向条件
   - 适用场景：需要优化投放策略或调整投放参数
   - 操作方式：告诉我"修改投放订单30000933"

3. **下载人群洞察技能**
   - 功能：分析投放人群的画像特征
   - 适用场景：优化投放策略，了解目标人群特征
   - 操作方式：告诉我"下载人群洞察技能"

4. **下载人群圈选技能**
   - 功能：根据投放效果优化人群圈选规则
   - 适用场景：需要调整或扩大目标人群范围
   - 操作方式：告诉我"下载人群圈选技能"

失败时：

展示错误详情、可能原因、解决方案

技能依赖说明

本技能需要配合鉴权技能使用，以确保功能完整性和操作可追溯性：

1. 鉴权技能（mingdata-dmp-auth）

作用： 管理明日DMP API的访问凭证（Access Key和Secret Key）

调用时机：

• 首次使用本技能时
• 凭证过期或失效时
• 任何需要调用明日DMP API的操作前

是否必需： ✅ 必需（不安装无法使用投放功能）

2. 任务记录技能（skill-logger）

作用： 自动记录所有投放订单的创建记录、参数配置和执行结果

调用时机：

• 每次成功创建投放订单后
• 用于后续查询历史任务、追溯操作记录

是否必需： ⭕ 可选（不安装不影响投放功能，但无法记录任务历史）

支持的功能

1. RTQ投放订单创建

功能说明： 创建RTQ投放订单，支持人群包定向和属性定向

适用场景： 精准广告投放、人群包投放、属性定向投放

必填参数： 订单名称、投放时间、流量类型、性别定向、年龄定向、是否使用人群包

示例： "创建投放订单，投放人群125621到移动端，目标女性用户，年龄25-44岁，投放时间6月1日到6月3日"

2. RTQ投放订单查询

功能说明： 查询已创建的投放订单详情

适用场景： 查看订单状态、投放进度

必填参数： 订单ID（可选）、订单名称（可选）、订单状态（可选）

示例： "查询投放订单30000933"

3. RTQ投放订单修改（智能参数引导）

功能说明： 修改已创建的投放订单参数，支持智能参数引导和强制确认流程

适用场景： 调整投放时间、人群包、定向条件

✨ 智能参数引导特性：

本技能支持两种修改模式，根据订单来源自动选择：

模式A：智能修改（本技能创建的订单）

• ✅ 自动从本地缓存读取订单的完整参数
• ✅ 用户只需提供要修改的参数（如订单名称）
• ✅ 其他参数自动保持不变
• ✅ 体验流畅，无需重复输入

模式B：完整参数引导（其他来源的订单）

• ⚠️ 由于无法查询订单详情，需要用户提供完整参数
• ✅ 逐步引导用户提供必需参数
• ✅ 每个参数都有清晰的说明和选项
• ✅ 避免一次性要求太多参数

⚠️ 强制确认机制：

• 修改前必须展示参数确认表格
• 必须等待用户明确回复"确认"、"是"、"可以"等确认词
• 用户回复"取消"或"修改"则不执行修改操作
• 禁止在未经用户确认的情况下自动执行修改

修改流程（智能引导流程）：

1. 识别修改请求 - 检测到"修改订单"关键词和订单ID

2. 检查订单缓存 - 自动检查本地是否有该订单的缓存

   • ✅ 找到缓存 → 进入智能修改模式（只需提供要修改的参数）
   • ⚠️ 未找到缓存 → 进入完整参数引导模式（需要提供所有参数）

3. 参数收集

   智能修改模式（找到缓存）：

   • 展示订单当前参数
   • 询问用户要修改哪些参数
   • 用户只需提供要修改的参数（如订单名称）
   • 其他参数自动从缓存读取

   完整参数引导模式（未找到缓存）：

   • 逐步询问用户提供必需参数：
     • 订单名称
     • 投放时间（开始日期、结束日期）
     • 流量类型（mobile/pc/ott）
     • 性别定向（male/female/all）
     • 年龄定向（18-24, 25-34, 35-44, 45-54, 55+）
     • 是否使用人群包（true/false）
     • 人群包信息（当isTag=true时）
     • Cookie类型（当flowType=pc时）

4. 参数确认 - 展示完整的参数确认表格：

   📋 修改订单参数确认
   
   | 参数名称 | 参数值 |
   |----------|--------|
   | 订单ID   | 30003269 |
   | 订单名称 | 女性美妆投放 |
   | 开始日期 | 2026-06-15 |
   | 结束日期 | 2026-06-25 |
   | 性别定向 | 女性 |
   | 年龄定向 | 25-34岁, 35-44岁 |
   
   ⚠ 请仔细核对以上参数，确认无误后订单将立即修改。
   
   是否确认修改订单？
   请回复：确认 / 取消 / 修改
   

5. 等待用户确认 - 必须等待用户明确回复：

   • 用户回复"确认"、"是"、"可以" → 执行修改
   • 用户回复"取消"、"修改" → 取消操作，不执行修改
   • 用户回复其他内容 → 提示"无效输入，请回复：确认 / 取消 / 修改"

6. 执行修改 - 仅在用户明确确认后调用API修改订单

7. 更新缓存 - 修改成功后自动更新本地缓存，方便下次修改

示例对话A：智能修改模式（本技能创建的订单）

用户："修改订单30003269的名称为'测试数据'"

AI："✅ 找到订单30003269的缓存信息

📋 当前订单参数：
  - 订单名称：女性美妆投放
  - 投放时间：2026-06-15 至 2026-06-25
  - 流量类型：移动端
  - 性别定向：不限
  - 年龄定向：25-34岁, 35-44岁

📋 修改订单参数确认

| 参数名称 | 参数值 |
|----------|--------|
| 订单ID   | 30003269 |
| 订单名称 | 测试数据 |
| 开始日期 | 2026-06-15 |
| 结束日期 | 2026-06-25 |
| 流量类型 | mobile |
| 性别定向 | 不限 |
| 年龄定向 | 25-34, 35-44 |

是否确认修改订单？
请回复：确认 / 取消 / 修改"

用户："确认"

AI："✅ 订单修改成功！
订单ID: 30003269
订单名称: 测试数据
投放时间: 2026-06-15 至 2026-06-25"

示例对话B：完整参数引导模式（其他来源的订单）

用户："修改订单30000700的名称"

AI："⚠️ 未找到订单30000700的缓存信息

由于无法查询到订单的完整参数，需要您提供以下信息：

请提供新的订单名称："

用户："新订单名称"

AI："好的，订单名称将修改为：新订单名称

请提供投放时间：
  - 开始日期（格式：YYYY-MM-DD）：
  - 结束日期（格式：YYYY-MM-DD）："

用户："2026-06-10 到 2026-06-20"

AI："好的，投放时间：2026-06-10 至 2026-06-20

请选择流量类型：
  1. mobile（移动端）
  2. pc（PC端）
  3. ott（OTT端）

您的选择："

用户："1"

AI："好的，流量类型：移动端

请选择性别定向：
  1. male（男性）
  2. female（女性）
  3. all（不限）

您的选择："

用户："3"

AI："好的，性别定向：不限

请选择年龄定向（可多选，用逗号分隔）：
  - 18-24（18-24岁）
  - 25-34（25-34岁）
  - 35-44（35-44岁）
  - 45-54（45-54岁）
  - 55+（55岁以上）

您的选择："

用户："25-34,35-44"

AI："好的，年龄定向：25-34岁, 35-44岁

是否使用人群包？
  1. 是（需要提供人群包信息）
  2. 否（仅使用性别、年龄等基础定向）

您的选择："

用户："2"

AI："好的，不使用人群包

📋 修改订单参数确认

| 参数名称 | 参数值 |
|----------|--------|
| 订单ID   | 30000700 |
| 订单名称 | 新订单名称 |
| 开始日期 | 2026-06-10 |
| 结束日期 | 2026-06-20 |
| 流量类型 | mobile |
| 性别定向 | 不限 |
| 年龄定向 | 25-34, 35-44 |
| 使用人群包 | 否 |

是否确认修改订单？
请回复：确认 / 取消 / 修改"

用户："确认"

AI："✅ 订单修改成功！"

示例对话：

用户："修改订单30003269的名称"

AI："好的，您想将订单30003269的名称修改为什么？"

用户："改为女性美妆投放"

AI：展示参数确认表格，等待用户确认

用户："确认"

AI：执行修改操作

参数格式要求

RTQ投放订单参数

参数名称	格式要求	验证规则
订单名称	字符串	≤100字符
投放时间	YYYY-MM-DD	有效日期格式，结束日期≥开始日期
流量类型	枚举值	pc/mobile/ott
性别	枚举值	male/female/all
年龄	数组	有效年龄段（18-24,25-34,35-44,45-54,55+）
Cookie类型	枚举值	mzuid/muid（flowType=pc时必填）
人群包	JSON数组	有效JSON格式，包含audienceId和audienceName

常见问题

Q: 凭证过期了怎么办？

A: 系统会自动调用鉴权技能引导您重新配置凭证。

Q: 创建订单后多久能生效？

A: RTQ投放订单创建成功后立即生效，您可以通过查询订单状态功能查看详情。

Q: 如何知道订单创建是否成功？

A: 订单创建成功后会返回订单ID和订单状态，您可以使用查询订单状态功能查看详情。

Q: 参数填错了怎么办？

A: 在参数确认表格展示后，您可以回复"取消"来取消本次操作，然后重新提出需求。

Q: 系统如何识别我的需求类型？

A: 系统会自动分析您的请求内容：

• 包含"有哪些功能"、"能做什么" → 技能咨询
• 包含"查询订单" + 订单ID → 查询订单状态
• 包含"修改订单" + 订单ID → 修改订单
• 包含"投放"、"订单"、"RTQ" → 创建投放订单

技术说明

本技能通过Python脚本调用明日DMP开放平台API，所有脚本位于 scripts/ 目录：

凭证管理：

• scripts/setup_credentials.py - 凭证配置

投放订单：

• scripts/create_rtq_deal.py - 创建RTQ投放订单
• scripts/query_rtq_deal.py - 查询投放订单
• scripts/modify_rtq_deal.py - 修改投放订单