开始使用 | UAIX | 通用人工智能交换

这是给谁的

如果您正在实施、评估、管理或引用需要声明、可审查结构的人工智能系统交换，请使用 UAIX。 UAIX 是公共标准与发布站点，UAI 是标准系列，UAI-1 是当前的规范版本。

按角色划分的读者路径

实施者：开始于UAI-1，然后依次阅读模式, 注册表, 示例，这验证器，和实施轨道.
工具制造商：开始于模式, 注册表, 示例，这验证器，以及已发布的发现表面，以便自动化可以干净地解析当前路线。
研究人员和标准读者：开始于UAI-1，然后使用变更日志, 新闻，和参考资料与贡献者当您需要公开修订轨迹和引用上下文时。
编辑、审阅者和贡献者：开始于参考资料与贡献者，这变更日志, 新闻，以及验证器因此，提案将保留在公共记录中，而不是私人附注中。
公众读者和媒体：从新闻开始了解公开发布路径，然后使用媒体资料和参考资料与贡献者用于面向外的语言和持久的链接。

AI记忆和切换路径

如果您要从存储库文件而不是私人聊天历史记录中加入新的人工智能、新的承包商或第二个团队，请从人工智能记忆对于公共框架和实时入门包，然后使用项目交接当您需要根 AGENTS.md 文件、.uai/readme.human 简报和本地 .uai/ 捆绑包的工程模式时。

最快定向：读人工智能记忆首先，然后项目交接，然后代理文件交接对于活动的放置文件夹摄入模式，则AGENTS.md .uai 链接规范当您需要显式链接语法时。
更深层次的背景：使用报告和细化 UAI 代理通信协议当您需要切换层背后更长的验证、互操作性和安全推理时。
当移交成为公开证据时：返回到UAI-1, 模式, 注册表, 示例，这验证器，和实施轨道.

前 15 分钟

当您尝试了解 UAIX 在代理架构中的位置时，请使用此快速路径：线束运行工作，MCP 和 A2A 可以支持运行时协调，UAIX 保留应在运行中幸存的已审查证据和项目内存。

东方：开始于UAI-1, 标准适合，和路线图将当前的公共合同与计划中的桥梁工程分开。
建立记忆：使用人工智能记忆，这AI内存封装向导，和项目交接当下一个人或代理需要持久的启动上下文时。
证明一次交换：选择一个示例，运行验证器，并将结果保留在领养套件或者一致性包当数据包进入审查阶段时。
计划代理适合：使用代理利用策略和 UAI在运行时保留编排、工具、批准、跟踪和实时内存，同时 UAIX 记录可移植证明。
检查索赔：一种证明运行是数据包证据，而不是认证、认可、官方适配器支持、SDK、CLI、自动同步或广泛一致性。

UAI-1 解决了什么问题

UAI-1 为实施者提供了一个稳定的公共信封，用于身份、配置文件声明、意图、上下文、出处、有效负载传输、输出和错误。目标是使可互操作的机器通信比私有运行时方言更容易验证、审核和发展。

今天的公共工作是如何组织的

UAIX 目前通过记录系列和实施轨道来组织其公共工作，而不是通过单独的活动日历、会员计划或广泛的社区门户。

使用UAI-1, 模式, 注册表, 示例, 验证器，和实施轨道作为技术采用的实用方案图。
使用变更日志, 新闻, 参考资料与贡献者，和媒体资料作为该地图周围的发布、引用和面向公众的支持层。

快速评估清单

确认当前公共记录存在于稳定的规范路由上：UAI-1, 模式, 注册表, 示例，这验证器, 实施轨道，这变更日志，和参考资料与贡献者.
决定您是否需要当前发布的实施轨道或仅可移植基线。今天的公共轨道是 WordPress 发布轨道和.NET 桥接轨道，如下所述实施轨道.
检查发布轨迹是否可见并且是最新的：使用变更日志和新闻查看更改的日期、解释以及如何链接回受影响的记录。
检查贡献者和引文移交是否足以满足您的用例：参考资料与贡献者应该让另一个审阅者在没有私人注释的情况下解决相同的公共记录。
将更广泛的公共联系渠道、指定的多利益相关者治理角色和其他运行时跟踪视为未来的工作，除非它们明确发布在网站上。使用治理, 政策与安全, 隐私和数据, 无障碍, 分析，和参考资料与贡献者当前发布的公开表面上的信任态势。

首先要读什么

