开始使用

开始使用

实施者将 UAIX、UAI 和 UAI-1 作为开放互操作性计划进行评估的第一步。

  • 记录 UAIX-GUID-0033
  • 路径 /zh-cn/get-started/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-GUID-0033
页面类型
开始使用
访问
公开且可链接

如何使用此页面

将此页面用作 开始使用 及其标准内容的规范公共参考。

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

这是给谁的

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

按角色划分的读者路径

AI记忆和切换路径

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

前 15 分钟

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

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

UAI-1 解决了什么问题

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

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

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

快速评估清单

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

首先要读什么

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

五分钟开发者之路

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

收养清单

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

能力自适应阅读路径

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

接下来您需要什么记录

目前公开实施范围

该公共网站目前记录了两个实施通道实施: 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 选择器。

标准适合

Choose the right layer

Choose UAI-1 when an exchange must remain portable, reviewable, and independently citable.

Choose the right layer
表面Primary jobWhat it carriesUAIX guidance
UAI-1Portable public exchange and evidence recordIdentity, workflow, trust, provenance, integrityUse for citable cross-system messages
MCPApplication tool and resource sessionsHost-client-server capability useKeep beside UAI-1 for local tool execution
A2AAgent discovery, delegation, and task flowAgent-to-agent runtime coordinationKeep beside UAI-1 for task mechanics
W3C Trace ContextDistributed trace propagationTrace and parent identifiersCarry through conversation.traceparent
RFC 9457HTTP problem detailsTyped API failure responsesUse with the UAIX error registry

Stack map

How the public UAI-1 layers fit

Follow the stack from public contract to machine resolution, runtime use, and release evidence.

Public record

UAI-1 envelope and profiles

Portable identity, delivery, trust, body, provenance, integrity, and extension fields.

Machine catalog

Discovery, schemas, and registry

Stable records let clients resolve exact profiles and field order before exchange.

Runtime companions

MCP, A2A, transport, and tracing

Execution and coordination layers continue to do their own jobs beside the portable record.

公布证据

Validation and conformance

Validator results, examples, implementation evidence, and release history scope support claims.

准备启动的机器入口点

  • 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

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

已发布首次验证运行

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

First message

Run one reproducible UAI-1 proof

Build the first proof from one published profile, schema, example, and deterministic validation result.

Step 1

Read the catalog and select a published profile.

Step 2

Download its schema and example record.

Step 3

Validate a keyed message before transport.

Step 4

Use the Mock Exchange for a deterministic reference response.

Starter packetuai-first-packet.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 Gateway",
        "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
        }
    ]
}

Client examples

Start from the same public catalog

Use the same public catalog from shell, browser, server, or automation clients.

Shelluai-catalog.sh
代码示例
curl -sS /wp-json/uaix/v1/catalog
JavaScriptuai-catalog.mjs
代码示例
const catalog = await fetch('/wp-json/uaix/v1/catalog').then((response) => response.json());
PHPuai-catalog.php
代码示例
$catalog = json_decode(file_get_contents('/wp-json/uaix/v1/catalog'), true, 512, JSON_THROW_ON_ERROR);
Pythonuai_catalog.py
代码示例
catalog = requests.get('/wp-json/uaix/v1/catalog', timeout=10).json()

首次成功率最低

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

首次公开验证运行

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

在每个准备步骤中您可以申请什么

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

Release readiness

From first packet to bounded support claim

Move from contract selection through validation and named release evidence before publishing support.

L1-core-envelope

L1 核心信封

为命名配置文件生成或使用带键的 UAI 信封,不改变规范根字段。

Claim boundary: 仅当具体命名配置文件的规范信封可成功往返时,才能声明达到 L1。

L2-profile-validation

L2 配置文件验证

对所声明的具体配置文件通过已发布模式和验证器检查。

Claim boundary: 仅可对具有验证器证据的配置文件声明 L2。

L3-trust-and-integrity

L3 信任与完整性

保留信任元数据、重放窗口提示、来源、完整性和追踪连续性。

Claim boundary: 仅可对已由夹具证明的信任通道和完整性行为声明 L3。

L4-public-record-publisher

L4 公共记录发布者

发布外部检查和复现所需的可发现公共工件。

Claim boundary: 仅可对可发现且有证据支持的公共发布范围声明 L4。

L5-agent-communication-profiles

L5 智能体通信配置文件

将八个 uai.agent.*.v1 配置文件作为规范 UAI-1 信封记录予以支持。

Claim boundary: 仅可对已通过正向和负向一致性用例的具体智能体配置文件声明 L5。

L6-reliable-delegation-idempotency-correlation

L6 具备幂等性与关联性的可靠委托

对委托工作使用幂等性、关联、重试、生命周期、超时、回退、确认和预期输出规则。

Claim boundary: 仅可对经一致性夹具和接收方行为证明的可靠委托行为声明 L6。

L7-capability-negotiation

L7 能力协商

发布并验证能力发现、能力声明、协商失败和不支持能力响应。

Claim boundary: 仅可对由公共夹具和验证器行为证明的具体能力协商流程声明 L7。

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

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

下一步

继续UAI-1,然后移动通过模式, 注册表, 示例验证器, 和实施按这个顺序。使用参考文献和贡献者变更日志, 和消息以保持首次公开发布的可追踪性。

架构提案

UAI-1 v1.0 仍是当前发布的契约。独立版本的提案涵盖独立交换、能力声明、故障恢复和源记录保留。

这些内容是提议的设计和本地参考示例,并不声称提供托管运行时服务或已验证独立互操作性。

规范解释以英文提案为源文;此界面摘要不代表已审定的规范译文。

阅读英文架构提案 · 机器可读提案目录