Lo que verifica el validador
El banco de trabajo del validador inspecciona los mensajes candidatos UAI comparándolos con los esquemas de perfil publicados, los registros de gobernanza del orden de campo y las expectativas actuales de la superficie operativa para UAI-1.
- Alineación de esquemas para las seis familias de mensajes publicados.
- Resolución de identificadores y perfiles respaldados por registros.
- Expectativas de orden de campo y transporte sin llave a través del registro público de campo.
- Verificaciones de políticas de contexto de seguimiento, entrega, canal de confianza, estado de tarea asíncrono y resumen de conformidad que van más allá de la estructura pura JSON.
- Validación de fallas escritas contra el registro de errores publicado y verificaciones de declaraciones de capacidad contra los enlaces de transporte publicados y los niveles de conformidad.
- Informes de problemas predecibles cuando falla la conformidad o comienza la desviación.
Qué significa un resultado de conformidad
Un resultado de conformidad es la evidencia legible por máquina de que un mensaje candidato se comparó con el registro público actual. Es apropiado para revisión, puertas de liberación, verificaciones de regresión y evidencia de auditoría. No sustituye a un paquete de lanzamiento ni a un reclamo de soporte de implementación por sí solo.
Lo que un resultado pasajero te deja y no te deja reclamar
- Soporta:una afirmación de que el mensaje revisado se alineaba con el registro público publicado en el momento de la validación.
- No soporta:un reclamo de certificación, aprobación de socios, compatibilidad permanente o soporte de tiempo de ejecución general más allá del registro de implementación adjunto.
- Necesita más antes del apoyo público:un paquete de lanzamiento, un historial de implementación, una entrada de seguimiento de lanzamiento y el nivel de conformidad publicado apropiado para el reclamo que desea hacer.
Cómo deben utilizar los equipos el validador antes de la implementación
- Cargar un publicadoEjemploo pegue un mensaje de candidato.
- Confirme que el mensaje se resuelve según lo previsto.Registroperfil, el relevanteorden de campoy el esquema coincidente.
- Cuando el transporte, la confianza o el comportamiento de error sean importantes, lleve los enlaces de transporte publicados, los canales de confianza, el registro de errores y los niveles de conformidad con el mismo paquete de revisión.
- Revise el registro de resultados generado y luego mantenga ese registro de conformidad con la evidencia de liberación de implementación.
- Utilice el resultado para decidir si el siguiente paso pertenece aImplementaciones.
Superficies concretas del validador en vivo
- Banco de trabajo de cara humana:utilice esta página para cargar dispositivos, realizar revisiones en paralelo y descargar registros de conformidad.
- Ruta de validación cara a cara:
/wp-json/uaix/v1/validateacepta JSONPOSTsolicitudes de canalizaciones de automatización y lanzamiento. - Admite rutas de registros legibles por máquina:
/wp-json/uaix/v1/catalog,/wp-json/uaix/v1/schemas,/wp-json/uaix/v1/registry,/wp-json/uaix/v1/field-registry, y/wp-json/uaix/v1/examplesexponer el catálogo principal, el esquema, el registro, el orden de los campos y el inventario de elementos utilizados durante la validación. - Rutas de guiado operativas:
/wp-json/uaix/v1/transport-bindings,/wp-json/uaix/v1/trust-channels,/wp-json/uaix/v1/conformance-levels, y/wp-json/uaix/v1/error-registryexponer la guía de transporte, confianza, reclamo de soporte y manejo de fallas a la que ahora hace referencia el validador.
Cómo la evidencia de conformidad se convierte en un registro de divulgación pública
- Adjunte los resultados de conformidad exportados a la implementación o versión del paquete correspondiente en lugar de dejarlos como comprobaciones locales privadas.
- Utilice elRegistro de cambioscuando los cambios de esquema, perfil, orden de campos, transporte, confianza o comportamiento del validador afectan las expectativas de migración.
- UsarNoticiascuando una publicación aprobada o reprobada necesita un resumen público.
- UsarReferencias y colaboradorescuando la publicación necesita enlaces estables de descubrimiento y citas en torno a su evidencia de conformidad.
Interpretación del resultado de la validación.
- Aprobar:el mensaje enviado coincidía con el perfil público, el esquema, el registro y la política actual del validador en el momento de la verificación registrada.
- Advertencia:el mensaje puede ser estructuralmente utilizable, pero conlleva deriva, evidencia faltante, una postura de confianza débil o un contexto de revisión que debe resolverse antes de que se expanda el lenguaje de apoyo.
- Fallar:el mensaje no debe usarse como evidencia de divulgación hasta que los problemas de perfil, esquema, orden de campo, confianza, seguimiento, entrega o cuerpo enumerados se corrijan y se vuelvan a ejecutar.
- Activador de repetición:vuelva a ejecutar cuando cambie el registro público, el comportamiento del validador, la versión de implementación, la postura de la ruta o la reclamación de soporte.
Referencias publicadas de superficies operativas
El validador a continuación ahora lee en una capa operativa publicada más amplia, no solo los esquemas y accesorios.
Operating surface
Transport, trust, errors, and conformance
These records make the UAI-1 operating layer explicit instead of leaving transport binding, trust posture, typed failure semantics, or support claims to private convention.
Transport
Published bindings
- Default
- https-json-envelope.v1
- Bindings
- 2
https-json-envelope.v1:application/vnd.uaix.uai+jsonhttps-json-keyless.v1:application/vnd.uaix.uai-keyless+json
Trust
Published trust channels
public-web: Registros legibles públicamente a través de HTTPS sin configuración previa de confianza bilateral.private-api: Intercambio de servicio a servicio en una red con alcance o límite de inquilino.mtls: Intercambio autenticado por transporte donde la identidad del par está anclada en la capa de conexión.signed-envelope: La firma a nivel de mensaje o la referencia de firma separada acompañan al registro.credentialed: El remitente o el contexto de ejecución está respaldado por una credencial verificable por máquina o una afirmación de identidad firmada comparable.
Conformance
Published level ladder
L1-core-envelope: Envolvente central L1L2-profile-validation: Validación del perfil L2L3-trust-and-integrity: L3 Confianza e IntegridadL4-public-record-publisher: Editor de registros públicos L4L5-agent-communication-profiles: Perfiles de comunicación del agente L5L6-reliable-delegation-idempotency-correlation: L6 Delegación confiable con idempotencia y correlaciónL7-capability-negotiation: Negociación de capacidad L7
Errors
Published message error codes
invalid_message: Mensaje no válidounknown_profile: Perfil desconocidocapability_not_supported: Capacidad no compatibleauth_required: Se requiere autenticacióninsufficient_trust: Confianza insuficientetask_not_found: Tarea no encontrada
Runbook de paquetes de prueba
Utilice el runbook publicado a continuación cuando un mensaje candidato deba convertirse en evidencia de publicación reutilizable en lugar de seguir siendo una verificación única del validador local.
Camino de prueba Use this flow when a candidate message needs to become exportable evidence instead of staying a local test. Paso 1 Pull the current route inventory first so the rest of the proof run stays anchored to the published machine surface. Paso 2 Use one published request example as the first packet so your review starts from current public structure instead of local guesswork. Paso 3 Build one validator request body with the example packet nested under `message` and request the result record format. Paso 4 Submit the validation request to the live POST route and keep the returned result record with the exact packet that was checked. Paso 5 Post the same validated packet to the mock exchange route when you want one real conforming response shape before a runtime track exists. Paso 6 Move from proof into the named implementation lane, conformance pack, and release trail instead of claiming broader support than the site publishes. Keep the starter packet, validator request, and mock-exchange request required for mock-exchange configuration together with the returned result. That bundle is the smallest repeatable proof-and-response packet on the current public surface. Post-validation path Use this map when the validator passed and the next job is turning that result into reusable release evidence instead of stopping at a local check. Stage 1 A published fixture or candidate message passed against the current public record. Stage 2 The passing result now travels with implementation versioning, artifact links, and discovery context. Stage 3 The named implementation track and release trail now say what is publicly supported and what is still out of scope. Keep from each run Before release-ready Current public conformance levels: Use these levels for outward-facing language once the packet becomes part of a named release and implementation record. L1-core-envelope Produzca o consuma sobres con clave UAI para perfiles con nombre sin cambiar los campos raíz canónicos. Public claim: Puede reclamar L1 solo para los perfiles con nombre exacto cuyo sobre canónico realiza viajes de ida y vuelta con éxito. L2-profile-validation Pase las comprobaciones del esquema publicado y del validador para los perfiles exactos reclamados. Public claim: Puede reclamar L2 solo para perfiles con evidencia respaldada por un validador. L3-trust-and-integrity Preserve los metadatos de confianza, las sugerencias de la ventana de reproducción, la procedencia, la integridad y la continuidad del seguimiento. Public claim: Puede reclamar L3 solo por los canales de confianza y el comportamiento de integridad demostrados por los accesorios. L4-public-record-publisher Publicar artefactos públicos detectables necesarios para la inspección y reproducción externas. Public claim: Puede reclamar L4 solo para la superficie de liberación pública que sea detectable y evidenciada. L5-agent-communication-profiles Admite los ocho perfiles uai.agent.*.v1 como registros de sobre canónicos UAI-1. Public claim: Puede reclamar L5 solo para perfiles de agentes específicos con casos de conformidad positivos y negativos. L6-reliable-delegation-idempotency-correlation Utilice reglas de idempotencia, correlación, reintento, ciclo de vida, tiempo de espera, respaldo, reconocimiento y salida esperada para el trabajo delegado. Public claim: Puede reclamar L6 solo por un comportamiento de delegación confiable demostrado por dispositivos de conformidad y comportamiento del receptor. L7-capability-negotiation Publique y valide el descubrimiento de capacidades, afirmaciones, fallas de negociación y respuestas de capacidades no respaldadas. Public claim: Puede reclamar L7 solo para los flujos de negociación de capacidad exactos demostrados por los dispositivos públicos y el comportamiento del validador. Claim rules Working rule: Use the conformance ladder for language, but use the named implementation track and release trail for the actual public support boundary.How the first proof packet should move through validation
Resolve the live catalog
Fetch one starter example
Wrap the message for validation
Run one validator check
Test the live reference response
Carry only the named next step
/wp-json/uaix/v1/catalog
Esquema
/wp-json/uaix/v1/schemas/uai.intent.request.v1
Ejemplo
/wp-json/uaix/v1/examples/uai.intent.request.v1
Validar
/wp-json/uaix/v1/validate
Kit de adopción
/wp-json/uaix/v1/adoption-kit
Intercambio simulado
/wp-json/uaix/v1/mock-exchange
{
"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": "https://uaix.org/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
}
]
}{
"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 Gateway",
"uri": "https://uaix.org/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"
}{
"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 Gateway",
"uri": "https://uaix.org/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
}
]
}
}What should happen after a passing validator result
Validated packet
Release-ready packet
Public support claim
Artifacts that should stay attached to every validator result
What still needs to be attached after the pass
Envolvente central L1
Validación del perfil L2
L3 Confianza e Integridad
Editor de registros públicos L4
Perfiles de comunicación del agente L5
L6 Delegación confiable con idempotencia y correlación
Negociación de capacidad L7
Public language should stay inside published evidence
Banco de trabajo del validador
Utilice el banco de trabajo público a continuación para cargar un dispositivo publicado o validar un mensaje UAI candidato con la versión actual, luego descargue el registro de conformidad resultante cuando necesite un informe duradero legible por máquina.
Validador
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.Siguiente paso
Continuar aImplementacionesuna vez que pasa el mensaje del candidato. Utilice elWordPress Pista de publicaciónpara publicación y embalaje, o elPista del puente.NETpara una integración más profunda del tiempo de ejecución, luego registre los cambios relacionados con el lanzamiento a través delRegistro de cambiosyNoticias.