配置 Actions 和 API

本单元目标

学完本单元后，你将能够在 GPTs 编辑器中正确配置 Actions，为 GPT 接入一个真实的外部 API，并理解鉴权方式与请求参数传递的基本原理。

概念讲解

Actions 的本质，是给 GPT 装上一双“手”——让它能主动去抓取你指定服务器上的数据，而不是只靠训练时的记忆。配置 Actions 时，你实际上是在做三件事：告诉 GPT 去哪里（API 的 URL）、怎么证明身份（鉴权方式）、以及能做什么（操作列表）。以天气查询为例，你不需要把天气数据喂给 GPT，只需配置一个 `GET /weather?city=xxx` 的 API，GPT 就会在你提问“北京天气如何”时，自动把“北京”填入参数并发出请求。

这里的关键概念是 OpenAPI Schema——一份描述 API 接口的 JSON 文件。GPT 通过阅读这份文件，才能知道有哪些端点、每个端点接受什么参数。你可以把 Schema 理解为 API 的“使用说明书”，GPT 靠它学会“调用”而不是“猜”。鉴权方面，常见的有无鉴权、API Key（放在 Header 中）和 OAuth 2.0 三种。对于 L3 学习者，你需要重点关注 API Key 的传递方式——通常是在 Schema 的 `securitySchemes` 字段中声明，然后在请求头中携带。

实操演练

1. 打开你的 GPT 编辑器，进入“Configure”选项卡，向下滚动到“Actions”区域，点击“Create new action”。
2. 在“Authentication”下拉框中选择“API Key”，并选择放在“Header”中，然后填入你的密钥变量名（如 `X-API-Key`）。
3. 将你准备好的 OpenAPI Schema（JSON 格式）粘贴到“Schema”输入框中，注意确保 `servers.url` 字段指向你的真实 API 域名。
4. 点击“Test”按钮，在下方的测试面板中选择一个端点，填写测试参数并发送请求，检查返回状态是否为 200。
5. 保存 Action 后，回到对话界面，用自然语言提问触发该 API，例如“查询 id 为 42 的用户信息”，观察 GPT 是否正确解析参数并返回结果。

练习任务

1. 使用一个免费天气 API（如 Open-Meteo，无需鉴权），为其编写一份包含 `GET /forecast` 端点的 OpenAPI Schema，并在 GPT 中成功配置，测试提问“东京今天会下雨吗”并截图返回结果。
2. 在你自己的 Action 中，添加一个需要 API Key 鉴权的端点，验证未携带 Key 时返回 401，携带正确 Key 时返回 200，并记录两种响应差异。