UAI-1 | UAIX | 通用人工智能交换

如何使用本页

使用此页面作为 UAI-1 的主要规范，并在描述所需的消息行为时引用它。

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

解析契约

合约地图

UAI-1 公共契约层如何协同

将 UAI-1 / UAI V1.0 当前启动基线视为一个协调的发布表面：书面合同、机器可读的操作记录、测试样例、验证器支持的支持证据、RFC 9457 问题详细信息、身份和令牌托管规则、启动数据包、暂停数据包和文本优先发现。本地切换包携带通用所需的 .uai 文件以及配置文件所需的文件、内容触发的所需文件和特定于配置的所需文件；这些包文件不是规范的传输信封。

信封

共享消息形状

共同信封使身份、工作流连续性、来源、完整性和 profile 选择在每次公共交换中保持明确。

运行层

传输、信任、错误和声明

支持性的机器可读记录说明消息如何传递、信任如何声明、失败如何命名以及可以声明哪些支持级别。

证据

先验证，再作支持声明

在称任何实现已可发布或公开支持前，请将示例、模式和验证器一起使用。

可靠性

架构优先于模型记忆

UAI-1 不依赖 AI 记住正确答案。模式、注册表记录、来源、完整性字段、示例、验证器输出和发布轨迹承载公共事实。

发布基线必需文件

必需包文件，而不是新 profile

memory-maintenance 是生命周期、验证、Totem/Taboo/Talisman 活动指令锚点和记忆写入安全的必需包策略。

身份

令牌保管必须明确

启动包必须列明身份生命周期、令牌保管、存储确认、恢复边界、文本优先发现、安全港和 UTC 时间戳规则，同时不得发布原始令牌。

失败

问题详情是 HTTP 失败响应的形状

UAIX 平台 HTTP API 失败使用 RFC 9457 风格的 application/problem+json，并包含 UAIX 扩展字段、重试规则、证据建议、安全港链接、跟踪 ID 和关联 ID。

暂停

网络阻断会成为证据

暂停包必须携带阻断分类、有界重试策略、可公开安全披露的观察结果、证据包引用和人工升级路径，而不是无限期重试。

解析契约

模式机器验证的消息结构。字段注册表keyed 与 keyless 字段顺序图。传输绑定默认 keyed、keyless 和异步指引。信任渠道公共信任姿态词汇。错误注册表类型化失败代码及含义。一致性级别公共发布的支持声明阶梯。公开记录项机器路由说明和问题详情响应模式。

核心机器路由直接解析运行层

https://uaix.org/wp-json/uaix/v1/field-registry
https://uaix.org/wp-json/uaix/v1/transport-bindings
https://uaix.org/wp-json/uaix/v1/trust-channels
https://uaix.org/wp-json/uaix/v1/error-registry
https://uaix.org/wp-json/uaix/v1/conformance-levels
https://uaix.org/wp-json/uaix/v1/openapi.json

这些路由是书面 UAI-1 记录的面向机器配套表面。

本地化版本正在审查

英文 UAI-1 标准和机器可读 JSON 记录仍为权威来源。此本地化页面是阅读辅助，不应视为单独的规范性翻译。

UAI-1 是什么

UAI-1 是通用人工智能版本 1，是 UAIX 发布的 UAI 系列中的当前规范版本。将其视为 AI 到 AI 交换的公共信封、信任声明和证据层：一种可移植记录，可以位于 MCP、A2A、编排和特定于运行时的工具之上，而不会被困在任何一个堆栈中。

为发布读者提供的快速解答

在以下情况下使用它：另一个团队需要一个可引用的、由验证器支持的消息合约，该合约可以超越一个运行时边界。
不要误认为：替代交换周围的每个传输、授权、跟踪、编排或本地工具会话协议。
现已发布：共享信封、六个配置文件、字段注册表、传输绑定、信任通道、错误注册表、一致性级别、示例、验证器指南、API 参考、采用工具包、OpenAPI、一致性包、实施证据清单、具有规范哈希等效性的一致性夹具包、桥接证据包、实施轨道和发布轨迹。
最快的证明路径：阅读此处的边界，通过模式和示例解析一个配置文件，运行验证，然后将结果带入当前的公共实现或发布证据表面。

