跳到主要内容

C2AI2X 核心对象

当前公开的 platform ingress request body 是 C2AI2XExecuteInput。

它由几组对象组成：

1. Demand​

Demand 是需求本体。

当前最重要的字段：

  • identity.demand_id
  • identity.protocol_version
  • input_context.raw_input
  • input_context.structured_summary

其中：

  • demand_id 是协议侧主标识
  • raw_input 优先映射到平台内部 text
  • 若没有 raw_input，平台回退到 structured_summary

2. Envelope​

Envelope 是消息包络。

常用字段：

  • envelope_id
  • protocol
  • protocol_version
  • trace.trace_id
  • trace.request_id
  • idempotency_key
  • producer
  • actor
  • subject

它主要承载 trace、生产者、主体、消息语义与幂等信息。

3. AuthorizationGrant​

AuthorizationGrant 是协议层授权描述。

当前常用字段：

  • grant_id
  • demand_id
  • status
  • grantor
  • grantee
  • data_scope
  • action_scope
  • automation_policy
  • redaction_policy

说明：

  • 它可以随请求一并上送
  • 但平台仍是实际 auth / entitlement / quota 的正式解释方

4. Attachments​

附件对象当前结构为：

  • attachment_id
  • kind
  • url
  • metadata

5. ProtocolReference​

无论同步还是异步返回，平台都会返回一个 protocol 摘要：

  • standard
  • version
  • demand_id
  • envelope_id
  • grant_id

这个对象用于把平台执行结果重新锚定回协议世界。

6. Phase 1 最小必填​

当前 live route 只强制要求：

  • domain
  • demand

而 demand 内又至少需要：

  • identity.demand_id
  • input_context.raw_input 或 input_context.structured_summary