ActionKey / 聊天调用 · ChatGPT

按需求创建自己的 ChatGPT Plugin

按自己的需求创建私有 Plugin，把操作规则与真实广告工具组合起来，在 ChatGPT 对话中查询资产、确认操作并核对结果。

本页是聊天调用的 ChatGPT 分支

你通过对话发起具体任务，自己的 Plugin 提供工具。若要让 Agent 根据目标编排多个步骤，查看AI Agent 调用；若要开发独立后台和服务，查看自己的系统。这些方式可以共用你封装的接口。

01 / 先选好你自己的需求

你的 Plugin 可以叫“我的广告助手”，也可以使用自己的名称。按日常工作选择只读报表、预算调整或暂停 / 恢复投放，初版只开放需要的接口。

实际调用链

ChatGPT → 你的 Plugin 工具 → ActionKey REST → Facebook 资产

  1. 准备业务范围。写清 Plugin 名称、需求、查询范围、需要的操作和结果格式。
  2. 准备 REST 权限。向尤里改团队开通 ActionKey REST 服务，核对可访问的广告户、主页与操作范围，取得对应服务 Token。
  3. 检查创建权限。在 ChatGPT 网页端确认可用的 Plugin Creator、使用 Plugin 权限，以及自定义 MCP 的工作区权限。
  4. 准备真实工具服务。使用已经获准的兼容 MCP，或由你自己的团队部署工具服务、配置私密凭据与用户认证。只有通用 Bearer Token 时，不能直接假定已具备 ChatGPT 网页连接条件。

Skill 定义操作规则，MCP 工具由你自己的工具服务执行，再请求 ActionKey REST。检查实际工具是否已托管、凭据是否已配置；创建记录或生成代码不能代替一次真实调用验证。

首页流程演示展示这一创建与使用过程，数据为示意。本页提供教程，没有实际创建或验证你的 Plugin。

02 / 创建自己的工作流程，明确工具条件

在 ChatGPT 的 Chat 或 Work 中开始新对话，输入 @，搜索并选择 Plugin Creator。修改下面的需求栏后发送，创建方式见官方 Build plugins 指南 ↗。

按需求创建自己的 Plugin
请根据以下需求创建一个我自己使用的私有 ChatGPT Plugin，包含 Skill 操作规则和实际可调用的 MCP 工具。
名称：【我的广告助手，可自行修改】
需求：【只读报表 / 预算调整 / 暂停或恢复投放，按需选择】
查询范围：【指定广告账户、计划 ID、报表时间范围】
需要的操作：【先只保留所需操作；未选择的写入接口不要开放】
输出格式：【例如表格报表、预算变更方案和执行核对结果】
先读取 https://baiz.ai/docs/mcp-api.json ，按真实 HTTP 方法、REST 路径、参数和返回字段封装所选工具。
API 基础地址是 https://baiz.ai/api/mcp 。说明读取失败或字段不明时先停止，不能猜测接口。
请检查当前创建环境是否支持托管 MCP 工具、服务端私密运行时凭据和用户访问控制。
ChatGPT 用户访问私有广告工具时，使用兼容的 OAuth 2.1 授权码 + PKCE；说明实际服务地址和认证配置，不能只生成规则。
ActionKey REST Token 只通过插件服务端的私密配置提供，例如 ACTIONKEY_TOKEN；服务端请求时添加 Bearer 认证。
不要让我把 Token 发到聊天中；不要把凭证写进源代码、技能文档、工具描述或公开插件包。
如果无法托管工具或尚未配置凭据，先创建 Skill 规则并明确“工具未就绪，不能操作账户”。
初版只开放我选择的接口，先用只读请求实测；不得把生成代码或创建记录当成已连接成功。
预算按平台计划 ID 定位，但实际同步关联广告户预算，可能影响同户其他投放；amount 使用美元 USD。
修改前查关联账户、实际预算字段、币种与影响范围；缺信息时停止，不猜测。
展示方案并等待我确认后执行一次，再回读计划及关联账户实际预算字段。
错误、超时或回读不足时报告未确认，不凭接口 success 宣称完成，不重复修改。

Plugin Creator 帮助你把业务需求整理为可复用规则，并组合当前可用的工具。若同时产出 MCP 服务代码，先检查托管环境、凭据入口与认证是否真的就绪。真实 REST 方法与路径必须来自ActionKey 公开接口说明 ↗；把说明文件附到 Skill，不代表已经连接了广告工具。

如果当前环境缺少托管或凭据能力

先创建可复用的 Skill 规则，明确标注“工具未就绪，不能操作账户”。说明缺少的部署或私密配置条件，补齐后再安装和只读测试。

03 / 部署工具，并分别完成两层认证

  1. 检查所选工具、请求域名与实际运行环境。由你自己的团队或支持该能力的托管平台部署兼容 MCP，取得可供 ChatGPT 访问的服务地址。
  2. 在插件服务端的私密配置 / Secrets中设置 ActionKey REST Token，例如使用名称 ACTIONKEY_TOKEN。只在该私密入口填入凭证原值。
  3. 由插件服务端读取私密配置，向 https://baiz.ai/api/mcp 的所选 REST 路径请求时添加 Authorization: Bearer …。凭证不进入聊天、源代码、工具结果或公开插件包。
  4. 为读取私有广告数据或修改资产的远程 MCP 配置兼容的 OAuth 2.1 授权码 + PKCE 登录。可采用现成身份服务；MCP 服务端校验当前用户、授权范围与目标资产，不能只靠 Skill 决定访问权限。
  5. 在 ChatGPT 网页端打开 Plugins → + → Add custom MCP server，填写你自己的 MCP 地址，选择与该服务一致的 OAuth 认证，完成授权，再选择 Create as a plugin。

接入后，再让 Plugin Creator 将这项已经可用的工具加入自己的业务流程。若环境提供了托管和连接的一体化入口，仍逐项核对实际服务地址、用户认证、私密配置和查询结果。

这里需要的是 ActionKey REST 服务凭证，不能把 Meta 原生 System User Token 或仅用于 Graph 代理的内部中转凭证直接替换进来。凭证路线见凭证与接口参考。

技术详情：两层认证分别负责什么
调用关系由谁管理用途
ChatGPT 用户 → 你的 MCP 工具服务你的身份服务提供兼容的 OAuth 登录；MCP 服务端校验用户与工具权限。确定谁可以调用工具，以及此用户可以操作哪些资产。
你的 Plugin 服务端 → ActionKey REST服务端读取 ACTIONKEY_TOKEN 等私密运行时配置，添加 Bearer 请求头。确定可访问的 Facebook 资产与操作范围。

两者不能互换：ActionKey REST Token 不用作用户登录插件的 OAuth Client Secret。OAuth 入口、元数据、回调和 PKCE 由你的身份 / 工具服务配置，创建 Skill 不会赋予用户额外资产权限。详细要求见官方 MCP 服务端指南 ↗和认证指南 ↗。

可选：已有团队提供的兼容 MCP 时

已有获准使用的 app 可以按其连接说明接入。若团队提供的是经过确认的 ChatGPT Plugin 兼容 MCP 入口，可直接建立该连接：

  1. 打开 Plugins → + → Add custom MCP server，填写自选名称和说明。
  2. 填写团队提供的兼容 MCP 地址，按它的真实认证说明完成配置，再选择 Create as a plugin。
  3. 检查实际发现的工具，安装并在新会话中测试只读查询。

通用 https://baiz.ai/mcp 公开说明使用固定 Bearer。ChatGPT 网页的自定义 MCP 表单支持 OAuth、无认证或二者混合，未提供通用固定 Bearer 输入；不能把 ActionKey Token 填成 OAuth Client Secret，或给私有资产选择无认证。若只有该 Bearer 入口，按本页先部署自己的工具服务。连接步骤见官方自定义 MCP 指南 ↗。

