准备连接和接口定义
本例让运输助手查询货件状态和运输轨迹。请从目标系统管理员取得测试连接和接口定义,只保留需要的两个只读操作。核对地址、方法及参数。密钥或令牌应保存在连接的认证设置中。用 REST API 让 AI 连接业务系统 · 在管理中心管理连接
一份 OpenAPI 定义可提供多个操作。只配置一次请求时,可以用调用 HTTP 请求工具设置方法、地址和参数。为第三方系统授权访问易企办时,请按易企办公共 REST API的认证说明配置调用方。
添加工具并核对解析结果
在目标智能体或 Copilot 的工具设置中选择「添加工具」。若列表提供「调用 REST API」,选择它,指定已有的 HTTP API 或 OAuth 2.0 API 连接,填入经审核的 YAML 或 JSON。可用入口和连接以当前租户为准。
下面的示例描述两个只读操作。测试时,请换成已获授权的测试地址和实际路径。
openapi: 3.1.0
info:
title: 运输查询测试接口
version: 1.0.0
servers:
- url: https://api.example.com
paths:
/shipments/{shipmentId}:
get:
operationId: getShipmentStatus
summary: 按货件编号查询当前状态
parameters:
- name: shipmentId
in: path
required: true
schema: { type: string }
responses:
'200': { description: 返回当前状态 }
/shipments/{shipmentId}/events:
get:
operationId: listShipmentEvents
summary: 按货件编号查询运输轨迹
parameters:
- name: shipmentId
in: path
required: true
schema: { type: string }
responses:
'200': { description: 返回运输事件 }
核对识别出的两个 GET 操作及其必填参数 shipmentId。如果界面支持编辑说明,写清「查当前状态」和「查运输轨迹」各自适用的任务。
核对工具的行为
用同一授权测试编号分别查询当前状态和运输轨迹,核对助手选择的操作、返回的数据和状态码。再分别测试参数缺失、记录不存在和连接权限不足的情况。
智能体可以在发布前测试。Copilot 可在测试应用发布后使用「测试运行」。使用 OAuth 时,用试用账号核对实际使用的授权和可读范围。智能体 · 创建与管理 Copilot
