Skip to main content
API 连接是您的智能体可在对话期间调用的自定义 HTTP 函数——查询订单、创建工单、从您自己的后端获取账户状态。您只需在 连接 → API（/dashboard/api-connections）下定义一次端点；已附加该连接的智能体便可在对话需要时调用它。 有两种创建方式：粘贴可供向导分析的内容，或手动设置连接。

​
快速方式：粘贴并分析

1

点击新建 API 连接

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

点击分析

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

确认高亮显示的字段

推断出的配置会打开，并高亮显示预测的字段以供您检查。调整名称、描述和参数类型，确保智能体了解何时以及如何调用该函数——模型会读取描述。
4

验证并保存

保存时会先对您的端点发起实时测试请求。如果请求失败，连接不会保存——请修复 URL、认证请求头或请求体后重试。成功后，连接将被保存并显示 已验证 徽标。
如果向导无法在您粘贴的内容中找到请求 URL，它会提示您——请包含完整的 http(s) 端点后重试。

​
手动设置

在向导中点击 手动设置 →（或点击 想让 AI 推断此配置？试试向导 → 返回）。手动构建器提供两个编辑器：
  • 可视化——用于设置显示名称、函数名称、请求 URL、方法（POST、GET、PUT、PATCH、DELETE）、自定义 请求头和参数 schema 的表单字段（为智能体可提供的每个参数点击 添加属性）。
  • JSON——以原始 JSON 形式显示相同定义，可直接粘贴或微调工具规范。
测试请求 面板（可选）可让您在保存前发送已配置的请求，并显示状态、延迟和响应预览。验证并保存 始终会运行此测试，并且仅在成功时保存。
为参数提供通俗易懂的描述（“客户电子邮件地址，例如 jane@example.com”）。智能体会在通话过程中实时根据这些描述选择参数。

​
管理您的连接

每个连接行都会显示其验证状态——已验证、未测试或错误——以及函数名称和使用它的智能体。您可以从该行的操作菜单中：
  • 编辑——重新打开配置。
  • 克隆——复制为起点（副本初始状态为未测试）。
  • 修订历史——查看较早版本，并将其中一个恢复到编辑器中。
  • 转移——将连接复制或移动到您所属的其他组织。移动后会从此处移除；使用该连接的智能体可能需要重新配置。
  • 删除——永久删除；使用该连接的智能体将需要重新配置。

​
将其附加到智能体

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

​
后续步骤

通过 API 集成工具

以编程方式创建和管理相同的连接。

连接应用

预构建的 Google、Slack、HubSpot、Salesforce 和 Cal.com 连接。

添加 MCP 服务器

向您的智能体公开整个工具服务器。

集成 API 参考

集成资源中的每个字段。