Agent/examples/auto_put_ad/TODO.md

自动化投放系统 - 待办事项

已完成 (2026-04-09)

• [x] config.py 工具白名单：分析 Agent 只暴露只读工具，执行 Agent 暴露全部业务工具

  • ANALYSIS_TOOLS: 不含写操作工具
  • EXECUTION_TOOLS: 包含 execute_adjustment_plan、bid_adjustment_execute 等

• [x] 执行 Agent 实现：

  • tools/execute_agent.py：execute_adjustment_plan 工具（加载/验证/执行/关停/监控一体化）
  • prompts/execute.prompt：执行 Agent 系统提示词
  • run_execute.py：独立运行入口
  • presets.json：新增 execute Agent 预设

• [x] 冷启动保护：

  • SQL 新增 create_time（广告创建时间）和 conversions_count（转化量）字段
  • 冷启动判定：create_time < 48h 或 conversions_count < 6 → 标记 observe 不调价
  • 赔付门槛保护：conversions 3-5 的广告不执行关停

• [x] budget_strategy.md 领域知识更新：

  • 调价规则（幅度限制、间隔、频率）
  • 冷启动保护规则
  • 出价与消耗的非线性关系
  • 关停保护规则（赔付门槛）

• [x] 执行后监控集成：execute_adjustment_plan 执行完成后自动触发 monitor_check_metrics

• [x] import 路径修复：monitor_tools.py、audience_tools.py 的相对 import 改为绝对 import

P0 — 灰度上线前（目标 0422）

• [ ] 广告创建能力串联

  • 扩量场景下新建广告完整流程：定向 + 出价 + 创意一体化创建
  • 先实现"复制高效广告"的简化版本

• [ ] 监控定时触发

  • 定时任务（cron/scheduler）每小时调用监控 Agent
  • 或在执行 Agent 完成后自动触发（已部分实现）
  • 异常时通知运营

• [ ] 端到端测试

  • dry-run 模式验证完整链路
  • API mock 测试（不实际调用腾讯广告 API）
  • test_budget.py 扩展覆盖冷启动保护逻辑

• [ ] 配置统一管理

  • ODPS 连接信息从 odps_module.py 硬编码移到环境变量
  • 腾讯广告 API 配置统一到 config.py

P1 — 完整能力集成（目标 0430）

• [ ] 人群策略深化：人群包效果分析 → 自动推荐定向组合 → 新建广告时自动选包

• [ ] 素材策略：素材衰退检测 → 素材-人群匹配 → 创意自动组合

• [ ] 公众号渠道预算：daily 核心 roi（GT/GW）和即转 roi

  • 等公众号数据就绪后实现
  • 当前仅支持小程序渠道

• [ ] 多Agent调度：presets.json 中 8 个 Agent 的实际调度串联

P2 — 反馈强化（0430 后持续优化）

• [ ] 时段差异化出价：根据广告历史分时段表现数据，在特定时段提高/降低出价

  • 需要数据：各广告分小时的消耗、转化、ROI
  • 触发场景：运营说"增加早间流量占比"

• [ ] 后验强化：基于调价后实际消耗/ROI变化，迭代调整幅度参数

• [ ] 日内 PID 控制：实时消耗进度 vs 预期节奏，动态微调出价

• [ ] 调整历史与回滚

  • 记录每次出价调整的详细日志（调整前/后出价、时间、策略）
  • 支持一键回滚到上次调整前的状态

• [ ] 账户关停判断（独立流程）

  • 条件：7天内账户有开启的广告、有新建广告，但无消耗
  • 动作：关停该账户

• [ ] 样本不足广告关停：独立规则

  • 首层打开数 < 100 的广告，按独立规则判断是否关停

---

最后更新：2026-04-09