当前公开的是 C2AI2XExecuteInput 的参考结构，目的是帮助你理解对象语义与携带方式，而不是把某个字段形态当成“已开放能力”的承诺。

提示怎么用这页

• 你在实现 structured_input 或协议层对象携带时，用它对齐语义。
• 具体请求字段与响应结构以 OpenAPI 与 API Reference 为准。

推荐阅读

先建立一张对象地图

Demand

用户真正提出的需求，以及它的上下文。

Envelope

让一次请求可追踪、可幂等、可定位。

AuthorizationGrant

描述授权范围与自动化策略。

ProtocolReference

把执行结果重新关联回协议对象。

可以先把它们理解为四个问题：需求是什么、请求如何追踪、授权能做什么、结果如何回到原始协议上下文。

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 最小必填

目标入口只计划强制要求：

• domain
• demand

而 demand 内又至少需要：

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

推荐阅读

继续阅读

API Reference

字段与响应结构对照（OpenAPI 优先）。

首次请求

跑通一条最小请求，建立集成骨架。

Examples

参考 payload shape（示例，不等于可调用端点）。

Handoff 与责任交割

把目标、授权、证据与回执组织成可行动交接包。

一致性要求

发布前自检：标准层与入口层口径一致。