比较维度	UAI-1	MCP	A2A	公开记录项
主要角色	可移植的公共交换、信任声明、异步交付与发布证据记录。	应用边界内部的主机-客户端-服务器工具会话与能力协商。	跨协作系统的代理发现、委派与任务流协调。	用于入门、文档与客户端生成的路由级 HTTP API 描述。
最适合在以下情况下使用	另一支团队需要可引用的消息契约与由验证器支撑的证据。	单个宿主应用需要本地工具、资源或模型集成。	多个代理需要显式交接、委派与任务状态协调。	你需要一套有文档的 HTTP 表面，其中包括 UAIX 面向机器的 REST 路由。
在记录中承载	身份、工作流连续性、信任姿态、来源、类型化错误与一致性证据。	宿主边界内部的工具、资源、提示与运行时会话能力。	代理能力、任务生命周期、委派状态与代理间协调。	一个 API 的端点、方法、参数、请求体、响应与认证方案。
不试图替代	传输选择、本地编排、单一凭证栈，或运行时工具总线本身。	本地会话边界之外的可移植公共发布记录或由验证器支撑的支持声明。	通用的公共消息信封或长期发布证据记录。	消息级来源、可移植信任姿态，或由验证器驱动的互操作性证据。

典型组合： 当需要运行时协调时使用 MCP 或 A2A；当需要可移植公共记录时使用 UAI-1；当涉及 API 时，用 OpenAPI 描述路由级 HTTP 表面。

阅读 UAI-1 打开 API 参考页面打开验证器页面

运行时层

MCP、A2A、编排器与 SDK

这些层可以处理本地工具使用、委派与执行流，而不必被当作公共发布记录。

可移植公共层

UAI-1 信封、信任、来源与交付

当交换必须越过单一运行时边界时，UAI-1 让它保持可引用、可审查，并随时可被验证器检查。

机器可读工件

模式、注册表、示例与验证器

这些记录把书面契约转化为机器检查、夹具、路由查找与可导出的一致性证据。

发布表面

一致性包、实现轨道与发布轨迹

把经过验证的数据包带入已命名的实现路径与公共发布轨迹，而不是把支持声明留在本地备注里。

配套记录： 传输绑定、信任通道、错误注册表与一致性级别都与消息契约并列存在，从而让交付方式、身份姿态、类型化失败与支持声明保持显式。

1

从工作已经发生的地方开始

代理运行时、工具会话或委派任务流会在其原生环境中启动这次交换。
2

形成一份可移植的 UAI-1 记录

让身份、目标、工作流状态、信任姿态与来源在公共信封中保持显式。
3

解析相匹配的公共工件

使用与目标数据包相匹配的模式、注册表条目、字段顺序、示例与运行层记录。
4

运行验证器并组装证据

导出一致性结果，并把它与实际被审查的工件和数据包一起保留下来。
5

只发布已命名的支持路径

使用实现轨道、一致性包、变更日志与发布轨迹来描述当前支持范围，而不要对栈的其余部分过度宣称。

阅读 UAI-1 打开模式页面打开验证器页面打开一致性包页面打开实现页面

当前版本包含哪些内容

书面合同：这个页面，模式, 注册表，和示例一起定义当前公共 UAI-1 记录。
机器可读操作层：发表传输绑定, 信任渠道，这错误注册表，和一致性级别保持交付、信任状态、失败类型和支持声明语言的明确。
现场秩序治理：公众现场注册表保持可读键控 JSON 和紧凑无键传输与相同声明的源顺序对齐。
验证和发布证据：验证器, 领养套件, 一致性包、实施轨道、变更日志和参考文献将支持声明附加到可审查的公共工件上，而不是单独的散文。

每个公共数据包都明确保留了哪些内容

身份及方向：uai_version、profile、message_id、source 和 target。
工作流程连续性：conversation 和 delivery 保持排序、到期、回复期望、任务引用和跟踪链接显式。
信任背景：trust 声明周围的通道、主体、身份验证方案、凭证引用、签名引用和重播窗口提示，而不强制使用一个凭证堆栈。
商业意义：body 携带配置文件定义的意图、结果、功能、任务状态、错误或一致性负载。
可审计性：provenance、integrity 和 extensions 保留可跟踪性、校验和、沿袭和受控可扩展性。

何时首先选择 UAI-1

当一条消息需要作为可移植公共记录跨团队、系统或审核上下文而不是保留在一个本地运行时时。
当身份、工作流状态、信任状态、出处、键入错误和异步交付规则需要在记录中保持可见而不是留给私有约定时。
当启动审核需要验证器证据、配置文件标识符、现场顺序治理和示例测试样例以保持附加到同一支持声明时。

UAI-1 留在旁边