04 / 安装自己的 Plugin

  1. 按创建平台提供的兼容 Plugin 连接流程，完成自己的工具托管、私密凭据配置及用户授权。
  2. 在个人或工作区的 Plugins 中找到自己的 Plugin，检查 Skill 和实际 MCP 工具，按提示安装。
  3. 开始新会话，输入 @，选择“我的广告助手”或你自选的名称，从只读查询开始。

在实际使用的 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】定位并核对关联广告账户。
读取该账户的实际预算字段、当前预算、预算类型、币种和影响范围。
仅整理把日预算设为 30 USD 的方案：action 使用 set，budget_field 使用 limit_daily_amount，amount 为 30。
核对 USD 与账户币种的换算、同步规则，说明可能影响同户其他投放。
缺少关联账户、预算或币种信息时停止，不猜测；联系团队确认查询方式。
先展示定位计划 ID、关联账户、预算字段、调整前后值与影响范围，等待我确认，不执行。

核对定位计划 ID、关联账户、实际预算字段、币种、调整前后值与同户其他投放的影响范围。补齐信息并接受该范围后，再发送：

确认后执行并回读
我确认刚才展示的定位计划 ID、关联广告账户、预算字段、币种、USD 金额与换算规则。
我接受该账户预算调整可能影响同一广告户其他投放的范围。
请使用实际已授权工具执行这一次预算调整，再查询对应计划及关联账户实际预算字段。
报告工具结果及调整前后值；回读不足、失败、超时或结果不一致时说明未确认成功。
不要只凭接口 success 宣称完成，也不要重复修改。
按实际预算核对结果

写入后查询对应计划及关联广告账户实际预算字段。接口 success 不单独作为最终成功依据；仅回读计划、缺少账户实际预算字段或结果不一致时，报告“实际预算尚未确认”，先排查原因。

只需要报表的 Plugin 保持只读；选择状态操作时，也要查清对象、展示影响、确认后执行并回读。更多工作流见AI Agent 调用。

常见问题

我的 Plugin 一定要叫“我的广告助手”吗？

可以自选名称，按自己的查询范围、业务操作和输出习惯设计。示例名称只为方便演示，初版只加入实际需要的工具。

只创建了 Skill，为什么不能操作广告？

Skill 提供规则，实际操作需要已托管的 MCP 工具、服务端私密凭据和有效资产权限。任何条件未就绪，都应明确说明不能操作账户。

Token 填在哪里？

填到自己的工具服务端私密配置，例如 ACTIONKEY_TOKEN。工具服务端读取后请求 ActionKey REST；ChatGPT 用户连接的是你自己服务的 OAuth 登录，两层凭据分别配置。

没有开发或托管环境，可以只发创建指令吗？

可以先建立业务规则，但需要可用的广告工具才能执行。如果当前环境没有兼容 MCP、私密配置或用户认证，先按工具部署步骤补齐，或使用支持固定 Bearer 的客户端接入。

已经有可用的 MCP 入口怎么办？

可以使用可选的直接连接路线。固定 Bearer 与 OAuth 客户端认证不能互换；按该入口真实支持的连接流程完成验证。

旧 GPTs 的迁移提示如何处理？

如果你的账户提示“12 月 11 日”退役，按自己的账户通知安排迁移，不将该日期视为所有账户统一安排。旧 Actions 不会自动迁移，需要重新封装工具、配置凭据并测试，见官方迁移说明 ↗。

费用和投放规则如何适用？

ActionKey 固定服务费 ¥5,000 / 月，不限制请求数。ChatGPT、模型和工具托管费用、Meta 广告消耗另行承担；权限、接口限制、广告审核与账户风控仍然适用。

查看示例ChatGPT 流程演示 使用方式 03开发自己的系统