简单的英语目的
承载代理到代理或人到代理的消息,其中包含规范的源和目标身份、相关性、交付可靠性、信任、出处、完整性、意图、上下文引用和确认期望。
何时使用它
当目标参与者在 UAIX 外部执行之前需要可移植的审查数据包时,使用它来启动或继续多代理通信循环。
何时不使用它
请勿将其用作运行时命令队列、托管消息总线、自动同步事件或存储库写入指令。
必填字段
所有代理通信数据包都支持并需要这些规范的信封字段:
uai_version, profile, message_id, source, target, conversation, delivery, trust, body, provenance, integrity, extensions
此配置文件的 body 对象需要:message_type, content, context_refs, requires_acknowledgement, intent_semantics, action_type, execution_constraints, support_boundary。
可靠性领域
使用 conversation.correlation_id、delivery.idempotency_key、delivery.timeout_ms、delivery.retry_count、delivery.fallback_directive 和 delivery.expected_output_schema 使委派可审查,而无需将 UAIX 转换为运行时。
附加字段
不允许有未声明的顶级字段。将附加数据保留在已发布的信封对象内,并在架构需要的地方使用空数组或空对象。
验证期望
- 模式验证是严格的并且拒绝未声明的字段。
- 所有日期/时间字段均使用 UTC 并带有尾随
Z。 - 格式错误的源或目标身份字段无法通过验证。
- 关联 ID 缺失或格式错误导致验证失败。
- 缺少幂等键或后备指令会导致验证失败。
- 过期的数据包无法验证。
- 有关 UAIX 托管消息传递、自动同步、运行时编排、存储库写入、官方适配器、认证或托管导入验证失败的声明不受支持。
- 包含秘密或类似令牌的字符串的内存提案无法通过验证。
- 冷记忆记录无法直接提升为当前事实。
- 最终报告必须包含完整的证据,而不是空洞的已完成消息。
- 授权、秘密、破坏性行为或边界冲突阻止程序需要人工审查。
信任和出处期望
使用 trust、provenance、integrity 和特定于配置文件的主体证据来保留谁生成了数据包、审查了哪些内容、预期使用哪个架构和验证器以及哪些证据支持该消息。代理运行时执行。 UAIX 记录审查的通信、内存、信任、证据和切换边界。
编辑规则
请勿包含私钥、API 凭据、会话令牌、写入令牌、临时 Beta 指令、本地错误跟踪或私有操作端点。在发布之前进行编辑并拒绝包含类似秘密字符串的内存建议。
支持边界
UAIX 不提供自动同步、托管消息传递、运行时编排、官方适配器、存储库写入执行、证书颁发机构或托管导入机制。 Carcinus.org 是一个单独的运行时/协调器示例,可能会消耗 UAIX 记录。 UAIX.org 不实现 Carcinus 运行时行为,也不执行 Carcinus 工作流。
相关 UAIX 记录
- 模式
- 注册表
- 示例
- 验证器
- uai.agent.ack.v1, uai.agent.task-status.v1, uai.agent.blocker.v1, uai.agent.handoff.v1
有效的 JSON 夹具示例
{
"uai_version": "1.0",
"profile": "uai.agent.message.v1",
"message_id": "msg_uaix_agent_message_0001",
"source": {
"type": "agent",
"id": "agt_uaix.publisher",
"label": "UAIX Publication Agent",
"uri": "/",
"role": "standard-publisher",
"project": "uaix.org",
"implementation": "uaix-core"
},
"target": {
"type": "runtime",
"id": "agt_runtime.consumer",
"label": "Runtime Implementer",
"uri": "https://example.invalid/runtime",
"role": "runtime-implementer",
"project": "example-runtime",
"implementation": "external-runtime"
},
"conversation": {
"conversation_id": "conv_20260531_agent_standard",
"turn_id": "turn_001",
"parent_message_id": "none",
"correlation_id": "corr_20260531_agent_standard",
"traceparent": "00-11111111111111111111111111111111-0000000000000001-01",
"sequence": 1
},
"delivery": {
"mode": "async",
"priority": "interactive",
"expires_at": "2030-12-31T23:59:00Z",
"reply_requested": true,
"ack_required": true,
"task_ref": "task_uaix_agent_standard_001",
"idempotency_key": "idem_20260531_agent_message_0001",
"retry_count": 0,
"sequence": 1,
"lifecycle": "transmitted",
"timeout_ms": 300000,
"fallback_directive": "Return a uai.agent.blocker.v1 record if the target cannot proceed safely.",
"expected_output_schema": {
"profile": "uai.agent.ack.v1"
}
},
"trust": {
"channel": "public-web",
"auth_scheme": "https",
"principal": "https://uaix.org",
"signature_ref": "/.well-known/uaix.json",
"replay_window_id": "rw-uaix-agent-standard-20260531"
},
"body": {
"message_type": "directive",
"content": "验证 this packet against the published UAIX agent communication schema before any runtime acts on it.",
"context_refs": [
"/zh-cn/guides/agent-communication-operating-model/",
"/wp-json/uaix/v1/registry/uai.agent.message.v1"
],
"requires_acknowledgement": true,
"intent_semantics": "delegation",
"action_type": "publishing_action",
"execution_constraints": {
"timeout_ms": 300000,
"fallback_directive": "Return uai.agent.blocker.v1 with blocker_type unsupported_capability when the receiver cannot validate.",
"expected_output_schema": {
"profile": "uai.agent.ack.v1",
"required_body_fields": [
"acknowledged_message_id",
"status"
]
},
"allowed_actions": [
"validate packet",
"return acknowledgement",
"report blocker"
],
"forbidden_actions": [
"execute UAIX-hosted work",
"write repositories",
"expose secrets"
]
},
"support_boundary": "Agent runtimes execute. UAIX records the reviewed communication, memory, trust, evidence, and handoff boundary."
},
"provenance": {
"trace_id": "trace_20260531_agent_standard",
"parent_trace_id": "trace_root_uaix_agent_standard",
"issued_at": "2026-05-31T18:00:00Z",
"log_ref": "urn:uaix:log:agent-standard:20260531:message_0001",
"agent_id": "agt_uaix.publisher",
"model_id": "model.uaix.standard-publication",
"confidence": 1,
"lineage": [
{
"stage": "agent-communication-standard-release",
"actor_id": "agt_uaix.publisher",
"model_id": "model.uaix.standard-publication",
"note": "生成时间 as a safe public fixture for the UAIX Agent Communication Operating Model."
}
]
},
"integrity": {
"version": 1,
"algorithm": "sha256",
"canonicalization": "jcs-compatible-sorted-json",
"checksum": "sha256:fixture-hash-recorded-by-validator"
},
"extensions": [
{
"namespace": "urn:uaix:ext:agent-communication-standard",
"purpose": "Documents UAI-1 agent communication expansion fields without executing runtime work.",
"critical": false
}
]
}[
"1.0",
"uai.agent.message.v1",
"msg_uaix_agent_message_0001",
[
"agent",
"agt_uaix.publisher",
"UAIX Publication Agent",
"/",
null,
"standard-publisher",
"uaix-core",
"uaix.org"
],
[
"runtime",
"agt_runtime.consumer",
"Runtime Implementer",
"https://example.invalid/runtime",
null,
"runtime-implementer",
"external-runtime",
"example-runtime"
],
[
"conv_20260531_agent_standard",
"turn_001",
"none",
"00-11111111111111111111111111111111-0000000000000001-01",
1,
"corr_20260531_agent_standard"
],
[
"async",
"interactive",
"2030-12-31T23:59:00Z",
true,
true,
"task_uaix_agent_standard_001",
"idem_20260531_agent_message_0001",
0,
1,
"transmitted",
300000,
"Return a uai.agent.blocker.v1 record if the target cannot proceed safely.",
{
"profile": "uai.agent.ack.v1"
}
],
[
"public-web",
"https",
"https://uaix.org",
null,
"/.well-known/uaix.json",
"rw-uaix-agent-standard-20260531"
],
[
"directive",
"验证 this packet against the published UAIX agent communication schema before any runtime acts on it.",
[
"/zh-cn/guides/agent-communication-operating-model/",
"/wp-json/uaix/v1/registry/uai.agent.message.v1"
],
true,
"delegation",
"publishing_action",
{
"timeout_ms": 300000,
"fallback_directive": "Return uai.agent.blocker.v1 with blocker_type unsupported_capability when the receiver cannot validate.",
"expected_output_schema": {
"profile": "uai.agent.ack.v1",
"required_body_fields": [
"acknowledged_message_id",
"status"
]
},
"allowed_actions": [
"validate packet",
"return acknowledgement",
"report blocker"
],
"forbidden_actions": [
"execute UAIX-hosted work",
"write repositories",
"expose secrets"
]
},
"Agent runtimes execute. UAIX records the reviewed communication, memory, trust, evidence, and handoff boundary."
],
[
"trace_20260531_agent_standard",
"trace_root_uaix_agent_standard",
"2026-05-31T18:00:00Z",
"urn:uaix:log:agent-standard:20260531:message_0001",
"agt_uaix.publisher",
"model.uaix.standard-publication",
1,
[
[
"agent-communication-standard-release",
"agt_uaix.publisher",
"model.uaix.standard-publication",
"生成时间 as a safe public fixture for the UAIX Agent Communication Operating Model."
]
]
],
[
1,
"sha256",
"jcs-compatible-sorted-json",
"sha256:fixture-hash-recorded-by-validator"
],
[
[
"urn:uaix:ext:agent-communication-standard",
"Documents UAI-1 agent communication expansion fields without executing runtime work.",
false
]
]
]字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。