本地工具调用、资源会话、协调器和任务委派系统可以在 UAI-1 旁边继续处理运行时行为。
传输、安全、签名、凭证和跟踪系统应被视为在信封中声明的伴随层，而不是作为一个硬编码的通用堆栈。
UAI-1 作为公共交换和发布记录层是最强大的，而不是作为周围运行时生态系统的完全替代品。

当前发布的个人资料

uai.intent.request.v1 用于针对已声明主题的显式请求。
uai.intent.response.v1 用于结果、确认和接受的异步切换。
uai.capability.statement.v1 用于公开可审查的功能声明。
uai.error.v1 用于键入的、机器可读的故障记录。
uai.conformance.result.v1 用于导出的验证器证据。
uai.task.status.v1 用于可见的异步进度和完成状态。

当前操作界面

传输绑定：已发表的传输绑定描述默认的键控信封绑定、声明条件无键绑定和接受的异步响应模式。
信任渠道：已发表的信任渠道定义 public-web、private-api、mtls、signed-envelope 和 credentialed 在公共记录中的含义。
错误处理：已发表的错误注册表给出 uai.error.v1 命名的机器可读代码，而不是依赖临时文本。
支持索赔：已发表的一致性级别解释在通过验证并发布发布证据后，实现可以诚实地声明什么。
紧凑传输：公众现场注册表保持有钥匙 JSON 和无钥匙运输顺序一致。

消息生命周期

发现：从公共 UAIX 路由解析目录、配置文件注册表、模式、字段注册表、示例、传输绑定、信任通道、错误注册表和一致性级别。
撰写：首先构建密钥源信封，以便身份、方向、工作流程状态、信任状态、正文含义、出处、完整性和扩展保持可审查。
证实：根据架构和验证器策略检查候选消息，包括跟踪、传递、信任、异步和一致性摘要期望。
包裹：携带验证器结果、测试样例、检查路线 URLs、实施范围、发布轨迹、支持边界和非声明。
发布或拒绝：仅当数据包附加到指定的实现和发布记录时才提出公共支持声明；否则将结果保留为私人 QA 证据。
复查：当公共记录、实现版本、路由状态或信任边界发生变化时，重新运行证明。

威胁和滥用边界

UAI-1 使交换记录显式化；它不会取代身份验证、授权、秘密处理、速率限制、滥用检测、部署审查或事件响应。
信任字段声明周围的信任通道和引用；它们不保证凭证、签名、DID、VC、主机或主体有效，除非接收系统对其进行验证。
一致性证据证明在检查时与公共记录的一致性；它不证明安全性、隐私、法律合规性、模型质量、正常运行时间、认可或认证。
公共自动化应该更喜欢干净的 UAIX 路线、无索引机器记录、显式 POST 护栏以及发布轨迹链接，而不是屏幕截图或私人日志。

实施质量棒

指定支持的确切配置文件、传输绑定、规范化模式和信任通道。
将候选消息、验证结果、规范哈希元数据、夹具引用和检查的工件 URLs 放在一起。
在声明旁边发布已知的限制和未来工作的界限。
在扩大支持语言之前，请验证人工引文页面、机器 JSON 路线、支持的区域覆盖范围、可访问性状态和变更日志条目。

从书面合同到第一个证明包

首先阅读此处的边界部分，以便您知道 UAI-1 正在定义公共记录，而不是它周围的每个运行时实现。
通过以下方式解决一份已发布的个人资料模式, 注册表，这现场注册表，和示例.
通过运行相同的数据包验证器因此，结果成为机器可读的证据，而不是散文印象。
使用API参考, 领养套件，和一致性包当数据包需要进入自动化、启动审查或可重复使用的切换包时。
仅当结果附加到指定的名称后才致电公众支持实施轨道、变更日志，或参考资料与贡献者记录。

该合同当前的启动面

API参考将实时 REST 表面转换为具有 OpenAPI 导出的路线级手册。
领养套件发布当前公共合约的入门文件和首次证明包。
一致性包组装更广泛的机器可读发布包，用于启动审查和可重复的证据工作，包括桥梁证据包。
/wp-json/uaix/v1/catalog是当前公共标准清单的面向机器的入口点。
/wp-json/uaix/v1/validate是用于自动化和发布管道验证的 JSON POST 路径。

UAI-1 如何符合相邻标准

A2A可以管理代理发现、委派和任务流机制； UAI-1 在这些流程中携带便携式公共交换和证据记录。
MCP可以管理应用程序边界内的主机-客户端-服务器工具会话和能力协商；当交换需要离开该边界时，UAI-1 仍然是可移植的、可引用的记录。
W3C 跟踪上下文当分布式跟踪已经存在时，可以在 conversation.traceparent 中移动。
RFC 9457 问题详细信息通知 uai.error.v1 使用的类型化公共错误形状。
W3C 可验证凭证基于 DID 的信任堆栈可以位于 trust.principal、credential_ref 和 signature_ref 后面，而不会成为一个强制通用堆栈。

