Herramientas

Herramientas

Validador, descubrimiento, registro de campos y herramientas de revisión que ayudan a los equipos a probar y adoptar UAI-1.

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

Estado del documento

Página de estándares públicos Publicado el UAIX como parte del registro de estándares públicos actuales
Código
UAIX-TOOL-0060
Superficie
Herramientas
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta página para encontrar el validador y otras herramientas de soporte para inspección, descubrimiento y adopción.

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

Estampación

Las herramientas UAIX admiten validación, inspección, gobernanza de órdenes de campo, revisión de confianza y transporte, pruebas de dispositivos, descubrimiento legible por máquina e incorporación de implementación para UAI-1.

¿Con qué herramientas deberían ayudar?

  • Resuelva el registro público actual sin eliminar el texto de la página.
  • Inspeccione los destinos del esquema, los ID de los perfiles, el orden de los campos, los accesorios, los enlaces de transporte, los canales de confianza, los códigos de error y las expectativas de conformidad antes del lanzamiento.
  • Saque a la superficie la deriva estructural, los errores de flujo de trabajo asíncrono, los problemas de contexto de rastreo y las brechas en las políticas de confianza antes de que los usuarios intermedios dependan de ellos.
  • Exporte los resultados de conformidad como registros revisables que pueden trasladarse a notas de la versión, registros de CI o evidencia de auditoría.

Ruta de herramientas primaria

La mayoría de los lectores deberían comenzar con elValidador, luego regrese aEjemploso avanzar haciaImplementacionesdependiendo de si la próxima necesidad es depurar o publicar evidencia.

WordPress superficie de gestión de memoria

UAI Gestión de memoriaes el paquete de administración UAIX.org WordPress para mantener la memoria activa .uai, archivos de Persona avanzada, superficies de memoria docs/ y wiki/ existentes, mensajes de actualización protegidos y exportaciones de transferencia de proyectos alineadas. Úselo cuando un sitio WordPress necesite humanos y agentes para ver memoria obsoleta, de gran tamaño, duplicada o faltante antes de que esa deriva contamine el contexto futuro.

Superficie experimental de comida para perros

UAIX Protocolo de agentessigue siendo el registro dogfood heredado para el mismo linaje de complementos, verificaciones previas de ZIP, rechazo de fallas de validación, limpieza y evidencia de humo de activación. Trate esa ruta como evidencia histórica; utilice UAI Gestión de memoria para la superficie pública actual del complemento de administración.

Ruta de conformidad de Hola Mundo

  1. Elige uno publicadoEjemploo preparar un mensaje de candidato vinculado a un perfil público conocido.
  2. Resuelva los registros coincidentes de esquema, registro, orden de campos, transporte, confianza y errores antes de ejecutar la verificación para que otro revisor pueda reproducir el mismo paquete.
  3. Ejecute elValidadory exportar el resultado como un registro revisable.
  4. Llevar ese resultado aImplementaciones, elRegistro de cambios, Noticias, yReferencias y colaboradorescuando el cheque respalda una liberación pública o un reclamo de respaldo.
  5. Repita la ejecución siempre que cambien los esquemas, las asignaciones de registro, el orden de los campos, la guía de transporte, los códigos de error, el comportamiento del validador o las asignaciones de tiempo de ejecución.

Ruta de inicio publicada

Utilice la ejecución de prueba pública y las llamadas de clientes a continuación cuando la siguiente tarea sea incorporar una herramienta, un script o un flujo de control de calidad a la superficie pública en vivo sin ayuda privada.

Camino de prueba

How the first proof packet should move through validation

Use this flow when a candidate message needs to become exportable evidence instead of staying a local test.

Paso 1

Resolve the live catalog

Pull the current route inventory first so the rest of the proof run stays anchored to the published machine surface.

Paso 2

Fetch one starter example

Use one published request example as the first packet so your review starts from current public structure instead of local guesswork.

Paso 3

Wrap the message for validation

Build one validator request body with the example packet nested under `message` and request the result record format.

Paso 4

Run one validator check

Submit the validation request to the live POST route and keep the returned result record with the exact packet that was checked.

Paso 5

Test the live reference response

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

Carry only the named next step

Move from proof into the named implementation lane, conformance pack, and release trail instead of claiming broader support than the site publishes.

起步消息 Example packet JSON starter-message.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": "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
        }
    ]
}
验证请求 Wrap the packet for validator POST validate-request.json
Ejemplo de código
{
    "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"
}
Reference exchange Ask the live mock surface for one conforming response mock-exchange-request.json
Ejemplo de código
{
    "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
            }
        ]
    }
}

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.

Client examples

Copyable starter requests in curl, PowerShell, Python, and TypeScript

Use these plain HTTP snippets to reach the live public surface quickly, including the reference-response route, while official runtime tracks remain intentionally narrow.

Starter snippets use the live public routes, not a private SDK or unpublished helper layer.

curl

Plain shell

Fastest raw HTTP path for docs, smoke checks, CI probes, and quick manual review.

