规范

标准定位

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-SPEC-0051
  • 路径 /zh-cn/specification/standards-fit/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-SPEC-0051
表面
规范
使用权
公开且可链接

如何使用本页

使用此页面来确定 UAI-1、MCP、A2A 或桥接证据数据包是否拥有该作品,然后在提出声明之前验证紧凑传输和支持边界。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

验证定位

UAI-1字段注册表路线图一致性包

标准定位

UAI-1 作为可携带的公共交换记录

当读者需要理解 UAI-1 与相邻代理、工具、API、身份、追踪、schema 或紧凑传输系统之间的边界时,请使用本页。

边界

记录层,而非替代品

UAI-1 记录可携带的交换证据,而相邻协议保留各自的运行时职责。

传输

只接受可逆的紧凑形式

只有在验证、哈希、签名或支持声明之前能重建有键 JSON 时,紧凑传输才有价值。

证据

先有 fixture,再谈桥接声明

桥接证据示例已是当前公开证据;正式桥接 profile 仍需更完整的验证器预期和发布证据后才应推进。

验证定位

UAI-1当前公共交换契约。字段注册表keyed 与 keyless 字段顺序图。路线图当前桥接证据与紧凑传输边界。一致性包可复用的发布证据数据包。

证明路径

验证器支持的证明路径

将公众阅读顺序与一个证据线索联系起来:配置文件、模式、示例、验证器结果和发布记录。

  1. 1选择消息配置文件。从已发布的 UAI-1 配置文件和与您需要证明的交换匹配的记录系列开始。
  2. 2将其与模式和示例进行比较。在写入或映射候选数据包之前解析架构、注册表项和一个测试样例。
  3. 3运行验证器证据。根据当前公共 UAI-1 记录验证键控、缩小键控或无键 JSON。
  4. 4将结果附加到实施或移交记录中。将导出的结果保存到一致性包、实施轨道、变更日志或项目移交证据中。

目的

标准拟合解释了 UAI-1 与相邻代理、工具、API、身份、跟踪、模式和传输系统相关的位置。这是一个启动阶段的边界页面:对于需要配合的实施者、审阅者和公众读者很有用,而不会将当前的桥梁证据示例变成过于宽泛的支持声明。

核心对比

A2A 协调代理,MCP 连接工具和资源,UAI-1 记录便携式交换。OpenAPI 描述 HTTP API,JSON 模式 验证消息结构,DID/VC 风格的系统可以支持信任证据,Trace Context 承载分布式跟踪链接,CBOR 或 MessagePack 仅当证据路径存在时才能成为未来的紧凑传输绑定。

快速选择器

当问题不是 UAI-1、MCP 或 A2A 在抽象上更好,而是哪一层拥有您面前的工作时,请使用此部分。

需要 当前最佳层 为什么
模型宿主需要向客户端公开工具、资源、提示或应用程序本地上下文。 MCP MCP 拥有主机-客户端-服务器工具和资源会话。仅当请求或结果必须成为该本地边界之外的可移植、可引用记录时,才使用 UAI-1 。
两个代理需要互相发现、委派工作、流式处理任务状态或协调工作流程。 A2A A2A 拥有对等代理发现和任务协调。当生成的请求、任务状态、功能声明或结果需要持久证据时,请使用 UAI-1。
团队、审计员、公开发布、桥梁或下游实施需要一份可审查的交换记录。 UAI-1 UAI-1拥有消息信封、配置文件声明、信任上下文、来源、验证和发布证据。
运行时集成需要执行和公共证据。 两者都使用 Keep MCP or A2A in charge of runtime behavior, then export the externally reviewable part as UAI-1 evidence through the 验证器, 领养套件, 或者一致性包.

UAI-1 与 MCP

  • MCP 询问:该模型客户端可以在此主机会话中使用哪些工具、资源、提示和上下文?
  • UAI-1 询问:另一个系统可以验证、引用、重播、审查或附加哪些便携式交换记录以发布证据?
  • 桥接规则:MCP 工具调用可以映射到 uai.intent.request.v1,而 MCP 资源或工具结果可以映射到 uai.intent.response.v1。该映射不会将 UAI-1 转换为 MCP 会话生命周期。
  • 在以下情况下一起使用:本地工具结果成为跨团队证据、发布工件、公共测试样例或实施支持声明。

