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