ActionKey / 接入指南 04
按需求创建自己的 ChatGPT Plugin
ActionKey 是尤里改旗下的 AI 资产授权服务。按自己的需求创建私有 Plugin,把操作规则与真实广告工具组合起来,用 ChatGPT 查询资产、确认操作并核对结果。
01 / 先选好你自己的需求
你的 Plugin 可以叫“我的广告助手”,也可以使用自己的名称。按日常工作选择只读报表、预算调整或暂停 / 恢复投放,初版只开放需要的接口。
ChatGPT → 你的 Plugin 工具 → ActionKey REST → Facebook 资产
- 准备业务范围。写清 Plugin 名称、需求、查询范围、需要的操作和结果格式。
- 准备 REST 权限。向尤里改团队开通 ActionKey REST 服务,核对可访问的广告户、主页与操作范围,取得对应服务 Token。
- 检查创建环境。ChatGPT 需允许使用 Plugin Creator;实际工具需要托管 MCP、服务端私密运行时凭据及用户访问控制。能力和入口以当前环境与工作区权限为准。
Skill 定义操作规则,MCP 工具由你自己的 Plugin 服务端执行,再请求 ActionKey REST。只生成规则或代码,还需要部署、配置凭据、安装及实际查询验证。
首页流程演示展示这一创建与使用过程,数据为示意。本页提供教程,没有实际创建或验证你的 Plugin。
02 / 创建 Skill 与实际工具
在 ChatGPT 的 Chat 或 Work 中开始新对话,输入 @,搜索并选择 Plugin Creator。修改下面的需求栏后发送,创建方式见官方 Build plugins 指南 ↗。
请根据以下需求创建一个我自己使用的私有 ChatGPT Plugin,包含 Skill 操作规则和实际可调用的 MCP 工具。
名称:【我的广告助手,可自行修改】
需求:【只读报表 / 预算调整 / 暂停或恢复投放,按需选择】
查询范围:【指定广告账户、计划 ID、报表时间范围】
需要的操作:【先只保留所需操作;未选择的写入接口不要开放】
输出格式:【例如表格报表、预算变更方案和执行核对结果】
先读取 https://baiz.ai/docs/mcp-api.json ,按真实 HTTP 方法、REST 路径、参数和返回字段封装所选工具。
API 基础地址是 https://baiz.ai/api/mcp 。说明读取失败或字段不明时先停止,不能猜测接口。
请检查当前创建环境是否支持托管 MCP 工具、服务端私密运行时凭据和用户访问控制。
ActionKey REST Token 只通过插件服务端的私密配置提供,例如 ACTIONKEY_TOKEN;服务端请求时添加 Bearer 认证。
不要让我把 Token 发到聊天中;不要把凭证写进源代码、技能文档、工具描述或公开插件包。
如果无法托管工具或尚未配置凭据,先创建 Skill 规则并明确“工具未就绪,不能操作账户”。
初版只开放我选择的接口,先用只读请求实测;不得把生成代码或创建记录当成已连接成功。
预算按平台计划 ID 定位,但实际同步关联广告户预算,可能影响同户其他投放;amount 使用美元 USD。
修改前查关联账户、实际预算字段、币种与影响范围;缺信息时停止,不猜测。
展示方案并等待我确认后执行一次,再回读计划及关联账户实际预算字段。
错误、超时或回读不足时报告未确认,不凭接口 success 宣称完成,不重复修改。Plugin Creator 应先核对需求与当前环境能力,再按ActionKey 公开接口说明 ↗封装工具。真实 REST 方法与路径必须来自该说明;将你选择的查询或写入功能封装成工具,不能只把说明文件附到 Skill 就声称已经接入。
先创建可复用的 Skill 规则,明确标注“工具未就绪,不能操作账户”。说明缺少的部署或私密配置条件,补齐后再安装和只读测试。
03 / 在自己的服务端配置凭据
- 检查已生成的真实工具、所选接口、请求域名与运行环境;根据创建平台提供的入口部署或托管 MCP 工具。
- 在插件服务端的私密配置 / Secrets中设置 ActionKey REST Token,例如使用名称
ACTIONKEY_TOKEN。只在该私密入口填入凭证原值。 - 由插件服务端读取私密配置,向
https://baiz.ai/api/mcp的所选 REST 路径请求时添加Authorization: Bearer …。凭证不进入聊天、源代码、工具结果或公开插件包。 - 检查自己的 Plugin 用户访问控制,以及工具可操作的资产范围。未配置凭据或没有有效授权时,工具应停止并返回明确错误。
这里需要的是 ActionKey REST 服务凭证,不能把 Meta 原生 System User Token 或仅用于 Graph 代理的内部中转凭证直接替换进来。凭证路线见开发指南。
技术详情:两层认证分别负责什么
| 调用关系 | 由谁管理 | 用途 |
|---|---|---|
| ChatGPT 用户 → 你的 Plugin | 你的创建 / 托管平台提供兼容的连接与用户认证,插件服务端校验访问权限。 | 确定谁可以调用你的工具。 |
| 你的 Plugin 服务端 → ActionKey REST | 服务端读取 ACTIONKEY_TOKEN 等私密运行时配置,添加 Bearer 请求头。 | 确定可访问的 Facebook 资产与操作范围。 |
两者不能互换:ActionKey REST Token 不用作用户登录插件的 OAuth Client Secret。MCP 托管、秘密管理与认证要求见官方 MCP 服务端指南 ↗和认证指南 ↗。
可选:已有团队提供的兼容 MCP 时
已有获准使用的 app 可以按其连接说明接入。若团队提供的是经过确认的 ChatGPT Plugin 兼容 MCP 入口,可直接建立该连接:
- 打开 Plugins → + → Add custom MCP server,填写自选名称和说明。
- 填写团队提供的兼容 MCP 地址,按它的真实认证说明完成配置,再选择 Create as a plugin。
- 检查实际发现的工具,安装并在新会话中测试只读查询。
通用 https://baiz.ai/mcp 公开说明使用固定 Bearer;本教程没有验证其可直接作为 ChatGPT 自定义 MCP 连接。固定 Bearer 不能当作 OAuth Client Secret,也不能选择无认证绕过私有资产授权。连接步骤见官方连接指南 ↗。
04 / 安装自己的 Plugin
- 按创建平台提供的兼容 Plugin 连接流程,完成自己的工具托管、私密凭据配置及用户授权。
- 在个人或工作区的 Plugins 中找到自己的 Plugin,检查 Skill 和实际 MCP 工具,按提示安装。
- 开始新会话,输入 @,选择“我的广告助手”或你自选的名称,从只读查询开始。
在实际使用的 Chat 或 Work 模式中分别验证。创建记录、生成代码、安装成功都不能替代工具调用与真实数据的连接检查。
05 / 用一次只读查询验证
使用「我的广告助手」的实际查询工具,读取我指定范围内已授权的 Facebook 广告账户。
展示实际返回的账户名称和资产 ID,区分 ActionKey 内部 ID 与 Facebook ID。
说明调用结果与错误;本次只查询,不创建、不修改,也不输出完整凭证。
没有可用工具、运行时凭据或有效授权时,说明缺失条件,不编造查询结果。核对实际请求结果、账户与查询范围。接口成功后还要检查返回内容;空列表、字段缺失或授权范围不完整时继续排查,不能编造结果。
预算操作前查询计划关联广告户的实际预算、币种和影响范围。公开的 list_campaigns 说明未承诺固定预算返回字段;缺少预算、币种或关联账户信息时停止、不猜测,联系团队确认可用字段或查询方式。
06 / 需要预算操作时,先确认方案
仅在你选择并开通了预算工具后使用此示例。adjust_budget 通过平台计划 ID 定位,实际同步关联广告账户预算,可能影响同一广告户其他投放。日预算字段为 limit_daily_amount,总预算为 limit_amount,接口 amount 使用美元(USD);30 美元是示意金额。
用【ActionKey 计划内部 ID】定位并核对关联广告账户。
读取该账户的实际预算字段、当前预算、预算类型、币种和影响范围。
仅整理日预算调整方案:budget_field 使用 limit_daily_amount,amount 为 30 USD。
核对 USD 与账户币种的换算、同步规则,说明可能影响同户其他投放。
缺少关联账户、预算或币种信息时停止,不猜测;联系团队确认查询方式。
先展示定位计划 ID、关联账户、预算字段、调整前后值与影响范围,等待我确认,不执行。核对定位计划 ID、关联账户、实际预算字段、币种、调整前后值与同户其他投放的影响范围。补齐信息并接受该范围后,再发送:
我确认刚才展示的定位计划 ID、关联广告账户、预算字段、币种、USD 金额与换算规则。
我接受该账户预算调整可能影响同一广告户其他投放的范围。
请使用实际已授权工具执行这一次预算调整,再查询对应计划及关联账户实际预算字段。
报告工具结果及调整前后值;回读不足、失败、超时或结果不一致时说明未确认成功。
不要只凭接口 success 宣称完成,也不要重复修改。写入后查询对应计划及关联广告账户实际预算字段。接口 success 不单独作为最终成功依据;仅回读计划、缺少账户实际预算字段或结果不一致时,报告“实际预算尚未确认”,先排查原因。
只需要报表的 Plugin 保持只读;选择状态操作时,也要查清对象、展示影响、确认后执行并回读。更多工作流见Agent 工作流与验证。
常见问题
我的 Plugin 一定要叫“我的广告助手”吗?
可以自选名称,按自己的查询范围、业务操作和输出习惯设计。示例名称只为方便演示,初版只加入实际需要的工具。
只创建了 Skill,为什么不能操作广告?
Skill 提供规则,实际操作需要已托管的 MCP 工具、服务端私密凭据和有效资产权限。任何条件未就绪,都应明确说明不能操作账户。
Token 填在哪里?
填到自己的插件服务端私密配置,例如 ACTIONKEY_TOKEN。工具服务端读取后请求 ActionKey REST;不把原值发进聊天,也不保存到代码或公开插件包。
已经有可用的 MCP 入口怎么办?
可以使用可选的直接连接路线。固定 Bearer 与 OAuth 客户端认证不能互换;按该入口真实支持的连接流程完成验证。
旧 GPTs 的迁移提示如何处理?
如果你的账户提示“12 月 11 日”退役,按自己的账户通知安排迁移,不将该日期视为所有账户统一安排。旧 Actions 不会自动迁移,需要重新封装工具、配置凭据并测试,见官方迁移说明 ↗。
费用和投放规则如何适用?
ActionKey 固定服务费 ¥5,000 / 月,不限制请求数。ChatGPT、模型和工具托管费用、Meta 广告消耗另行承担;权限、接口限制、广告审核与账户风控仍然适用。