内容要点: 1. **参数化 payload 的类型安全** CIS §6 的调用请求中 `parameters` 是可选的,但当 intent 声明了 `parameters` JSON Schema 时,实现需要严格校验。建议在 CIS §4.5 中明确:实现 MUST 用声明式 Schema 校验 payload,非法载荷直接拒绝。 2. **错误码标准化** 当前 CIS 定义了 `confirmation_required` 错误,但未规定 HTTP 绑定时的状态码映射。建议在 §6.2 增加推荐映射:`confirmation_required` → HTTP 200(业务层拒绝),参数非法 → HTTP 422(协议层拒绝)。这让不同实现之间行为一致。 3. **HITL 响应的 `status` 字段** 当前 CIS 的响应格式有 `success` 和 `status`(`completed`/`accepted`),但 HITL 挂起时返回的是 `success: false`。建议增加 `status: "pending_approval"` 作为第三种状态,使 Agent 能精确区分“同步失败”和“等待人类审批中”。
内容要点:
参数化 payload 的类型安全
CIS §6 的调用请求中
parameters是可选的,但当 intent 声明了parametersJSON Schema 时,实现需要严格校验。建议在 CIS §4.5 中明确:实现 MUST 用声明式 Schema 校验 payload,非法载荷直接拒绝。错误码标准化
当前 CIS 定义了
confirmation_required错误,但未规定 HTTP 绑定时的状态码映射。建议在 §6.2 增加推荐映射:confirmation_required→ HTTP 200(业务层拒绝),参数非法 → HTTP 422(协议层拒绝)。这让不同实现之间行为一致。HITL 响应的
status字段当前 CIS 的响应格式有
success和status(completed/accepted),但 HITL 挂起时返回的是success: false。建议增加status: "pending_approval"作为第三种状态,使 Agent 能精确区分“同步失败”和“等待人类审批中”。