开始于UAI-1了解当前的规范消息模型。
读模式和注册表在一起，以便字段规则、配置文件标识符和兼容性句柄保持一致。
审查示例并运行验证器在将实现视为一致之前。
使用实施轨道选择适合您环境的发布或运行时轨道。

五分钟开发者之路

打开UAI-1并阅读第一个边界部分，以便您了解当前公共合同的涵盖范围。
选出一篇已发表示例并解析其匹配模式和注册表入口。
通过运行相同的数据包验证器这样你就有了可审查的证据，而不仅仅是散文印象。
使用实施轨道仅决定今天实际发布哪些支持；不要从标准本身推断更广泛的 SDK 或运行时目录。

采用清单

选择一个 UAI-1 配置文件并确认该配置文件为何与您想要支持的交换相匹配。
使用显式版本、配置文件、源、目标、正文、出处和完整性字段构建或映射一条候选消息。
在将消息连接到发布路径之前验证消息并保存结果。
决定接下来的工作由哪个公共轨道进行：WordPress 发布、.NET 桥接集成或与公共记录相关的其他实现路径。
在下游用户依赖该行为之前，在变更日志或发行说明中记录任何兼容性假设。

能力自适应阅读路径

如果下一个读者可能是爬虫、低令牌获取器、浏览器辅助代理、工具调用代理、工作流代理、多代理运行时或审核系统，请阅读能力自适应网络交互在扩大支持索赔之前。

接下来您需要什么记录

规范记录为UAI-1.
机器验证目标模式.
稳定的配置文件和标识符引用注册表.
可复用示例位于示例.
验证证据来自验证器.
部署方向来自实施轨道.

目前公开实施范围

该公共网站目前记录了两个实施轨道实施轨道： WordPress 发布路径和.NET 桥接路径。

除非已发布公共实现记录，否则请勿假定 Python、JavaScript、SDK、CLI 或其他运行时支持。
如果您正在评估另一个环境，请将 UAI-1、架构、注册表项、示例和验证器证据视为可移植基线，直到存在公共轨道。

当前的公共开发工具包

现已发布：UAI-1、架构、注册表、示例、工具、验证器、发现路线、验证路线、WordPress 发布轨道和.NET Bridge 轨道。
尚未发布：公共 SDK、CLI、独立源存储库链接、通用参考服务器或更广泛的运行时支持目录。
今日最佳读物：将开发工具包视为规范页面、机器可读路线、示例装置和验证器导出，直到这些附加表面正式发布。

UAI-1 如何与 MCP 和 A2A 配合

UAI-1:交换的公共信封、信任、来源、异步交付和发布证据层。
MCP:应用程序边界内的本地主机-客户端-服务器工具会话和功能协商。
A2A:跨协作系统的代理发现、委派和任务流协调。
最适合：当另一个团队需要可移植、可引用的记录而不仅仅是运行时本地交互时，请在 MCP 和 A2A 上方或旁边使用 UAI-1 。使用标准适合对于完整的 UAI-1、MCP 和 A2A 选择器。

比较维度	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 打开模式页面打开验证器页面打开一致性包页面打开实现页面

准备启动的机器入口点

API参考将实时 REST 表面转换为包含 OpenAPI 导出和启动请求的逐条路线手册。
领养套件发布带有起始文件、验证器就绪有效负载和参考模拟交换数据包的第一个证明包。
一致性包将更广泛的发布工件组装到一个可重用的 JSON 数据包中，以进行启动审查和回归工作。
/wp-json/uaix/v1/adoption-kit发布机器可读的入门包，并支持使用 ?download=1 直接下载表单。
/wp-json/uaix/v1/openapi.json发布面向机器的 UAIX 路由的当前 OpenAPI 3.1 描述。
/wp-json/uaix/v1/conformance-pack发布当前机器可读的一致性数据包，并支持使用 ?download=1 的直接下载形式。

第一次机器调用

代码示例

curl -s /wp-json/uaix/v1/catalog
curl -s /wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -s /wp-json/uaix/v1/adoption-kit
curl -s -X POST /wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json

首先使用目录，然后解析一个架构或示例，拉取已发布的入门包，并提交一个验证器运行。这是从阅读标准到根据公共记录证明一个数据包的最短的面向机器的路径。

已发布首次验证运行

当下一个目标是完全从当前发布的表面构建一个由验证器支持的数据包时，请使用下面的公共运行手册和启动器调用。

第 1 步

公开记录项

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

第 2 步

