跳转到主要内容
数据连接器允许 AI Agent 访问来自外部服务的工具。只需配置一次连接,然后将 Agent 所需的特定工具添加到其技能中即可。 打开 AI Agent > 数据连接器 以查看和管理您的连接。
数据连接器页面显示集成、MCP 和自定义 API 标签页以及可用的集成。

Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.

选择连接器类型

“数据连接器”页面提供了三种连接外部服务的方式: 选择相应的标签页以搜索现有连接或配置新连接。

将连接器工具添加到 AI Agent 技能

连接服务不会自动将所有可用工具添加到每个 AI Agent。请在技能中选择每个 Agent 可以使用的工具。
  1. 打开您想要配置的 AI Agent。
  2. 在 基本信息中,找到 技能 并选择 管理。
  3. 创建一个技能或打开一个现有技能。
  4. 在 分步说明中,输入 /。
  5. 展开相关的 集成、 MCP 或 数据连接器 分组,然后选择您想要插入的工具。
  6. 说明何时使用该工具、要收集哪些信息,以及如何处理其结果。
  7. 保存技能,在预览中进行测试,并在准备就绪后发布 AI Agent。
AI Agent 技能编辑器显示包含 Shopify Admin 工具的斜杠命令菜单。

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.

为每个连接器步骤设定明确的成功路径、空结果路径和失败路径。不要要求 AI Agent 推断工具未返回的信息。
有关触发条件、说明和测试的更多指导,请参阅 AI 技能。

示例:查询 Shopify 订单

本示例创建了一个技能,可以回答有关客户 Shopify 订单和物流的问题。

1. 连接 Shopify Admin

  1. 前往 AI Agent > 数据连接器。
  2. 在 集成 标签页中,打开 Shopify Admin 并完成授权流程。
  3. 确认该集成显示为 已连接。
Shopify Admin 提供只读工具,例如:
  • find_orders:根据客户提供的信息查找订单
  • get_order:检索所选订单
  • get_order_fulfillments:检索物流和履约详情
  • get_fulfillment_events:检索物流跟踪事件
  • get_order_returns 和 get_return:检索退货详情
  • get_order_refunds 和 get_refund:检索退款详情

2. 创建技能

在 AI Agent 的 基本信息中,选择 技能下的 管理 ,然后按照以下配置创建技能。 名称
查询 Shopify 订单
触发条件
当客户询问 Shopify 订单、物流、退货或退款状态时使用此技能。请勿将其用于产品推荐、结账问题或修改订单的请求。
分步说明
  1. 向客户询问识别订单所需的信息。
  2. 输入 / 并从 Integration · Shopify Admin 中插入 find_orders。使用它来查找匹配的订单。
  3. 如果没有匹配的订单或有多个匹配的订单,请向客户索取更多识别信息。不要猜测他们指的是哪个订单。
  4. 为匹配的订单插入并使用 get_order。
  5. 如果客户询问有关物流的问题,插入并使用 get_order_fulfillments。当需要跟踪事件详情时,使用 get_fulfillment_events。
  6. 如果客户询问退货或退款,插入相应的退货或退款工具。
  7. 仅总结工具返回的信息。如果工具执行失败或请求的信息不可用,请说明无法确认结果,并在合适时转接人工。
连接 Shopify Admin 后,上述工具名称将显示在 / 命令菜单中。请从该菜单中选择命令,而不是将其名称作为纯文本输入。

3. 发布前测试

在“预览”中,至少测试以下几种情况:
  • 与客户信息匹配的一个订单
  • 没有匹配的订单
  • 匹配多个订单
  • 履约或物流跟踪详情不可用
  • Shopify 工具返回错误
  • 客户要求 Agent 修改订单,而只读的 Shopify Admin 集成无法执行此操作

创建自定义 API 连接器

当您希望 AI Agent 技能调用您自己的 HTTPS API 时,请使用自定义 API 连接器。 在 Custom API 选项卡中,选择 New data connector。您还可以按名称搜索现有的自定义 API 连接器,并按状态进行筛选。
包含搜索、状态筛选、现有连接器以及 New data connector 的完整数据连接器页面。

Open AI Agent > Data connectors, then select New data connector.

名称和描述

为连接器提供一个描述其功能的名称,例如 retrieve_order。在描述中,说明何时应使用该连接器以及它返回的内容。
高亮显示名称和描述字段的数据连接器 About 步骤。

Describe the connector's purpose in About before configuring its API request. This draft has not been saved.

配置 API 请求

输入 HTTPS 端点并选择请求方法:
  • GET 读取信息。
  • POST 创建信息。
  • PUT 替换或更新信息。
  • PATCH 更新部分资源。
  • DELETE 删除信息。
高亮显示 HTTP 方法和 URL 的数据连接器 API 连接步骤。

Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.

HTTP 请求头

选择 Add header,然后以键值对的形式输入每个必需的请求头。
显示 Content-Type 和 Accept 请求头的完整 API 连接表单。

Select Add header and enter each header as a key-value pair. This example has not been saved or sent.

请求体

对于发送数据的请求,请输入包含您的 API 所需字段的有效 JSON 请求体。
滚动至 POST JSON 请求体的完整数据连接器页面。

Enter valid JSON in Request Body. This fictional order example has not been sent.

测试响应

选择 Test request ,以验证连接器是否返回预期响应。
测试会发送真实的 API 请求。 POST、PUT、PATCH 或 DELETE 请求可能会创建、修改或删除数据。尽可能在安全环境中进行测试,或先从只读的 GET 请求开始。
包含 Test Request 和禁用的 Set live 按钮的测试响应步骤。

Select Test Request to run the configured API call. No request has been run in this example.

上线连接器

测试成功后,选择 Set live。已上线的自定义 API 连接器可以从技能指令中的 / 命令菜单中进行选择。 要停止使用某个自定义 API 连接器,请打开它并选择 Set to draft,或者在连接器列表中关闭其状态。在将其更改为草稿之前,请检查并解决所有列出的依赖项。
包含现有已上线连接器状态开关的完整数据连接器列表。

Use the Status switch in the list to move a live connector to draft. The switches shown here have not been changed.