Kit de adopción Fetch the published onboarding bundle uai-adoption-kit.json
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalogar Resolve the live route catalog
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/catalog"
Ejemplo Fetch one published starter packet example-record.json
Ejemplo de código
curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Validar Submit the packet for a result record validate-request.json
Ejemplo de código
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Intercambio simulado Request one live conforming response mock-exchange-request.json
Ejemplo de código
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

Superficies de descubrimiento y mapas del sitio

La automatización y el control de calidad público deberían poder resolver el mismo inventario de páginas tanto desde la superficie de descubrimiento raíz como desde el espacio de ruta con prefijo local.

  • Usar/.well-known/uaix.jsoncomo el manifiesto legible por máquina preferido.
  • Usar/sitemap.xmly/sitemap.htmla medida que aparecen el rastreo de raíz duradero y el directorio.
  • Usar/en-us/sitemap.xmly/en-us/sitemap.htmlcuando los lectores o herramientas localizados necesitan el mismo inventario a través del espacio de ruta en inglés.
  • Trate los archivos del mapa del sitio raíz como la superficie SEO pública canónica incluso cuando las rutas del mapa del sitio con prefijo local también estén activas y probadas.

Rutas actuales orientadas a las máquinas

La superficie de herramientas pública incluye una página de validación orientada a humanos más rutas REST orientadas a máquinas para automatización y verificaciones de liberación.

Referencia API y superficies de paquetes reutilizables

  • Asistente de paquete de memoria de IAguía un paquete de inicio compatible hacia un modelo de paquete, un perfil de sistema completo, una plataforma de archivos para copiar y pegar, un resumen del receptor, un paquete de inicio, una superposición de manifiesto, un libro de registro de puntero semántico a largo plazo necesario para la configuración de la memoria duradera, metadatos de preparación y descarga ZIP canónica sin reclamar generación alojada general, escrituras automáticas en el repositorio o sincronización automática de wiki.
  • Referencia APIconvierte la superficie REST en vivo en un manual ruta por ruta con un documento OpenAPI 3.1 publicado y ejemplos de solicitudes iniciales.
  • Kit de adopciónpublica el paquete de incorporación de primera prueba con archivos de inicio, cargas útiles listas para el validador y ejemplos de intercambio simulado.
  • Paquete de conformidadreúne los esquemas más amplios, los datos de registro, los accesorios, la guía de confianza y transporte, y los puntos de entrada del validador en un paquete reutilizable y legible por máquina.
  • /wp-json/uaix/v1/adoption-kites el paquete de incorporación orientado a la máquina para el recorrido reutilizable de primera prueba más corto; agregue ?download=1 cuando desee la misma respuesta como archivo adjunto.
  • /wp-json/uaix/v1/openapi.jsones la exportación OpenAPI orientada a la máquina para la superficie UAIX REST en vivo.
  • /wp-json/uaix/v1/conformance-packes el paquete JSON orientado a la máquina para la revisión del lanzamiento y el trabajo de conformidad repetible; agregue ?download=1 cuando desee la misma respuesta como archivo adjunto.
  • /wp-json/uaix/v1/roadmapes el registro del plan futuro orientado a la máquina para el trabajo actual, próximo, planificado y de investigación; agregue ?download=1 cuando desee la misma respuesta como archivo adjunto.

Referencias publicadas de superficies operativas

Los registros a continuación son parte de la superficie del protocolo legible por máquina en vivo y deben incluirse con un esquema y una resolución de ejemplo al evaluar la interoperabilidad o las reclamaciones de soporte.

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+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

Superficie de descubrimiento

La automatización debe comenzar con el catálogo de estándares y manifiesto de descubrimiento actual UAIX.

Descubrimiento

Machine-readable standards discovery

UAIX publishes a durable manifest so implementers, validators, and downstream tools can discover the current UAI-1 surfaces, including the adoption-kit bundle and live reference exchange route, without scraping the public pages.

Discovery manifest

Well-known entry points

Use the `.well-known` manifest for durable site discovery, or the REST discovery route when you want the same data from the API surface. Production deployments should publish the same manifest from the canonical HTTPS origin.

Release
UAI-1
Profiles
61
Generated
2026-07-26T09:45:52+00:00

Public routes

Current machine-facing surface

The manifest advertises the API and public publication paths that make up the current UAIX standards surface.

  • Catalogar: /wp-json/uaix/v1/catalog
  • Esquemas: /wp-json/uaix/v1/schemas
  • Registro: /wp-json/uaix/v1/registry
  • Registro de campos: /wp-json/uaix/v1/field-registry
  • Fijaciones de transporte: /wp-json/uaix/v1/transport-bindings
  • Canales de confianza: /wp-json/uaix/v1/trust-channels
  • Niveles de conformidad: /wp-json/uaix/v1/conformance-levels
  • Registro de errores: /wp-json/uaix/v1/error-registry
  • Ejemplos: /wp-json/uaix/v1/examples
  • Validar: /wp-json/uaix/v1/validate (POST JSON)
  • Kit de adopción: /wp-json/uaix/v1/adoption-kit
  • Intercambio simulado: /wp-json/uaix/v1/mock-exchange (GET metadata, POST message)

Siguiente paso

Comience con elValidador, luego lleve la evidencia resultante aImplementaciones, elRegistro de cambios, yNoticiascuando el resultado afecte a un comunicado público.