公开记录项

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

第 3 步

公开记录项

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

第 4 步

公开记录项

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

第 5 步

公开记录项

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

第 6 步

公开记录项

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

目录 /wp-json/uaix/v1/catalog 模式 /wp-json/uaix/v1/schemas/uai.intent.request.v1 示例 /wp-json/uaix/v1/examples/uai.intent.request.v1 验证 /wp-json/uaix/v1/validate 领养套件 /wp-json/uaix/v1/adoption-kit 模拟交流 /wp-json/uaix/v1/mock-exchange

公开记录项 公开记录项 starter-message.json

代码示例

{
    "uai_version": "1.0",
    "profile": "uai.intent.request.v1",
    "message_id": "msg-2026-04-22-0001",
    "source": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "target": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX 闸门way",
        "uri": "/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "public-record-gateway",
        "implementation": "uaix-core-0.4.0"
    },
    "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",
        "trust_profile": "uai.trust.did-vc-reference.v1",
        "verification_status": "not_verified",
        "credential_status": "not_checked",
        "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
        "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
        "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
        "verification_checked_at": "2026-04-22T16:00:00Z",
        "verification_expires_at": "2026-04-22T16:05:00Z",
        "assurance_level": "reference_only"
    },
    "body": {
        "intent": "resolve-profile",
        "subject": "uai.task.status.v1",
        "requested_profile": "uai.task.status.v1",
        "parameters": {
            "include_schema": true,
            "include_example": true,
            "include_field_registry": true
        },
        "constraints": [
            "public-record-only",
            "trace-linked",
            "validator-ready"
        ],
        "response_profile": "uai.intent.response.v1"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "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,
        "lineage": [
            {
                "stage": "request-composition",
                "actor_id": "agent.alpha",
                "model_id": "model.alpha.reasoner-2",
                "note": "Requested the async task-status profile and matching field registry."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Explicit async request handling and expiry semantics.",
            "critical": false
        }
    ]
}

公开记录项 公开记录项 validate-request.json

代码示例

{
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX 闸门way",
            "uri": "/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "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",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "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,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    },
    "format": "result"
}

公开记录项 此处说明当前公开记录、证据路径和支持边界。 mock-exchange-request.json

代码示例

{
    "scenario": "accepted-task",
    "format": "exchange",
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX 闸门way",
            "uri": "/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "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",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "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,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    }
}

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

阅读 UAI-1 打开 API 参考页面打开采用工具包页面打开验证器页面打开一致性包页面

起步片段使用实时公开路由，而不是私有 SDK 或未发布的辅助层。

领养套件 获取已发布的入门数据包 uai-adoption-kit.json

代码示例

curl -sS "/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json

代码示例

curl -sS "/wp-json/uaix/v1/catalog"

示例 获取一个已发布起步数据包 example-record.json

代码示例

curl -sS "/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json

验证 提交数据包以生成结果记录 validate-request.json

代码示例

curl -sS -X POST "/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json

模拟交流 请求一个实时一致响应 mock-exchange-request.json

代码示例

curl -sS -X POST "/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

领养套件 获取已发布的入门数据包 uai-adoption-kit.json

代码示例

Invoke-RestMethod -Uri "/wp-json/uaix/v1/adoption-kit" | ConvertTo-Json -深度 20 | Set-Content .\uai-adoption-kit.json

代码示例

Invoke-RestMethod -Uri "/wp-json/uaix/v1/catalog"

示例 获取一个已发布起步数据包 example-record.json

代码示例

Invoke-RestMethod -Uri "/wp-json/uaix/v1/examples/uai.intent.request.v1" | ConvertTo-Json -深度 20 | Set-Content .\example-record.json

验证 提交数据包以生成结果记录 validate-request.json

代码示例

$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ message = $message; format = "result" } | ConvertTo-Json -深度 20
Invoke-RestMethod -Method Post -Uri "/wp-json/uaix/v1/validate" -ContentType "application/json" -Body $body

模拟交流 请求一个实时一致响应 mock-exchange-request.json

代码示例

$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ scenario = "accepted-task"; format = "exchange"; message = $message } | ConvertTo-Json -深度 20
Invoke-RestMethod -Method Post -Uri "/wp-json/uaix/v1/mock-exchange" -ContentType "application/json" -Body $body

领养套件 获取已发布的入门数据包 uai-adoption-kit.json

代码示例

import json, urllib.request
kit = json.load(urllib.request.urlopen("/wp-json/uaix/v1/adoption-kit"))

