> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 数据连接器

> 连接外部数据库，实现全自动客户互动。

## 什么是数据连接器？

数据连接器是一种深度嵌入的集成，可将您的外部实时数据与我们连接。

一个很好的开始方式是思考团队成员花费大量时间回答的常见问题，而这些信息目前在我们的平台上尚不可用。

这些问题可以是客户只想获取存储在外部系统中的信息（例如“我的订单送达了吗？”），或者在外部系统中更新信息（例如“重新安排配送”或“处理退款”）。

## 创建数据连接器

首先，导航至 **AI Agent > 数据连接器**。

您可以在此处设置数据连接器以连接外部数据。您可以点击 **新建数据连接器** 来创建一个。您还可以按名称和状态搜索特定的数据连接器。

<Frame caption="Open AI Agent > Data connectors, then select New data connector.">
  <img src="https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-list-annotated.svg?fit=max&auto=format&n=6u8ntRayC38GXyQF&q=85&s=1e69a488687c963b905ed5916ebd9b9c" alt="包含搜索、状态筛选器、现有连接器以及“新建数据连接器”的完整数据连接器页面。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/final-connector-list-annotated.svg" />
</Frame>

## 名称和描述

为您的数据连接器指定一个能明确说明其具体功能的名称（例如“retrieve\_order\_id”）。在描述字段中，告知团队成员何时使用此连接器以及它将获取哪些数据（例如“获取所提供订单 ID 的订单详情”）。

<Frame caption="Describe the connector’s purpose in About before configuring its API request. This draft has not been saved.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-about-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=a57c6777577f87f55494f26d51d28eb2" alt="数据连接器“关于”步骤，其中名称和描述字段已突出显示。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/connector-about-annotated.svg" />
</Frame>

## API 连接

### **API 请求**

接下来，填写请求详情。您需要在此处输入要连接的第三方系统的 HTTPS URL。

您可以通过选择方法来指定该请求采用的数据连接器操作：

* **GET** - 从第三方系统读取并存储信息。
* **POST** - 在第三方系统中创建或添加信息。
* **PUT** - 更新第三方系统中的信息。
* **DELETE** - 删除第三方系统中的信息。
* **PATCH** - 更新第三方系统中的信息。

<Frame caption="Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/connector-api-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=5effb08c414cdb9ecc3bce86ed58e377" alt="数据连接器 API 连接步骤，其中 HTTP 方法和 URL 已突出显示。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/connector-api-annotated.svg" />
</Frame>

### **HTTP 请求头**

您可以点击 **添加请求头** ，然后在 HTTP Headers 下添加 **键值对** ，以为该请求添加任何附加参数：

<Frame caption="Select Add header and enter each header as a key-value pair. This example has not been saved or sent.">
  <img src="https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-headers-annotated.svg?fit=max&auto=format&n=6u8ntRayC38GXyQF&q=85&s=f23c6cb0a8f850aa38a904ed0d1900cf" alt="显示 Content-Type 和 Accept 请求头的完整 API 连接表单。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/final-connector-headers-annotated.svg" />
</Frame>

### **请求体**

如果您发起的是 POST 或 PUT 请求，您可以提供请求体以包含要在请求中发送的任何数据：

<Frame caption="Enter valid JSON in Request Body. This fictional order example has not been sent.">
  <img src="https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-body-annotated.svg?fit=max&auto=format&n=6u8ntRayC38GXyQF&q=85&s=5099ae99db2d135e6253c53ecefb9937" alt="滚动到 POST JSON 请求体的完整数据连接器页面。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/final-connector-body-annotated.svg" />
</Frame>

### 测试响应

接下来，您需要测试此数据连接器的响应，以确保它从要连接的外部系统中获取到了正确的数据。

<Warning>
  **重要提示：** 测试此请求会与 API 建立连接，因此会实际执行您创建的数据连接器。例如，如果您设置它从 API 中 DELETE 数据，该信息将会被删除。建议先使用 GET 请求进行测试，以确保您仅读取信息而不会对其进行修改。
</Warning>

点击 **测试请求** 检查数据连接器是否配置正确。

<Frame caption="Select Test Request to run the configured API call. No request has been run in this example.">
  <img src="https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-test-entry-annotated.svg?fit=max&auto=format&n=6u8ntRayC38GXyQF&q=85&s=087754abdc3b082833f41e0822a3261c" alt="带有“测试请求”和禁用的“启用”按钮的测试响应步骤。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/final-connector-test-entry-annotated.svg" />
</Frame>

### 启用

成功测试数据连接器后，您就可以将其启用了。

测试成功后，选择右上角的 **启用** 。上述未测试的示例保持此按钮为禁用状态。

### 设为草稿

如果您想弃用不再需要的旧数据连接器，可以将其转为草稿状态。

您可以点击要转为草稿的数据连接器，然后选择“设为草稿”，或者关闭列表中的状态开关。

<Frame caption="Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.">
  <img src="https://mintcdn.com/lchnan/6u8ntRayC38GXyQF/product-assets/english-help-context-2026-09-25/final-connector-status-annotated.svg?fit=max&auto=format&n=6u8ntRayC38GXyQF&q=85&s=36fb2456c31e1e068179cc06e978feed" alt="包含现有已启用连接器状态开关的完整数据连接器列表。" width="3024" height="1656" data-path="product-assets/english-help-context-2026-09-25/final-connector-status-annotated.svg" />
</Frame>

这将会检查该数据连接器是否存在任何依赖项。在将其转为草稿状态之前，您需要检查并解决这些依赖项。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.