UAI-1 与 A2A

  • A2A 询问:哪个代理可以完成这项工作,任务如何委派,以及工作运行时任务状态如何变化?
  • UAI-1 询问:在运行时对话结束后,哪些请求、功能声明、任务状态记录、响应、错误或一致性结果需要保持可移植性?
  • 桥接规则:A2A 代理卡可以映射到 uai.capability.statement.v1,A2A 任务更新可以映射到 uai.task.status.v1。该映射不会使 UAI-1 成为 A2A 发现、委派或流协议。
  • 在以下情况下一起使用:委托代理工作需要验证器支持的移交记录、审计跟踪、公开启动数据包或实施证据。

决策问题

  1. 主要问题是主机会话内的本地工具/资源访问吗?以 MCP 开头。
  2. 主要问题是对等代理发现、委派还是任务协调?以 A2A 开头。
  3. 记录是否需要跨团队、供应商、发布、审计或公共实施声明进行传输?添加 UAI-1。
  4. 该作品是否需要公开证明包?解决UAI-1、模式、注册表、示例和扩展支持语言之前的验证器输出。

相邻标准图

  • A2A:可以拥有对等代理发现、委派、任务流和协作任务状态。 UAI-1 可以记录可移植请求、结果、任务状态或能力证据,这些证据应在运行时会话之外保持可审查。
  • MCP:可以拥有主机-客户端-服务器工具调用、资源读取、提示和应用程序本地能力协商。当工具结果或请求需要离开该本地边界时,UAI-1 可以记录公共交换。
  • OpenAPI:描述 HTTP 运营和航线合同。 UAIX 为其 REST 表面发布 OpenAPI,而 UAI-1 则描述可以穿过这些路由或在这些路由旁边传输的消息记录。
  • JSON 架构:检查当前 UAI-1 配置文件的结构。它是书面规范的验证伴侣,而不是语义指导或发布规则的替代品。
  • DID/VC、mTLS 和签名信封:可以支持通过 trustcredential_refsignature_ref 和配套传输层声明的信任断言,而无需成为一个强制身份堆栈。
  • 跟踪上下文:当分布式跟踪已经存在时,可以遍历 conversation.traceparent 和相关的来源字段。
  • 问题详情:通知类型化公共失败的样式,而 UAI-1 将特定于配置文件的错误记录和验证器问题代码附加到其自己的注册表中。

代理系统架构路径

当读者询问 UAIX 如何适合生产代理线束时,请使用此路径。安全带运行工作; UAIX 保留运行过程中必须保留的便携式证据和移交记录。

线束层 运行时所有者 UAIX 证据角色
指令、计划、重试和控制流程 代理运行时、工作流引擎或应用程序工具 记录审查的意图、任务状态、结果,并在运行后发布证据。
工具、资源和当地环境 MCP、API、数据库、文件或运行时特定的适配器 当跨越公共、供应商、审计或移交边界时记录可移植请求/结果。
人工批准和护栏 运行时策略、批准队列或安全框架 当稍后必须审查这些事实时,携带经过编辑的批准姿势、信任通道、错误记录和证据指针。
追踪和可观察性 跟踪上下文、OpenTelemetry 兼容工具或运行时跟踪 携带稳定的跟踪标识符和出处引用,而不是整个私有跟踪存储。
持久的项目内存 人工智能记忆和审查后的项目交接 保留当前的约束、决策、所有者、测试、来源权威、接收者简报和下一步行动。

实际规则是:让运行时执行,让 MCP 连接工具,让 A2A 协调代理,让可观测性系统跟踪行为,并让 UAIX 发布另一方可以检查的验证器就绪记录、一致性数据包和项目内存切换。

桥剖面边界

