Skip to content

Feedback from reference implementation: Phase 2 findings #2

@Jasonmilk

Description

@Jasonmilk

内容要点:

  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 的响应格式有 successstatuscompleted/accepted),但 HITL 挂起时返回的是 success: false。建议增加 status: "pending_approval" 作为第三种状态,使 Agent 能精确区分“同步失败”和“等待人类审批中”。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions