
Open AI Agent > Data connectors to view Integrations, MCP servers, and Custom API connectors.
选择连接器类型
“数据连接器”页面提供了三种连接外部服务的方式:将连接器工具添加到 AI Agent 技能
连接服务不会自动将所有可用工具添加到每个 AI Agent。请在技能中选择每个 Agent 可以使用的工具。- 打开您想要配置的 AI Agent。
- 在 基本信息中,找到 技能 并选择 管理。
- 创建一个技能或打开一个现有技能。
- 在 分步说明中,输入 /。
- 展开相关的 集成、 MCP 或 数据连接器 分组,然后选择您想要插入的工具。
- 说明何时使用该工具、要收集哪些信息,以及如何处理其结果。
- 保存技能,在预览中进行测试,并在准备就绪后发布 AI Agent。

Type / in Step-by-Step instructions, then select a tool from the connected Shopify Admin integration.
示例:查询 Shopify 订单
本示例创建了一个技能,可以回答有关客户 Shopify 订单和物流的问题。1. 连接 Shopify Admin
- 前往 AI Agent > 数据连接器。
- 在 集成 标签页中,打开 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 订单、物流、退货或退款状态时使用此技能。请勿将其用于产品推荐、结账问题或修改订单的请求。分步说明
- 向客户询问识别订单所需的信息。
- 输入 / 并从 Integration · Shopify Admin 中插入
find_orders。使用它来查找匹配的订单。 - 如果没有匹配的订单或有多个匹配的订单,请向客户索取更多识别信息。不要猜测他们指的是哪个订单。
- 为匹配的订单插入并使用
get_order。 - 如果客户询问有关物流的问题,插入并使用
get_order_fulfillments。当需要跟踪事件详情时,使用get_fulfillment_events。 - 如果客户询问退货或退款,插入相应的退货或退款工具。
- 仅总结工具返回的信息。如果工具执行失败或请求的信息不可用,请说明无法确认结果,并在合适时转接人工。
3. 发布前测试
在“预览”中,至少测试以下几种情况:- 与客户信息匹配的一个订单
- 没有匹配的订单
- 匹配多个订单
- 履约或物流跟踪详情不可用
- Shopify 工具返回错误
- 客户要求 Agent 修改订单,而只读的 Shopify Admin 集成无法执行此操作
创建自定义 API 连接器
当您希望 AI Agent 技能调用您自己的 HTTPS API 时,请使用自定义 API 连接器。 在 Custom API 选项卡中,选择 New data connector。您还可以按名称搜索现有的自定义 API 连接器,并按状态进行筛选。Open AI Agent > Data connectors, then select New data connector.
名称和描述
为连接器提供一个描述其功能的名称,例如retrieve_order。在描述中,说明何时应使用该连接器以及它返回的内容。
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 删除信息。
Choose the HTTP method and enter the endpoint URL. This incomplete draft has not sent a request.
HTTP 请求头
选择 Add header,然后以键值对的形式输入每个必需的请求头。Select Add header and enter each header as a key-value pair. This example has not been saved or sent.
请求体
对于发送数据的请求,请输入包含您的 API 所需字段的有效 JSON 请求体。Enter valid JSON in Request Body. This fictional order example has not been sent.
测试响应
选择 Test request ,以验证连接器是否返回预期响应。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.