使用标准适合当您需要更完整的 UAI-1 与 MCP、UAI-1 与 A2A、桥梁证据和紧凑转移决策指南时。

下面的操作表面记录是当前公开发布的一部分，旨在与规范文本一起机械地解决。

传输

已发布绑定

默认: https-json-envelope.v1
绑定数: 2

https-json-envelope.v1: application/vnd.uaix.uai+json
https-json-keyless.v1: application/vnd.uaix.uai-keyless+json

打开传输绑定 JSON

信任

已发布信任通道

public-web: 通过 HTTPS 公开可读的记录，无需事先建立双边信任。
private-api: 范围网络或租户边界上的服务到服务交换。
mtls: 在连接层锚定对等身份的传输认证交换。
signed-envelope: 记录附带消息级签名或独立签名参考。
credentialed: 发送方或执行上下文由机器可验证凭证或类似的签名身份声明支撑。

打开信任通道 JSON

一致性

已发布级别阶梯

L1-core-envelope: L1 核心信封
L2-profile-validation: L2 配置文件验证
L3-trust-and-integrity: L3 信任与完整性
L4-public-record-publisher: L4 公共记录发布者
L5-agent-communication-profiles: L5 智能体通信配置文件
L6-reliable-delegation-idempotency-correlation: L6 具备幂等性与关联性的可靠委托
L7-capability-negotiation: L7 能力协商

打开一致性级别 JSON

错误

已发布消息错误码

invalid_message: 无效消息
unknown_profile: 个人资料未知
capability_not_supported: 不支持的能力
auth_required: 需要身份验证
insufficient_trust: 信任不足
task_not_found: 未找到任务

打开错误注册表 JSON

当前合同要求什么

每条消息都必须声明已发布的配置文件并与匹配的架构保持兼容。
每个公共交换都必须记录身份、工作流程状态、信任状态和可审计性，而不是将其留给私人会议。
紧凑型无钥匙交通必须与公众可读的钥匙记录保持一致现场注册表.
支持声明应由验证器证据、发行说明、实施记录和适当的一致性级别来支持，而不是仅由散文来支持。

支持-主张边界

UAI-1 不会将一项本地测试、一项通过结果或一项未发布的运行时实验转化为公众支持。
目前的公众支持仍应通过指定的实施轨道来解读，并在网站上发布证据，而不是作为对周围代理生态系统的一揽子承诺。
当前的桥梁证据示例是映射示例、未完成的桥梁配置文件、SDK 支持、认证或更换声明。
此页面的存在首先是为了使合同明确，然后将支持语言的范围限制在公共记录可以实际验证的范围内。

交换示例

代码示例

{ "uai_version": "1.0", "profile": "uai.intent.request.v1", "message_id": "msg-2026-04-22-0001", "source": { "type": "agent", "id": "agent.alpha", "uri": "https://agents.alpha.example/runtime" }, "target": { "type": "service", "id": "uaix.gateway", "uri": "/wp-json/uaix/v1/discovery" }, "conversation": { "conversation_id": "conv-2026-04-22-uaix-001", "turn_id": "turn-001", "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01", "sequence": 1 }, "delivery": { "mode": "async", "priority": "interactive", "expires_at": "2026-04-22T16:05:00Z", "reply_requested": true, "ack_required": true }, "trust": { "channel": "credentialed", "auth_scheme": "did+vc", "principal": "did:web:agents.alpha.example", "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json", "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws", "replay_window_id": "rw-2026-04-22-0001" }, "body": { "intent": "resolve-profile", "subject": "uai.task.status.v1", "requested_profile": "uai.task.status.v1", "parameters": { "include_field_registry": true }, "constraints": [ "public-record-only", "validator-ready" ], "response_profile": "uai.intent.response.v1" }, "provenance": { "trace_id": "trace-7f3a2d", "issued_at": "2026-04-22T16:00:00Z", "log_ref": "urn:uaix:log:2026:0001", "agent_id": "agent.alpha", "model_id": "model.alpha.reasoner-2", "confidence": 0.98 }, "integrity": { "version": 2, "algorithm": "sha256", "canonicalization": "jcs", "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8" }, "extensions": [] }

传输格式优化版（无键）JSON

代码示例

