ActionKey / 接入指南 03
Agent 工作流与验证
ActionKey 是尤里改旗下的 AI 资产授权服务。使用你熟悉的 Agent，把账户查询、预算调整和广告创建编排成可核对的工作流。先验证连接，再确认执行与实际结果。
01 / 选好 Agent 与凭证路线
Agent 负责理解你的目标、选择工具和安排执行步骤。ActionKey 提供资产操作的接入能力；你可以使用 Claude Code、Codex、Gemini CLI，也可以在 Grok 或自研系统中编排业务流程。
- 确定工具运行环境。已有助手可按连接 AI 助手配置；自研投放系统按开发指南选择接口。
- 确定凭证类型。尤里改内部中转
access_token和 Meta System User Token 的域名与授权方式不同，按下表分支接入。 - 确定第一项任务。先查询指定账户和资产，核对成功结果，再安排一次修改。
| 路线 | Agent 连接什么 | 关键准备 |
|---|---|---|
| ActionKey 服务 / 中转 | 开通 ActionKey 凭证后使用 MCP、REST 封装或兼容 Graph 的代理接口。 | MCP / REST 使用服务凭证；Graph 代码使用 facebook-graph.baiz.ai 和 ActionKey 中转 access_token。详见中转路线。 |
| Meta 系统用户 | 代码工具或你封装的 Meta Graph API 工具。 | 在 BM 中通过尤里改授权的 App 生成 Token；广告户和主页均分配给该 System User。详见系统用户路线。 |
Meta 原生 System User Token 不填入 ActionKey MCP / REST 认证头。它继承所属 System User 的资产权限；分配资产时选的是对应系统用户，不能只生成一个 Token 就开始投放。
02 / 让 Agent 能找到正确的工具
工具加载后，先让助手说明可用查询、修改与创建能力。不要根据模型回答猜测权限，按连接的真实工具列表和实际返回结果核对。
| 你使用的环境 | 接入与检查 |
|---|---|
| Claude Code | 合并 .mcp.json 并从设置了凭证的终端启动，用 /mcp 检查。查看完整步骤。 |
| Codex | 添加远程 MCP 或编辑 config.toml，用 /mcp 检查。查看完整步骤。 |
| Gemini CLI | 在 settings.json 配置 httpUrl，用 /mcp list 检查。查看完整步骤。 |
| Grok / 自研 Agent | 通过连接器或应用内工具连接，检查认证与工具白名单。查看 Grok 入口。 |
请列出当前连接的广告查询、预算调整、暂停和创建工具。
说明它们接收哪些资产 ID、返回什么成功或错误状态。
仅检查工具能力，不调用任何修改或创建操作。使用 Meta System User Token 时，让 Agent 从运行环境读取凭证，调用你提供的 Graph API 脚本或工具。根据实际 Graph 版本和权限封装；凭证不写入任务文本，也不输出到聊天。
让模型自行选择工具前，先明确哪条路线提供哪些账户；System User 路线同时验证广告户与主页权限。
03 / 用一次查询验证完整链路
工具已出现后，再查询实际资产。按你选择的路线使用对应指令：
请使用 yuri 的查询工具，列出当前 ActionKey 凭证可访问的 Facebook 广告账户。
分别展示账户名称、ActionKey 内部 ID 和 Facebook 广告账户 ID。
检查实际工具结果中的成功状态与错误；本次只查询，不修改广告。使用已配置的 Meta Graph API 查询工具或代码，
分别读取广告账户【Facebook 广告账户 ID】和主页【Facebook 主页 ID】的基本信息。
确认它们均可由当前 System User Token 访问，检查返回错误。
只查询，不创建或修改任何对象，也不要输出 Token。Agent 应实际调用工具，返回账户和主页的名称、ID 及查询结果。查询成功只证明该查询具备权限；能否创建、发布或修改，还取决于相应 App 权限与资产操作权限。
记录查询时间、数据范围、币种和失败资产。ActionKey 报表中的 errors 可能表示部分账户未返回数据，需逐项说明；Meta Graph 则按实际 error 和对象权限排查。
04 / 从单次操作走到完整工作流
固定四个步骤：读取当前对象 → 展示方案 → 确认后执行 → 查询实际结果。先把一次预算调整跑通，再增加多个账户、批量修改或自动规则。
以下示例使用 ActionKey 计划内部 ID。Meta Graph 路线使用真实 Meta 资产 ID，具体对象与金额单位按资产与字段说明核对。
读取广告计划【计划内部 ID】的账户、预算类型、币种和当前预算。
核对是否使用广告计划预算；如果预算在广告组层级，请先说明。
给出日预算调整到【目标金额与账户币种】的方案，
展示具体对象和调整前后金额，等待我确认。我确认刚才展示的账户、对象、币种和金额。
请执行这一次预算调整，然后重新查询实际预算，
报告工具执行结果以及调整前后值。失败时说明原因，不要重复创建或修改。可以编排成这些工作流
- 投放日报：查询指定账户 → 整理花费和转化 → 标明数据范围和缺失项 → 输出报告。
- 预算调整：读取对象与预算 → 核对币种和预算层级 → 展示变更 → 确认后执行 → 回读验证。
- 创建广告：核对广告户和主页 → 检查素材、受众、文案与落地页 → 展示预算和时间 → 确认后创建 → 查询发布状态。
创建接口返回成功后，广告仍可能处于处理或审核状态。遇到超时或不确定的结果，先查询是否已产生对象，再决定后续动作，避免重复创建。
05 / 定时任务需要哪些条件
需要持续盯盘时，使用具备调度能力的 Agent 运行环境，或由自己的服务器任务调用接口。普通 CLI 会话关闭后，不会继续按时执行。
- 持续在线：运行环境、网络、模型服务和凭证可用，按所选路线维护有效授权。
- 调度已建立：明确执行周期、时区、账户、报表时间范围和停止方法。
- 规则完整：写明观察阈值、允许动作、预算上限与失败处理。先查询并通知，验证后再授权自动修改。
- 结果可核对：保留每次工具调用结果和执行时间；发生权限错误、部分失败或实际修改时，通过配置的入口通知。
为指定广告账户建立每 30 分钟执行一次的只读巡检，时区为 Asia/Shanghai。
查询约定时间范围的花费、转化和 CPA，注明数据缺失。
达到我提供的阈值时发送提醒和暂停建议，暂不修改广告。
任务建立后说明下一次执行时间、通知入口、执行记录位置和停止方法。
运行环境不支持调度时，请说明需要配置的任务系统，不要声称已建立。凭证提供操作权限，Agent 或任务系统负责调度。核对至少一次实际执行记录，再启用自动调整；仅在聊天中写出“每 30 分钟”不会自动建立定时任务。
常见问题
我必须使用某一种 Agent 吗？
不需要。选择已在使用的 Claude Code、Codex、Gemini CLI、支持相应连接器的 Grok，或自行开发工具运行环境。按助手接入指南完成连接，再执行本页工作流。
System User Token 能看广告户，但不能发广告？
同时检查投放主页是否分配给生成 Token 的同一个 System User，以及 App、Token 权限和资产操作权限。广告户与主页都授权后，再按具体错误定位，见系统用户指南。
已有投放代码可以交给 Agent 使用吗？
可以将既有查询和修改函数封装为工具。使用 ActionKey 中转 access_token 时，代码请求域名需要改为 facebook-graph.baiz.ai；System User Token 按 Meta Graph 路线调用。详见两种凭证路线。
ActionKey 怎么收费？
固定服务费 ¥5,000 / 月，不限制请求数。广告消耗、模型服务、Agent 及任务运行环境费用另行承担；Meta 和模型服务自身的接口限制仍适用。
操作还受 Facebook 审核与风控吗？
是。两种接入路线都受 Facebook 的权限、广告审核与账户风控约束，代理不会清除已有资产关联。