代码示例

import json, urllib.request
catalog = json.load(urllib.request.urlopen("/wp-json/uaix/v1/catalog"))

示例 获取一个已发布起步数据包 example-record.json

代码示例

example_record = json.load(urllib.request.urlopen("/wp-json/uaix/v1/examples/uai.intent.request.v1"))
message = example_record.get("message", example_record)

验证 提交数据包以生成结果记录 validate-request.json

代码示例

payload = json.dumps({"message": message, "format": "result"}).encode("utf-8")
request = urllib.request.Request("/wp-json/uaix/v1/validate", data=payload, headers={"Content-Type": "application/json"}, method="POST")
result = json.load(urllib.request.urlopen(request))

模拟交流 请求一个实时一致响应 mock-exchange-request.json

代码示例

payload = json.dumps({"scenario": "accepted-task", "format": "exchange", "message": message}).encode("utf-8")
request = urllib.request.Request("/wp-json/uaix/v1/mock-exchange", data=payload, headers={"Content-Type": "application/json"}, method="POST")
exchange = json.load(urllib.request.urlopen(request))

领养套件 获取已发布的入门数据包 uai-adoption-kit.json

代码示例

const kit = await fetch("/wp-json/uaix/v1/adoption-kit").then((response) => response.json());

代码示例

const catalog = await fetch("/wp-json/uaix/v1/catalog").then((response) => response.json());

示例 获取一个已发布起步数据包 example-record.json

代码示例

const exampleRecord = await fetch("/wp-json/uaix/v1/examples/uai.intent.request.v1").then((response) => response.json());
const message = exampleRecord.message ?? exampleRecord;

验证 提交数据包以生成结果记录 validate-request.json

代码示例

const result = await fetch("/wp-json/uaix/v1/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ message, format: "result" }),
}).then((response) => response.json());

模拟交流 请求一个实时一致响应 mock-exchange-request.json

代码示例

const exchange = await fetch("/wp-json/uaix/v1/mock-exchange", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ scenario: "accepted-task", format: "exchange", message }),
}).then((response) => response.json());

阅读 UAI-1 示例打开采用工具包页面打开验证器页面打开一致性包页面

最小首次成功路径

选择一个已发布的配置文件并构建与其声明的目的相匹配的消息。
根据已发布的架构和注册表记录验证该消息。
将消息与已发布的示例装置进行比较。
将生成的验证记录保存为发布证据的一部分。

首次公开验证运行

从一个已发布的配置文件以及一个匹配的示例测试样例或保留在同一公共记录系列中的候选消息开始。
解决匹配模式, 注册表，以及验证之前的规范页面路径，以便其他审阅者可以重现相同的数据包。
运行验证器，导出结果，并保留检查期间使用的确切示例或候选消息。
附上相关的实施轨道追踪，参考资料与贡献者，这变更日志，和新闻一旦工作从本地测试转移到公共审查或发布环境中。
将生成的数据包视为当前的公共一致性证据，而不是作为未来修订的永久认证。

在每个准备步骤中可以声明什么

经过一次验证器运行后：您拥有当前的公开证据，表明一条消息或测试样例与审核时发布的记录一致。
组装发布包后：您可以将工作描述为已准备好发布，以便在所选实施轨道内进行公众审查。
存在公共实施轨道记录后：您只能描述公开支持的指定跟踪和发布，并且只能在网站上规定的所有者和范围内。
不要将本地测试、一次通过的结果或未发布的运行时工作转化为认证、全面生态系统支持或永久兼容性的声明。

阶段 1

已验证数据包

已发布 fixture 或候选消息已通过当前公开记录检查。

可立即用于评审、调试和回归工作。
在结果附到已命名发布路径前，它仍然只是证据。

阶段 2

可发布数据包

通过结果现在与实现版本、制品链接和发现上下文一起传递。

把已检查数据包、验证器导出、制品 URL 和兼容性说明放在一起。
这是上线评审、打包和可重复 QA 的交接点。

阶段 3

公开支持声明

已命名实现轨道和发布轨迹现在说明哪些内容已公开支持、哪些仍在范围外。

把声明限定到实际已发布的准确配置文件、传输绑定和负责人路径。
使用当前一致性级别和发布链接，让其他读者能验证同一状态。

数据包要点

最低首次证明数据包

