运营工作流

Agent approve_action / reject_action:安全写入工作流

发布:2026 年 9 月 29 日 · AdsCove 产品与工程团队

直接结论

当 Agent 调用会改广告或 Shopify 的工具时,AdsCove 常返回 pending execution(含 execution_id 与 before/after)。你(或你授权的站立同意策略)审阅后,调用 approve_action 执行,或 reject_action 丢弃。概念模型见 审批门控广告变更;本页是 approve / reject 操作步骤。

你会看到什么

  • execution_id — 批准/拒绝要用的 UUID。
  • requested_change / before-after — 将改哪个账户、哪些字段。
  • idempotency_key — 防止重复提交同一写入。
  • 过期窗口(常见约 72 小时)——过期后需重新发起工具调用。

推荐操作顺序

  1. 先读 — list_connections、报表、Shopify 上下文,确认 Agent 盯的是对的账户。
  2. 起草写入 — 创建/更新页面、产品 SEO、暂停广告对象等;工具返回 pending。
  3. 用人话核对 — 改什么、哪个店铺/广告账户、前后差异、是否涉及付费花费。
  4. approve_action — 仅在同意后传入 execution_id(可选 approval_context_token)。
  5. reject_action — 若计划不对、账户错了、或你改主意:拒绝并让 Agent 重拟。
  6. 验证 — 公开 URL / 后台字段 / 广告状态是否符合预期。

站立同意 vs 每次确认

部分运营(例如站立 SEO 全自动发布)会授权 Agent 在约定范围内直接 approve_action。付费花费、OAuth 重连、品牌风险声明仍应停下询问。没有站立授权时,Agent 必须先征得你明确同意再 approve。

常见错误

  • 未读 before/after 就批准。
  • 把付费预算变更当成「和 SEO 页面一样无害」。
  • 重复用过期的 execution_id。
  • 在聊天里粘贴密钥或平台 Token。

FAQ

approve_action 需要什么参数?

至少 execution_id(UUID)。某些流程还会带 approval_context_token。不要编造 ID。

拒绝后还能批准同一条吗?

通常不能。拒绝后让 Agent 重新调用写入工具,生成新的 pending。

可以只在控制台批准吗?

可以。AdsCove Activity 页也可批准/拒绝;Agent 工具与控制台是同一审批记录。

和 dry_run / review 模式有何关系?

dry_run / review 用来先看计划;真正 mutation 仍要 approve_action(或等价控制台批准)。

相关指南