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

## 已完成 (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