--- title: "API 连接" description: "将任何 HTTP API 转换为您的智能体可在对话过程中调用的函数：粘贴一条 cURL 命令，向导即可构建工具定义、参数和身份验证。" --- API 连接是您的智能体可在通话过程中调用的自定义 HTTP 函数——查询订单、创建工单，或从您自己的后端获取账户状态。您只需在 **连接 → API**（`/dashboard/api-connections`）下定义一次端点；已关联该连接的智能体便可在通话需要时调用它。有两种创建方式：粘贴可供向导分析的内容，或手动设置连接。 ## 快速方式：粘贴并分析对话框会在向导中打开。将示例 **cURL 命令**、 **OpenAPI/Swagger 规范**、**Postman 导出**、**TypeScript 接口**或 **Zod 架构**粘贴到输入框中。 ThunderPhone 会根据您粘贴的内容推断完整的连接配置——URL、方法、请求头，以及根据找到的查询参数和请求正文生成的参数架构。您粘贴的请求头（包括身份验证请求头）会一并带入端点配置。推断出的配置会打开，并高亮显示猜测的字段供您检查。请调整名称、描述和参数类型，以便智能体了解应在何时以及如何调用该函数——描述内容是模型会读取的信息。保存前会先向您的端点发起实时测试请求。如果请求失败，连接不会被保存——请修正 URL、身份验证请求头或正文后重试。成功后，连接会以 **已验证** 标记保存。如果向导无法在您粘贴的内容中找到请求 URL，会提示您——请提供完整的 `http(s)` 端点后重试。 ## 手动设置在向导中点击 **手动设置 →**（或点击 **希望由 AI 推断？试用向导 →** 返回）。手动构建器包含两个编辑器： - **可视化**——用于设置显示名称、函数名称、请求 **URL**、**方法**（`POST`、`GET`、`PUT`、`PATCH`、`DELETE`）、自定义 **请求头**和参数架构的表单字段（智能体可提供的每个参数都可点击 **添加属性**）。 - **JSON**——以原始 JSON 形式呈现相同定义，可直接粘贴或微调工具规范。 **测试请求**面板（可选）允许您在保存前发起已配置的请求，并显示状态、延迟和响应预览。 **验证并保存**始终会运行此测试，并且仅在成功时保存。请求头值为只写。保存后将被加密，且不会再次显示，无论是在控制台还是 API 中。编辑连接时，已保存的请求头会显示其名称，值的位置以圆点代替，并附有 **已保存** 提示：保持不变即可保留已保存的值，或输入新值以替换它。测试请求和实时通话会使用已保存的值。**克隆**会将已保存的值复制到新连接。请为参数提供通俗易懂的描述（“客户电子邮箱地址，例如 jane@example.com”）。智能体会在通话过程中根据这些描述实时选择参数。 ## 管理您的连接每个连接行都会显示其验证状态——**已验证**、 **未测试**或**错误**——以及函数名称和使用该连接的智能体。您可以通过该行的操作菜单： - **编辑**——重新打开配置。 - **克隆**——将其复制为起点（副本初始状态为未测试）。 - **修订历史**——查看早期版本，并将其中一个恢复到编辑器中。 - **转移**——将连接复制或移动到您所属的其他组织。移动后会从此处移除；使用该连接的智能体可能需要重新配置。 - **删除**——永久删除；使用该连接的智能体将需要重新配置。 ## 将其关联到智能体在构建器的 API 连接部分将该连接添加到智能体（[构建智能体](/zh/guides/build-an-agent)）。列表会显示哪些智能体使用每个连接，因此您可以一目了然地了解某项更改会影响什么。 ## 后续步骤以编程方式创建和管理相同的连接。预构建的 Google、Slack、HubSpot、Salesforce 和 Cal.com 连接。向您的智能体公开整个工具服务器。集成资源中的每个字段。