验证器检查什么
验证器工作台根据已发布的配置文件架构、字段顺序治理记录以及 UAI-1 的当前操作界面期望检查候选 UAI 消息。
- 六个已发布消息系列的架构对齐。
- 注册表支持的配置文件和标识符解析。
- 通过公共现场登记处进行现场订购和无钥匙运输期望。
- 跟踪上下文、交付、信任通道、异步任务状态和一致性摘要策略检查超出了纯 JSON 结构。
- 针对已发布的错误注册表进行类型化故障验证,并针对已发布的传输绑定和一致性级别进行功能声明检查。
- 当一致性失败或开始出现偏差时,可预测的问题报告。
一致性结果意味着什么
一致性结果是机器可读的证据,表明候选消息已根据当前公共记录进行检查。它适用于审查、发布门、回归检查和审计证据。它本身不能替代发布包或实现支持声明。
通过的结果可以让你做什么,不能让你做什么
- 支持:声称已审查的消息与验证时发布的公共记录一致。
- 不支持:超出所附实施记录的认证、合作伙伴批准、永久兼容性或一般运行时支持的声明。
- 在公众支持之前需要更多:发布包、实施跟踪记录、发布跟踪条目以及您想要提出的声明的相应已发布的一致性级别。
团队在部署之前应如何使用验证器
- 加载已发布的示例或粘贴候选人消息。
- 确认消息已解析为预期内容注册表简介、相关现场秩序,以及匹配的模式。
- 当传输、信任或错误行为很重要时,请使用同一审核数据包携带已发布的传输绑定、信任通道、错误注册表和一致性级别。
- 检查生成的结果记录,然后将该一致性记录与实施发布证据一起保存。
- 使用结果来决定下一步是否属于实施.
混凝土实时验证器表面
- 人性化工作台:使用此页面进行夹具加载、并排审查和可下载的一致性记录。
- 面向机器的验证路线:
/wp-json/uaix/v1/validate接受 JSONPOST自动化和发布管道的请求。 - 支持机器可读记录路由:
/wp-json/uaix/v1/catalog,/wp-json/uaix/v1/schemas,/wp-json/uaix/v1/registry,/wp-json/uaix/v1/field-registry, 和/wp-json/uaix/v1/examples公开验证过程中使用的核心目录、模式、注册表、字段顺序和固定装置清单。 - 运营指导路线:
/wp-json/uaix/v1/transport-bindings,/wp-json/uaix/v1/trust-channels,/wp-json/uaix/v1/conformance-levels, 和/wp-json/uaix/v1/error-registry公开验证器现在引用的传输、信任、支持声明和故障处理指南。
一致性证据如何成为公开发布记录
- 将导出的一致性结果附加到相关实施或包发布中,而不是将它们保留为私有本地检查。
- 使用变更日志当架构、配置文件、字段顺序、传输、信任或验证器行为更改影响迁移预期时。
- 使用消息当通过或失败的版本需要面向公众的摘要时。
- 使用参考文献和贡献者当版本需要围绕其一致性证据的稳定发现和引用链接时。
验证结果解读
- 经过:提交的消息与记录的检查时间的公共配置文件、架构、注册表和当前验证器策略相匹配。
- 警告:该消息在结构上可能是可用的,但存在偏差、证据缺失、信任态势薄弱或审查上下文,这些应在支持语言扩展之前解决。
- 失败:在更正并重新运行列出的配置文件、模式、字段顺序、信任、跟踪、传递或正文问题之前,不应将消息用作发布证据。
- 重新运行触发器:当公共记录、验证者行为、实现版本、路由状态或支持声明发生变化时重新运行。
已发布的操作界面参考
下面的验证器现在针对更广泛的已发布操作层进行读取,而不仅仅是模式和装置。
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+jsonhttps-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.
{
"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.
Conformance result
Ready to validate
Load a fixture or paste a candidate message, then run the validator.
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.
Errors
0Warnings
0Resolved public artifacts
Carry these exact records with the validation result so another reviewer can reproduce the same proof packet without private context.
Run the validator to generate a 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.
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.
Mock response validation notes
0Run the mock exchange to capture a deterministic response envelope.下一步
继续实施一旦候选人消息通过。使用WordPress 出版轨道用于出版和包装,或.NET 桥轨为了更深入的运行时集成,然后通过记录面向发布的更改变更日志和消息.
架构提案
UAI-1 v1.0 仍是当前发布的契约。独立版本的提案涵盖独立交换、能力声明、故障恢复和源记录保留。
这些内容是提议的设计和本地参考示例,并不声称提供托管运行时服务或已验证独立互操作性。
规范解释以英文提案为源文;此界面摘要不代表已审定的规范译文。