本例在易企办智能体或 Copilot 中配置只读工单查询。开始前,确认应用中有可用连接,并从外部 API 文档核对请求地址、认证要求和可读取的数据范围。
添加工具并选择连接
打开目标智能体或 Copilot 的「工具」,点击「添加工具」,选择「调用 HTTP 请求」。
选择应用中已有的连接。工具会显示连接类型。需要换用另一种连接类型时,按新的连接重新添加工具并复查配置。
将工具命名为「查询工单状态」。在描述中写明仅在用户需要查询时调用、必须提供工单编号,以及返回结果的用途。选择添加并进入配置。
确认请求使用的身份
HTTP API。按连接的设置调用,通常无需终端用户登录。接口需要认证时,按连接和接口要求配置凭据。
OAuth 2.0 API。智能体通常使用连接的预配置授权。Copilot 提供授权方式时,可选使用配置账户,或在使用时要求用户登录。选择后,用测试用户核对实际授权和可读范围。
工具描述和 AI 输入应只包含业务参数。将凭据保存在连接或受控认证设置中。
配置请求和输入
按 API 文档选择方法和地址。查询工单可以用
GET。完整地址或相对路径取决于连接设置。添加文本类型的「工单编号」输入,在请求对应参数中引用它。可以先用固定值测试。让 AI 动态填写时,说明只接受用户提供的编号,缺少时先询问。
接口要求请求头或请求体时,按服务提供的定义配置。需要后续使用数据时,在完成设置中选择等待响应,再设置是否直接向用户展示结果。
设置输出、保存并测试
将响应数据和 HTTP 状态码配置为输出。保存后先测试一条有权查看的工单,再测试找不到记录、输入缺失和权限不足。Copilot 使用用户登录方式时,另核对首次调用的登录提示。
参阅智能体和管理 Copilot 的工具。下图归纳从业务输入到请求输出的关系。
