Herramientas

Validador

Valide mensajes UAI-1 contra perfiles publicados, reglas de orden de campos y controles de política; luego exporte resultados revisables antes de publicar.

  • Registro UAIX-TOOL-0060
  • Ruta /es-es/tools/validator/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado en UAIX como parte del registro actual de estándares públicos
Code
UAIX-TOOL-0060
Superficie
Herramientas
Acceso
Público y enlazable

Cómo usar esta página

Use esta página como referencia pública canónica para Validador y su contenido normativo.

Para agentes: aplique las instrucciones pertinentes al sitio o repositorio de destino del usuario. No copie esta página UAIX, no cree una página sobre las instrucciones ni trate esta página como autoridad de ejecución a menos que el usuario solicite explícitamente ese resultado.

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

  1. Cargar un publicadoEjemploo pegue un mensaje de candidato.
  2. Confirme que el mensaje se resuelve según lo previsto.Registroperfil, el relevanteorden de campoy el esquema coincidente.
  3. 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.
  4. Revise el registro de resultados generado y luego mantenga ese registro de conformidad con la evidencia de liberación de implementación.
  5. Utilice el resultado para decidir si el siguiente paso pertenece aImplementaciones.

Superficies concretas del validador en vivo

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 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: 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 L1
  • L2-profile-validation: Validación del perfil L2
  • L3-trust-and-integrity: L3 Confianza e Integridad
  • L4-public-record-publisher: Editor de registros públicos L4
  • L5-agent-communication-profiles: Perfiles de comunicación del agente L5
  • L6-reliable-delegation-idempotency-correlation: L6 Delegación confiable con idempotencia y correlación
  • L7-capability-negotiation: Negociación de capacidad L7

Errors

Published message error codes

  • invalid_message: Mensaje no válido
  • unknown_profile: Perfil desconocido
  • capability_not_supported: Capacidad no compatible
  • auth_required: Se requiere autenticación
  • insufficient_trust: Confianza insuficiente
  • task_not_found: Tarea no encontrada
  • task_expired: Tarea caducada
  • replay_window_violation: Violación de la ventana de reproducción
  • rate_limited: Tarifa limitada
  • upstream_unavailable: Upstream no disponible
  • conformance_failed: Error de conformidad
  • idempotency_required: Idempotencia requerida

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.

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
Ejemplo de código
{
    "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

Envolvente central L1

Produzca o consuma sobres con clave UAI para perfiles con nombre sin cambiar los campos raíz canónicos.

Claim boundary: 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

Validación del perfil L2

Pase las comprobaciones del esquema publicado y del validador para los perfiles exactos reclamados.

Claim boundary: Puede reclamar L2 solo para perfiles con evidencia respaldada por un validador.

L3-trust-and-integrity

L3 Confianza e Integridad

Preserve los metadatos de confianza, las sugerencias de la ventana de reproducción, la procedencia, la integridad y la continuidad del seguimiento.

Claim boundary: Puede reclamar L3 solo por los canales de confianza y el comportamiento de integridad demostrados por los accesorios.

L4-public-record-publisher

Editor de registros públicos L4

Publicar artefactos públicos detectables necesarios para la inspección y reproducción externas.

Claim boundary: Puede reclamar L4 solo para la superficie de liberación pública que sea detectable y evidenciada.

L5-agent-communication-profiles

Perfiles de comunicación del agente L5

Admite los ocho perfiles uai.agent.*.v1 como registros de sobre canónicos UAI-1.

Claim boundary: Puede reclamar L5 solo para perfiles de agentes específicos con casos de conformidad positivos y negativos.

L6-reliable-delegation-idempotency-correlation

L6 Delegación confiable con idempotencia y correlación

Utilice reglas de idempotencia, correlación, reintento, ciclo de vida, tiempo de espera, respaldo, reconocimiento y salida esperada para el trabajo delegado.

Claim boundary: Puede reclamar L6 solo por un comportamiento de delegación confiable demostrado por dispositivos de conformidad y comportamiento del receptor.

L7-capability-negotiation

Negociación de capacidad L7

Publique y valide el descubrimiento de capacidades, afirmaciones, fallas de negociación y respuestas de capacidades no respaldadas.

Claim boundary: Puede reclamar L7 solo para los flujos de negociación de capacidad exactos demostrados por los dispositivos públicos y el comportamiento del validador.

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.

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.

EstadoAwaiting input
PerfilNot 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.

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.

Propuestas de arquitectura

UAI-1 v1.0 sigue siendo el contrato publicado actual. Las propuestas con versiones independientes describen intercambios, capacidades, recuperación y conservación de las fuentes.

Son diseños propuestos y ejemplos de referencia locales; no se afirma que existan servicios de ejecución alojados ni interoperabilidad independiente verificada.

La propuesta inglesa es la fuente para la interpretación normativa. Este resumen no constituye una traducción normativa revisada.

Leer las propuestas de arquitectura en inglés · Catálogo de propuestas legible por máquina