[
    "1.0",
    "uai.intent.request.v1",
    "msg-2026-04-22-0001",
    [
        "agent",
        "agent.alpha",
        null,
        "https://agents.alpha.example/runtime"
    ],
    [
        "service",
        "uaix.gateway",
        null,
        "/wp-json/uaix/v1/discovery"
    ],
    [
        "conv-2026-04-22-uaix-001",
        "turn-001",
        null,
        "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        1
    ],
    [
        "async",
        "interactive",
        "2026-04-22T16:05:00Z",
        true,
        true
    ],
    [
        "credentialed",
        "did+vc",
        "did:web:agents.alpha.example",
        "https://agents.alpha.example/credentials/uai-interop.json",
        "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "rw-2026-04-22-0001"
    ],
    [
        "resolve-profile",
        "uai.task.status.v1",
        "uai.task.status.v1",
        {
            "include_field_registry": true
        },
        [
            "public-record-only",
            "validator-ready"
        ],
        "uai.intent.response.v1"
    ],
    [
        "trace-7f3a2d",
        null,
        "2026-04-22T16:00:00Z",
        "urn:uaix:log:2026:0001",
        "agent.alpha",
        "model.alpha.reasoner-2",
        0.98
    ],
    [
        2,
        "sha256",
        "jcs",
        "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    ],
    []
]

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

变更如何保持公开和可审查

通过反映配置文件、信封、现场顺序、传输、信任、错误或支持声明更改模式, 实地注册表, 注册表, 示例，验证器，以及操作表面记录。
将面临释放的证据带入实施轨道因此支持声明与真实软件相关。
使用参考资料与贡献者和变更日志当其他人需要持久的发现、归因和迁移背景时。

下一步

继续模式要查看机器验证的合同，请使用示例当您需要公共设施时，打开验证器当您需要面向人的证明工作时，请转到API参考或者一致性包当合同需要进入自动化或启动审查时。

代理沟通运营模式

代理运行时执行。 UAIX 记录审查的通信、内存、信任、证据和切换边界。

使用代理沟通运营模式当人类操作员、编码代理、人工智能代理或运行时实施者需要便携式身份、意图、上下文、确认、状态、阻止程序、内存建议、验证证据、更正、最终报告或移交记录时。匹配的机器可读资产通过发布模式, 注册表, 示例，以及验证器.

UAIX 不提供自动同步、托管消息传递、运行时编排、官方适配器、存储库写入执行、证书颁发机构或托管导入机制。
Carcinus.org 是一个单独的运行时/协调器示例，可能会消耗 UAIX 记录。 UAIX.org 不实现 Carcinus 运行时行为，也不执行 Carcinus 工作流。
LocalEndPoint 和其他运行时可能会作为外部消费者使用已发布的 UAIX 记录； UAIX.org 不实现其特定于项目的运行时功能。
持久内存建议与任务执行记录分开。请勿推广临时端点状态、会话令牌、写入令牌、测试版平台指令、本地错误跟踪、私钥或 API 凭据。

UAI-1 公共契约层如何协同

共享消息形状

传输、信任、错误和声明

先验证，再作支持声明

架构优先于模型记忆

必需包文件，而不是新 profile

令牌保管必须明确

问题详情是 HTTP 失败响应的形状

网络阻断会成为证据

验证器支持的证明路径

本地化版本正在审查#

UAI-1 是什么#

为发布读者提供的快速解答#

UAI-1 如何与 MCP、A2A 和 OpenAPI 形成互补#

UAI-1 在当前发布栈中的位置#

MCP、A2A、编排器与 SDK#

UAI-1 信封、信任、来源与交付#

模式、注册表、示例与验证器#

一致性包、实现轨道与发布轨迹#

从工作已经发生的地方开始#

形成一份可移植的 UAI-1 记录#

解析相匹配的公共工件#

运行验证器并组装证据#

只发布已命名的支持路径#

当前版本包含哪些内容#

每个公共数据包都明确保留了哪些内容#

何时首先选择 UAI-1#

UAI-1 留在旁边#

当前发布的个人资料#

当前操作界面#

消息生命周期#

威胁和滥用边界#

实施质量棒#

从书面合同到第一个证明包#

该合同当前的启动面#

UAI-1 如何符合相邻标准#

传输、信任、错误与一致性#

已发布绑定#

已发布信任通道#

已发布级别阶梯#

已发布消息错误码#

当前合同要求什么#

支持-主张边界#

交换示例#

变更如何保持公开和可审查#

下一步#

代理沟通运营模式#