配置工具与请求

客户操作指南

从业务服务官方 API 和账号允许的任务开始。范围狭窄、说明清楚的工具，比接受任意 URL 与方法的通用工具更容易验证。

定义请求#

使用稳定名称，说明用途、限制和是否修改数据，选择文档规定的 HTTP 方法与端点。仅为操作允许变化的路径部分设置占位符。固定主机和账号区域应保存在连接中。

定义与映射输入#

输入模式应说明字段、类型、必需状态和有效值。下方是虚构记录查询示例。

将参数映射到规定的路径、查询或请求正文。验证缺失必需字段及额外参数会明确失败。认证保存在服务连接中，不写入提示词、示例或硬编码工具请求头。

json

{
  "type": "object",
  "properties": {
    "record_id": {
      "type": "string",
      "description": "The verified identifier of the record to read"
    }
  },
  "required": ["record_id"],
  "additionalProperties": false
}

整理返回结果#

响应映射可只返回任务所需字段。将转换结果与原测试结果核对，保留记录 ID、分页和必要错误信息，以判断完整性。

检查运行设置#

按实际需要设置超时、缓存和重试。缓存读取不能证明刚才的写入完成。非幂等写入重试可能重复创建，应依据接口保证选择策略。

测试实际路径#

检查有效与无效输入、空结果、权限拒绝及一次有界成功调用。测试诊断可能含私人请求信息，仅通过批准后台查看，分享前脱敏。继续阅读测试指南。