Connect tools & data

API 连接

将任何 HTTP API 转换为您的智能体可在对话过程中调用的函数：粘贴一条 cURL 命令，向导即可构建工具定义、参数和身份验证。

API 连接是您的智能体可在通话过程中调用的自定义 HTTP 函数——查询订单、创建工单，或从您自己的后端获取账户状态。您只需在 连接 → API（/dashboard/api-connections）下定义一次端点；已关联该连接的智能体便可在通话需要时调用它。

有两种创建方式：粘贴可供向导分析的内容，或手动设置连接。

快速方式：粘贴并分析#

1. 点击新建 API 连接

   对话框会在向导中打开。将示例 cURL 命令、 OpenAPI/Swagger 规范、Postman 导出、TypeScript 接口或 Zod 架构粘贴到输入框中。

2. 点击分析

   ThunderPhone 会根据您粘贴的内容推断完整的连接配置——URL、 方法、请求头，以及根据找到的查询参数和请求正文生成的参数架构。您粘贴的请求头（包括 身份验证请求头）会一并带入端点配置。

3. 确认高亮显示的字段

   推断出的配置会打开，并高亮显示猜测的字段供您检查。请调整名称、描述和参数类型，以便 智能体了解应在何时以及如何调用该函数——描述内容是模型会读取的信息。

4. 验证并保存

   保存前会先向您的端点发起实时测试请求。如果请求失败，连接不会被保存——请修正 URL、身份验证 请求头或正文后重试。成功后，连接会以 已验证 标记保存。

如果向导无法在您粘贴的内容中找到请求 URL，会提示您——请提供完整的 http(s) 端点后重试。

手动设置#

在向导中点击 手动设置 →（或点击 希望由 AI 推断？试用向导 → 返回）。手动构建器包含两个编辑器：

• 可视化——用于设置显示名称、函数名称、请求 URL、方法（POST、GET、PUT、PATCH、DELETE）、自定义 请求头和参数架构的表单字段（智能体可提供的每个 参数都可点击 添加属性）。
• JSON——以原始 JSON 形式呈现相同定义，可直接粘贴或微调 工具规范。

测试请求面板（可选）允许您在保存前发起已配置的请求，并显示状态、延迟和响应预览。 验证并保存始终会运行此测试，并且仅在成功时保存。

管理您的连接#

每个连接行都会显示其验证状态——已验证、 未测试或错误——以及函数名称和使用该连接的智能体。您可以通过该行的操作菜单：

• 编辑——重新打开配置。
• 克隆——将其复制为起点（副本初始状态为 未测试）。
• 修订历史——查看早期版本，并将其中一个恢复到 编辑器中。
• 转移——将连接复制或移动到您所属的其他组织。移动后会从此处移除；使用该连接的智能体可能需要 重新配置。
• 删除——永久删除；使用该连接的智能体将需要 重新配置。

将其关联到智能体#

在构建器的 API 连接部分将该连接添加到智能体 （构建智能体）。列表会显示哪些智能体使用每个连接，因此您可以一目了然地了解某项更改会影响什么。

后续步骤#