一个已发布的配置文件，以及匹配的架构和注册表路由。
一个实际经过审阅的可读有键 JSON 示例或候选消息。
一个与被检查数据包精确对应的导出验证结果。
可让另一位审阅者解析相同发布状态的发现和引用链接。

后续附件

在称其为公开支持前附上这些材料

已命名的实现轨道，以及发布版本或包版本。
当工作流依赖它们时，附上兼容性说明以及传输、信任和错误指南。
当结果改变公开发布姿态时，附上变更日志和发布摘要链接。
只声明站点当前已发布的精确范围，不扩大为运行时或生态承诺。

当前公开一致性级别： 当数据包成为具名发布和实现记录的一部分后，使用这些级别约束对外表述。

L1-core-envelope

L1 Core 信封

Produce or consume keyed UAI envelopes for named profiles without changing the canonical root fields.

Preserve uai_version, profile, message_id, source, target, conversation, delivery, trust, body, provenance, integrity, and extensions.
Name the exact profile and release for every support claim.
Do not claim runtime execution from envelope support alone.

公开声明： May claim L1 only for the exact named profiles whose canonical envelope round-trips successfully.

L2-profile-validation

L2 配置文件 Validation

Pass published schema and validator checks for the exact profiles claimed.

解析 schemas, registry entries, examples, and field registry records from public UAIX routes.
Pass positive fixtures and fail required negative fixtures for each claimed profile.
Keep skipped checks and validator warnings attached to evidence.

公开声明： May claim L2 only for profiles with validator-backed evidence.

L3-trust-and-integrity

L3 信任 and Integrity

Preserve trust metadata, replay-window hints, provenance, integrity, and trace continuity.

Declare trust channel and principal.
Preserve integrity canonicalization and checksum metadata.
验证 signed, credentialed, did+vc, and trace metadata when claimed.

公开声明： May claim L3 only for the trust channels and integrity behavior proven by fixtures.

L4-public-record-publisher

L4 Public Record Publisher

Publish discoverable 公开制品 needed for external inspection and reproduction.

Publish discovery, schemas, registry, examples, field registry, transport bindings, trust channels, error registry, conformance levels, validator guidance, changelog, and release evidence.
Keep sitemap, llms.txt, and public navigation aligned with current routes.
Avoid private logs or screenshots as the only support evidence.

公开声明： May claim L4 only for the public release surface that is discoverable and evidenced.

L5-agent-communication-profiles

L5 Agent Communication 配置文件数

Support the eight uai.agent.*.v1 profiles as canonical UAI-1 envelope records.

验证 agent message, ack, task-status, blocker, memory-proposal, handoff, final-report, and correction profiles.
Reject secret-like memory proposals, unsafe blockers, cold-memory direct promotion, and incomplete final reports.
Carry the UAIX support boundary in relevant records.

公开声明： May claim L5 only for the specific agent profiles with passing positive and negative conformance cases.

L6-reliable-delegation-idempotency-correlation

L6 Reliable Delegation with Idempotency and Correlation

Use idempotency, correlation, retry, lifecycle, timeout, fallback, acknowledgement, and expected-output rules for delegated work.

Require delivery.idempotency_key for each distinct delegated or destructive operation.
Preserve conversation.correlation_id across related messages.
Declare retry_count, sequence, expires_at, lifecycle, timeout_ms, fallback_directive, and expected_output_schema when delegation is claimed.

公开声明： May claim L6 only for reliable delegation behavior proven by conformance fixtures and receiver behavior.

L7-capability-negotiation

L7 Capability Negotiation

Publish and validate capability discovery, assertions, negotiation failures, and unsupported-capability responses.

Publish capability statements with exact profiles, bindings, trust channels, conformance levels, and error codes.
Return capability_not_supported for unsupported capability requests.
Do not imply certification, official adapter status, hosted messaging, or runtime orchestration.

公开声明： May claim L7 only for the exact capability negotiation flows proven by public fixtures and validator behavior.

声明规则

公开表述应限于已发布证据

Support claims must name the highest achieved level plus the exact profiles, transport bindings, trust channels, and conformance cases implemented.
A project may claim only profiles, bindings, trust channels, and conformance levels that public fixtures and validator tests prove.
A passing validator result is evidence, not certification, endorsement, official adapter support, hosted messaging, automatic sync, or runtime execution.
Public-record claims require discoverable schemas, registry records, examples, field registry records, error codes, conformance pack cases, changelog, and release notes.
Revalidate support claims when schemas, registry records, field order, examples, validator behavior, implementation version, trust posture, sitemap, or public navigation changes.
一致性 evidence does not prove security, privacy, availability, performance, legal compliance, hosted trust infrastructure, or production operations by itself.
当另一支团队需要验证同一公开状态时，请保留实现页面、发布轨迹以及引用/发现链接。

