工具

验证器

根据已发布的配置文件、字段顺序规则和策略检查验证 UAI-1 消息,然后在发布前导出可审核的结果。

  • 记录 UAIX-TOOL-0060
  • 路径 /zh-cn/tools/validator/
  • 用途 规范公共记录

文档状态

公共标准页面 作为当前公共标准记录的一部分发布在 UAIX 上
代码
UAIX-TOOL-0060
页面类型
工具
访问
公开且可链接

如何使用此页面

将此页面用作 验证器 及其标准内容的规范公共参考。

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

验证器检查什么

验证器工作台根据已发布的配置文件架构、字段顺序治理记录以及 UAI-1 的当前操作界面期望检查候选 UAI 消息。

  • 六个已发布消息系列的架构对齐。
  • 注册表支持的配置文件和标识符解析。
  • 通过公共现场登记处进行现场订购和无钥匙运输期望。
  • 跟踪上下文、交付、信任通道、异步任务状态和一致性摘要策略检查超出了纯 JSON 结构。
  • 针对已发布的错误注册表进行类型化故障验证,并针对已发布的传输绑定和一致性级别进行功能声明检查。
  • 当一致性失败或开始出现偏差时,可预测的问题报告。

一致性结果意味着什么

一致性结果是机器可读的证据,表明候选消息已根据当前公共记录进行检查。它适用于审查、发布门、回归检查和审计证据。它本身不能替代发布包或实现支持声明。

通过的结果可以让你做什么,不能让你做什么

  • 支持:声称已审查的消息与验证时发布的公共记录一致。
  • 不支持:超出所附实施记录的认证、合作伙伴批准、永久兼容性或一般运行时支持的声明。
  • 在公众支持之前需要更多:发布包、实施跟踪记录、发布跟踪条目以及您想要提出的声明的相应已发布的一致性级别。

团队在部署之前应如何使用验证器

  1. 加载已发布的示例或粘贴候选人消息。
  2. 确认消息已解析为预期内容注册表简介、相关现场秩序,以及匹配的模式。
  3. 当传输、信任或错误行为很重要时,请使用同一审核数据包携带已发布的传输绑定、信任通道、错误注册表和一致性级别。
  4. 检查生成的结果记录,然后将该一致性记录与实施发布证据一起保存。
  5. 使用结果来决定下一步是否属于实施.

混凝土实时验证器表面

一致性证据如何成为公开发布记录

  • 将导出的一致性结果附加到相关实施或包发布中,而不是将它们保留为私有本地检查。
  • 使用变更日志当架构、配置文件、字段顺序、传输、信任或验证器行为更改影响迁移预期时。
  • 使用消息当通过或失败的版本需要面向公众的摘要时。
  • 使用参考文献和贡献者当版本需要围绕其一致性证据的稳定发现和引用链接时。

验证结果解读

  • 经过:提交的消息与记录的检查时间的公共配置文件、架构、注册表和当前验证器策略相匹配。
  • 警告:该消息在结构上可能是可用的,但存在偏差、证据缺失、信任态势薄弱或审查上下文,这些应在支持语言扩展之前解决。
  • 失败:在更正并重新运行列出的配置文件、模式、字段顺序、信任、跟踪、传递或正文问题之前,不应将消息用作发布证据。
  • 重新运行触发器:当公共记录、验证者行为、实现版本、路由状态或支持声明发生变化时重新运行。

已发布的操作界面参考

下面的验证器现在针对更广泛的已发布操作层进行读取,而不仅仅是模式和装置。

Operating surface

Transport, trust, errors, and conformance

These records keep delivery, trust posture, typed failure semantics, and support claims explicit.

Transport

Published bindings

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

Trust

Published trust channels

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

Conformance

Published level ladder

  • 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 能力协商

Errors

Published message error codes

  • invalid_message: 无效消息
  • unknown_profile: 个人资料未知
  • capability_not_supported: 不支持的能力
  • auth_required: 需要身份验证
  • insufficient_trust: 信任不足
  • task_not_found: 未找到任务
  • task_expired: 任务已过期
  • replay_window_violation: 重播窗口违规
  • rate_limited: 速率有限
  • upstream_unavailable: 上游不可用
  • conformance_failed: 一致性失败
  • idempotency_required: 需要幂等性

证明包操作手册

当候选消息需要成为可重用的发布证据而不是保留本地一次性验证器检查时,请使用下面发布的操作手册。

First message

Run one reproducible UAI-1 proof

Start with a published fixture, validate the exact profile, then keep the result with release evidence.

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
        }
    ]
}

Release readiness

From first packet to bounded support claim

A passing validation result is evidence for one packet, not certification or an unlimited support claim.

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 消息,然后在需要持久的机器可读报告时下载生成的一致性记录。

验证器

UAI-1 validator workbench

Paste a candidate message, load a published fixture, choose keyed or keyless normalization, and validate it against the current public UAI-1 profile schemas. The validator now checks the richer envelope, async task-state records, typed error details, field-registry alignment, trace context, delivery expiry, capability-declared transport bindings, conformance levels, and trust-policy hints before deployment.

Conformance input

Validate a UAI message

Use the published fixtures below as known-good starting points or paste a candidate payload from your own integration. Each validation run can also be exported as a `uai.conformance.result.v1` record for CI logs, release evidence, or audit trails.

Use this page as the human-facing validation workflow. The REST validate route is a machine-facing POST endpoint for JSON payloads, not a browsable report page.

Validate first, then run the same packet against the live mock exchange to inspect one conforming response shape before you widen support claims.

Conformance result

Ready to validate

Load a fixture or paste a candidate message, then run the validator.

地位Awaiting input
轮廓Not checked yet
Errors0
Warnings0
NormalizationKeyed JSON
Checked atNot run yet

What will appear here

Run the validator to group issues by severity, resolve the exact public artifacts used during the check, and export a reusable conformance record.

Live response proof

Ready when the packet is validated

Run a passing packet through the live mock exchange to inspect one deterministic response shape before a runtime-specific track exists.

ScenarioAccepted async task
HTTPNot run yet
Response profileNo response yet
Response checkAwaiting proof run

Use the mock exchange after a passing validation

The live reference route returns deterministic accepted, completed, and typed-error envelopes so you can inspect one conforming response shape before a runtime track publishes its own server behavior.

下一步

继续实施一旦候选人消息通过。使用WordPress 出版轨道用于出版和包装,或.NET 桥轨为了更深入的运行时集成,然后通过记录面向发布的更改变更日志消息.

架构提案

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

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

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

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