采用套件和一致性包现在包含验证器支持的桥接证据示例。正式的桥配置文件仍应将证据映射到 UAI-1 记录中,而不接管相邻的运行时行为。

  • A2A 代理卡可以映射到 uai.capability.statement.v1 记录,但 A2A 仍然拥有本机发现和任务执行。
  • A2A 任务更新可以映射到 uai.task.status.v1,但 UAI-1 不会成为流任务协议。
  • MCP 工具调用可以映射到 uai.intent.request.v1 并且结果可以映射到 uai.intent.response.v1,但 MCP 仍然拥有会话生命周期和工具调用。
  • OpenAPI 操作引用可以出现在 UAI-1 出处或主体元数据中,但 OpenAPI 仍然描述 HTTP API。
  • DID/VC 信任证据和跟踪上下文链接可以在信封中声明,但 UAI-1 不需要一个全局凭证或跟踪堆栈。

紧凑型转运梯

  1. 键控 JSON:用于审查、文档、验证器输出和支持声明的人类可读源记录。
  2. 缩小键控 JSON:相同的键控记录,没有空格,用于简单传输,其中可读性不太重要;验证器将其视为相同的键控记录。
  3. 无钥匙JSON:使用公共的紧凑数组形式现场注册表在验证之前重建密钥记录;验证器当前接受此模式。
  4. 别名 JSON:计划的工作,直到存在公共别名地图、测试样例、标准化规则和验证器期望。
  5. CBOR 或消息包:研究跟踪或未来的运输工作,直到发布编码/解码奇偶性、路线行为和一致性证据。

标准化规则

当前验证器支持 keyed-jsonminified-keyed-jsonkeyless-json。在模式验证、JCS 规范化、散列、签名、验证器证据、发行说明或公共支持声明之前,每个接受的紧凑形式都必须规范化回完整键控的 JSON。现场订单是一张运输图;重建的键控 JSON 记录是审查和完整性基线。

示例比较

下面的例子故意做得很小。它们显示了可读、缩小和无密钥形式之间的关系,而不将别名或二进制支持呈现为当前的公共行为。

代码示例
{
  "uai_version": "1.0",
  "profile": "uai.intent.request.v1",
  "message_id": "msg-demo-001",
  "body": {
    "intent": "resolve-profile",
    "subject": "uai.task.status.v1"
  }
}
传输格式优化版(无键)JSON
代码示例
[
    "1.0",
    "uai.intent.request.v1",
    "msg-demo-001",
    null,
    null,
    null,
    null,
    null,
    [
        "resolve-profile",
        "uai.task.status.v1"
    ]
]

字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。

代码示例
{"uai_version":"1.0","profile":"uai.intent.request.v1","message_id":"msg-demo-001","body":{"intent":"resolve-profile","subject":"uai.task.status.v1"}}
传输格式优化版(无键)JSON
代码示例
[
    "1.0",
    "uai.intent.request.v1",
    "msg-demo-001",
    null,
    null,
    null,
    null,
    null,
    [
        "resolve-profile",
        "uai.task.status.v1"
    ]
]

字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。

代码示例
["1.0","uai.intent.request.v1","msg-demo-001",null,null,null,null,null,["resolve-profile","uai.task.status.v1"],null,null,[]]
传输格式优化版(无键)JSON
代码示例
[
    "1.0",
    "uai.intent.request.v1",
    "msg-demo-001",
    null,
    null,
    null,
    null,
    null,
    [
        "resolve-profile",
        "uai.task.status.v1"
    ],
    null,
    null,
    []
]

字段顺序遵循有键 JSON 示例、已发布的模式顺序以及公共字段注册表。

当前公众支持边界

  • 当前支持包括键控 JSON、缩小键控 JSON、无键 JSON 规范化、模式、注册表记录、示例、字段注册表、验证器行为、规范哈希等效证据、桥接证据示例、一致性包和实现跟踪。
  • 无密钥传输与公共现场注册表相关联,并且必须保持可逆到密钥 JSON。
  • 别名映射、二进制信封媒体类型、正式桥配置文件、SDK、CLI 和正式认证仍处于计划或研究轨道中,直到公共证据推动它们向前发展。
  • 任何符合标准的语言都不应暗示 UAI-1 取代 A2A、MCP、OpenAPI、JSON 架构、DID/VC 系统、跟踪、签名或传输协议。

在哪里验证当前记录

使用UAI-1对于合同,模式, 注册表, 示例,以及验证器作为证据,API参考一致性包用于面向机器的切换,以及路线图变更日志为未来的边界和释放轨迹。