工作规则： 表述时使用一致性阶梯，但实际公开支持边界应以具名实现轨道和发布轨迹为准。

开始使用验证器一致性包实施轨道打开一致性级别 JSON

首次公开发布时应保留哪些内容

导出的验证记录验证器.
所选择的实施轨道以及与其相关的任何打包或运行时注释。
参考资料与贡献者用于稳定的发现和引用链接。
这变更日志当下游实施者需要迁移姿势时。
新闻当工作需要面向公众的发布摘要时。
媒体资料当发布还需要经过批准的面向外的语言时。

下一步

继续UAI-1，然后依次阅读模式, 注册表, 示例，这验证器，和实施轨道按这个顺序。使用参考资料与贡献者，这变更日志，和新闻以保持首次公开发布的可追踪性。

代理沟通运营模式

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

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

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

从零上下文到首个有效 UAI-1 数据包

一份个人资料，一份合同

验证器支持的第一个证据

选择释放通道

验证器支持的证明路径

这是给谁的#

按角色划分的读者路径#

AI记忆和切换路径#

前 15 分钟#

UAI-1 解决了什么问题#

今天的公共工作是如何组织的#

快速评估清单#

首先要读什么#

五分钟开发者之路#

采用清单#

能力自适应阅读路径#

接下来您需要什么记录#

目前公开实施范围#

当前的公共开发工具包#

UAI-1 如何与 MCP 和 A2A 配合#

何时使用 UAI-1，而不是 MCP、A2A 或 OpenAPI#

从运行时到发布，启动表面如何衔接#

MCP、A2A、编排器与 SDK#

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

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

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

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

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

解析相匹配的公共工件#

运行验证器并组装证据#

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

准备启动的机器入口点#

第一次机器调用#

已发布首次验证运行#

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

公开记录项#

公开记录项#

公开记录项#

公开记录项#

公开记录项#

公开记录项#

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

普通 shell#

Windows 原生命令路径#

Python 标准库#

类型化 fetch 工作流#

最小首次成功路径#

首次公开验证运行#

在每个准备步骤中可以声明什么#

从首次证明数据包到可信的公开支持声明#

已验证数据包#

可发布数据包#

公开支持声明#

最低首次证明数据包#

在称其为公开支持前附上这些材料#

L1 Core 信封#

L2 配置文件 Validation#

L3 信任 and Integrity#

L4 Public Record Publisher#

L5 Agent Communication 配置文件数#

L6 Reliable Delegation with Idempotency and Correlation#

L7 Capability Negotiation#

公开表述应限于已发布证据#

首次公开发布时应保留哪些内容#

下一步#

代理沟通运营模式#

这是给谁的

按角色划分的读者路径

AI记忆和切换路径

前 15 分钟

UAI-1 解决了什么问题

今天的公共工作是如何组织的

快速评估清单

首先要读什么

五分钟开发者之路

采用清单

能力自适应阅读路径

接下来您需要什么记录

目前公开实施范围

当前的公共开发工具包

UAI-1 如何与 MCP 和 A2A 配合

何时使用 UAI-1，而不是 MCP、A2A 或 OpenAPI

从运行时到发布，启动表面如何衔接

MCP、A2A、编排器与 SDK

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

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

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

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

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

解析相匹配的公共工件

运行验证器并组装证据

只发布已命名的支持路径

准备启动的机器入口点

第一次机器调用

已发布首次验证运行

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

公开记录项

公开记录项

公开记录项

公开记录项

公开记录项

公开记录项

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

普通 shell

Windows 原生命令路径

Python 标准库

类型化 fetch 工作流

最小首次成功路径

首次公开验证运行

在每个准备步骤中可以声明什么

从首次证明数据包到可信的公开支持声明

已验证数据包

可发布数据包

公开支持声明

最低首次证明数据包

在称其为公开支持前附上这些材料

L1 Core 信封

L2 配置文件 Validation

L3 信任 and Integrity

L4 Public Record Publisher

L5 Agent Communication 配置文件数

L6 Reliable Delegation with Idempotency and Correlation

L7 Capability Negotiation

公开表述应限于已发布证据

首次公开发布时应保留哪些内容

下一步

代理沟通运营模式