¿Para quién es esto?
Utilice UAIX si está implementando, evaluando, gobernando o citando intercambios de sistemas de IA que necesitan una estructura declarada y revisable. UAIX es el sitio público de publicación y estándares, UAI es la familia de estándares y UAI-1 es la versión normativa actual.
Rutas de lectura por rol
- Implementadores:empezar conUAI-1, luego avanzaEsquemas, Registro, Ejemplos, elValidador, yImplementaciones.
- Constructores de herramientas:empezar conEsquemas, Registro, Ejemplos, elValidadory la superficie de descubrimiento publicada para que la automatización pueda resolver las rutas actuales de forma limpia.
- Investigadores y lectores de normas:empezar conUAI-1, luego usa elRegistro de cambios, Noticias, yReferencias y colaboradorescuando necesite la pista de revisión pública y el contexto de la cita.
- Editores, revisores y colaboradores:empezar conReferencias y colaboradores, elRegistro de cambios, Noticias, y elValidadorpor lo que las propuestas permanecen adjuntas al registro público en lugar de notas privadas.
- Lectores públicos y prensa:empezar conNoticiaspara la ruta de lanzamiento público, luego usePrensayReferencias y colaboradorespara un lenguaje externo y vínculos duraderos.
Memoria de IA y ruta de transferencia
Si está incorporando una nueva IA, un nuevo contratista o un segundo equipo desde archivos del repositorio en lugar de desde el historial de chat privado, comience conMemoria de IApara el paquete de encuadre público y de inicio en vivo, luego useTraspaso de proyectocuando necesita el patrón de ingeniería para un archivo raíz AGENTS.md, un resumen .uai/readme.human y un paquete .uai/ local.
- Orientación más rápida:leerMemoria de IAprimero, luegoTraspaso de proyecto, entoncesTraspaso de archivos de agentepara el patrón de entrada de carpeta desplegable activo, entonces elEspecificación de vinculación AGENTS.md .uaicuando necesita una sintaxis de enlace explícita.
- Antecedentes más profundos:usarInformesyRefinando el protocolo UAI para la comunicación del agentecuando necesita un razonamiento más prolongado de validación, interoperabilidad y seguridad detrás de la capa de transferencia.
- Cuando el traspaso se convierte en evidencia pública:volver aUAI-1, Esquemas, Registro, Ejemplos, elValidador, yImplementaciones.
primeros 15 minutos
Utilice esta ruta rápida cuando intente comprender dónde encaja UAIX en una arquitectura agente: el arnés ejecuta el trabajo, MCP y A2A pueden admitir la coordinación del tiempo de ejecución y UAIX preserva la evidencia revisada y la memoria del proyecto que debería sobrevivir a la ejecución.
- Orientar:empezar conUAI-1, Ajuste de estándares, yHoja de rutaseparar el contrato público actual de las obras previstas para el puente.
- Construir memoria:usarMemoria de IA, elAsistente de paquete de memoria de IA, yTraspaso de proyectocuando el próximo humano o agente necesita un contexto de inicio duradero.
- Demuestre un intercambio:elige unoEjemplo, ejecuta elValidadory mantenga el resultado al lado delKit de adopciónoPaquete de conformidadcuando el paquete avanza hacia la revisión.
- Planificar ajuste agente:usarEstrategias de aprovechamiento agenteico y UAIpara mantener la orquestación, las herramientas, las aprobaciones, el seguimiento y la memoria activa en el tiempo de ejecución mientras UAIX registra la prueba portátil.
- Verifique el reclamo:una ejecución de prueba es evidencia de paquetes, no certificación, respaldo, soporte de adaptador oficial, SDK, CLI, sincronización automática o conformidad amplia.
¿Qué problema resuelve UAI-1?
UAI-1 brinda a los implementadores un sobre público estable para identidad, declaración de perfil, intención, contexto, procedencia, transferencia de carga útil, resultados y errores. El objetivo es hacer que la comunicación interoperable entre máquinas sea más fácil de validar, auditar y evolucionar que los dialectos privados de ejecución por ejecución.
Cómo se organiza el trabajo público hoy
UAIX actualmente organiza su trabajo público a través de familias de registros y vías de implementación en lugar de a través de un calendario de eventos, un programa de membresía o un portal comunitario amplio por separado.
- UsarUAI-1, Esquemas, Registro, Ejemplos, Validador, yImplementacionescomo mapa práctico del programa para su adopción técnica.
- UsarRegistro de cambios, Noticias, Referencias y colaboradores, yPrensacomo la capa de publicación, citación y soporte público alrededor de ese mapa.
Lista de verificación de evaluación rápida
- Confirme que el registro público actual existe en rutas canónicas estables:UAI-1, Esquemas, Registro, Ejemplos, elValidador, Implementaciones, elRegistro de cambios, yReferencias y colaboradores.
- Decida si necesita un seguimiento de implementación publicado actual o solo la línea base portátil. Actualmente, las vías públicas son la vía de publicación WordPress y la vía de puente.NET que se describen enImplementaciones.
- Compruebe si el rastro de lanzamiento es visible y actual: use elRegistro de cambiosyNoticiaspara ver cómo se fechan, explican y vinculan los cambios a los registros afectados.
- Compruebe si la transferencia de colaboradores y citas es suficiente para su caso de uso:Referencias y colaboradoresDebería dejar que otro revisor resuelva los mismos registros públicos sin notas privadas.
- Trate los canales de contacto público más amplios, los roles de gobernanza de múltiples partes interesadas y las pistas de tiempo de ejecución adicionales como trabajo futuro, a menos que se publiquen explícitamente en el sitio. UsarGobernanza, Política y seguridad, Privacidad y datos, Accesibilidad, Analítica, yReferencias y colaboradorespara conocer la postura de confianza publicada actualmente en la superficie de lanzamiento.
Que leer primero
- Empezar conUAI-1comprender el modelo de mensaje normativo actual.
- LeerEsquemasyRegistrojuntos para que las reglas de campo, los identificadores de perfil y los identificadores de compatibilidad permanezcan alineados.
- RevisarEjemplosy ejecutar elValidadorantes de tratar una implementación como conforme.
- UsarImplementacionespara elegir la publicación o pista de tiempo de ejecución que se adapte a su entorno.
Ruta de desarrollador de cinco minutos
- AbiertoUAI-1y lea las primeras secciones de límites para saber qué cubre el contrato público actual.
- Elige uno publicadoEjemploy resolver su coincidenciaEsquemayRegistroentrada.
- Ejecute el mismo paquete a través delValidadorpara que tenga evidencia revisable en lugar de solo una impresión en prosa.
- UsarImplementacionessólo para decidir qué soporte se publica realmente hoy; no infiera un SDK o un catálogo de tiempo de ejecución más amplio a partir del propio estándar.
Lista de verificación de adopción
- Elija un perfil UAI-1 y confirme por qué ese perfil coincide con el intercambio que desea respaldar.
- Cree o asigne un mensaje candidato con campos explícitos de versión, perfil, fuente, destino, cuerpo, procedencia e integridad.
- Valide el mensaje y guarde el resultado antes de conectarlo a una ruta de liberación.
- Decida qué vía pública lleva el trabajo a continuación: publicación WordPress, integración de puente.NET u otra ruta de implementación vinculada al registro público.
- Registre cualquier suposición de compatibilidad en el registro de cambios o en las notas de la versión antes de que los usuarios intermedios dependan del comportamiento.
Ruta de lectura adaptativa a la capacidad
Si el próximo lector puede ser un rastreador, un buscador de tokens bajos, un agente asistido por navegador, un agente de llamada de herramientas, un agente de flujo de trabajo, un tiempo de ejecución de múltiples agentes o un sistema auditado, leaInteracción web adaptable a la capacidadantes de ampliar las reclamaciones de apoyo.
¿Qué registros necesitas a continuación?
- El registro normativo sobreUAI-1.
- Objetivos de validación automática enEsquemas.
- Perfil estable y referencias de identificador enRegistro.
- Accesorios de trabajo enEjemplos.
- Evidencia de validación de laValidador.
- Dirección de despliegue desdeImplementaciones.
Alcance de implementación pública actual
El sitio público actualmente documenta dos carriles de implementación a travésImplementaciones: una ruta de publicación WordPress y una ruta de puente.NET.
- No asuma Python, JavaScript, SDK, CLI u otro soporte de tiempo de ejecución a menos que se haya publicado un registro de implementación público.
- Si está evaluando otro entorno, trate UAI-1, esquemas, entradas de registro, ejemplos y evidencia del validador como línea de base portátil hasta que exista una pista pública.
Kit de desarrollador público actual
- Publicado ahora:UAI-1, esquemas, registro, ejemplos, herramientas, validador, rutas de descubrimiento, rutas de validación, la ruta de publicación WordPress y la ruta de puente.NET.
- Aún no publicado:un SDK, CLI público, un enlace de repositorio de origen independiente, un servidor de referencia de propósito general o un catálogo más amplio de soporte de tiempo de ejecución.
- La mejor lectura de hoy:Trate el kit de desarrollador como páginas canónicas, rutas legibles por máquina, accesorios de ejemplo y exportaciones de validador hasta que esas superficies adicionales se publiquen formalmente.
Cómo encaja UAI-1 con MCP y A2A
- UAI-1:la capa de sobre público, confianza, procedencia, entrega asíncrona y evidencia de publicación para un intercambio.
- MCP:Sesiones locales de herramientas host-cliente-servidor y negociación de capacidades dentro de los límites de una aplicación.
- A2A:descubrimiento de agentes, delegación y coordinación del flujo de tareas entre sistemas cooperantes.
- Mejor ajuste:use UAI-1 encima o al lado de MCP y A2A cuando otro equipo necesite un registro portátil y citable en lugar de solo una interacción local en tiempo de ejecución. UsarAjuste de estándarespara el selector completo UAI-1, MCP y A2A.
Protocol fit Use this decision table when you need to explain quickly why UAIX publishes UAI-1 beside MCP, A2A, and the live OpenAPI route surface. Typical combination: use MCP or A2A for runtime coordination, UAI-1 for the portable public record, and OpenAPI for the route-level HTTP description when an API is involved. Architecture map Use this visual path when onboarding new readers: start from the runtime layer, shape one UAI-1 packet, validate it against the published artifacts, then carry only the named release evidence forward. Runtime layer These layers can handle local tool use, delegation, and execution flow without being treated as the public release record. Portable public layer UAI-1 keeps the exchange citable, reviewable, and validator-ready when it has to travel beyond one runtime boundary. Artefactos legibles por máquina These records turn the written contract into machine checks, fixtures, route lookups, and exportable conformance evidence. Release surface Carry the validated packet into the named implementation lane and the public release trail instead of leaving support claims as local notes. Companion records: transport bindings, trust channels, the error registry, and conformance levels stay beside the message contract so delivery, identity posture, typed failures, and support claims remain explicit.When to use UAI-1 vs MCP, A2A, and OpenAPI
Comparison point
UAI-1
MCP
A2A
OpenAPI
Primary role
Portable public exchange, trust declaration, async-delivery, and release-evidence record.
Host-client-server tool sessions and capability negotiation inside an application boundary.
Agent discovery, delegation, and task-flow coordination across cooperating systems.
Route-level HTTP API description for onboarding, documentation, and client generation.
Best when
Another team needs a citable message contract and validator-backed evidence.
One host application needs local tool, resource, or model integration.
Multiple agents need explicit handoff, delegation, and task-state coordination.
You need a documented HTTP surface, including the UAIX machine-facing REST routes.
Carries on the record
Identity, workflow continuity, trust posture, provenance, typed errors, and conformance evidence.
Tools, resources, prompts, and runtime session capabilities within the host boundary.
Agent capabilities, task lifecycles, delegation state, and inter-agent coordination.
Endpoints, methods, parameters, request bodies, responses, and auth schemes for an API.
Does not try to replace
Transport choice, local orchestration, a single credential stack, or the runtime tool bus itself.
Portable public release records or validator-backed support claims outside the local session boundary.
A general-purpose public message envelope or long-term release-evidence record.
Message-level provenance, portable trust posture, or validator-driven interoperability evidence.
How the launch surface fits together from runtime to release
MCP, A2A, orchestrators, SDKs
UAI-1 envelope, trust, provenance, delivery
Schemas, registry, examples, validator
Conformance pack, implementation tracks, release trail
Puntos de entrada de la máquina listos para el lanzamiento
- Referencia APItraduce la superficie REST en vivo en un manual ruta por ruta con OpenAPI solicitudes de exportación y de inicio.
- Kit de adopciónpublica el paquete de primera prueba con archivos de inicio, cargas útiles listas para el validador y un paquete de intercambio simulado de referencia.
- Paquete de conformidadreúne los artefactos de lanzamiento más amplios en un paquete JSON reutilizable para el trabajo de revisión y regresión del lanzamiento.
/wp-json/uaix/v1/adoption-kitpublica el paquete de incorporación legible por máquina y admite un formulario de descarga directa con?download=1./wp-json/uaix/v1/openapi.jsonpublica la descripción actual OpenAPI 3.1 de las rutas UAIX orientadas a la máquina./wp-json/uaix/v1/conformance-packpublica el paquete de conformidad actual legible por máquina y admite un formulario de descarga directa con?download=1.
Primeras llamadas a máquina
curl -s /wp-json/uaix/v1/catalog
curl -s /wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -s /wp-json/uaix/v1/adoption-kit
curl -s -X POST /wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.jsonUtilice primero el catálogo, luego resuelva un esquema o ejemplo, extraiga el paquete de incorporación publicado y envíe una ejecución del validador. Ese es el camino más corto desde la lectura del estándar hasta la comprobación de un paquete frente al registro público.
Ejecución de primera prueba publicada
Utilice el runbook público y las llamadas iniciales a continuación cuando el próximo objetivo sea un paquete respaldado por un validador creado completamente a partir de la superficie publicada actualmente.
First proof run Use this runbook when the next goal is one validator-backed packet built only from the currently published public surface. 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. Client examples 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. Fits local Windows review and operational scripts without adding extra HTTP tooling. Useful when a team wants a portable script without depending on a published SDK yet. Good for browser or Node-based tooling that needs typed request handling around the live public routes.Get to one valid UAI-1 message in five minutes
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
}
]
}
}Copyable starter requests in curl, PowerShell, Python, and TypeScript
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.jsoncurl -sS "https://uaix.org/wp-json/uaix/v1/catalog"curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.jsoncurl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
-H "Content-Type: application/json" \
-d @validate-request.jsoncurl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
-H "Content-Type: application/json" \
-d @mock-exchange-request.jsonInvoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/adoption-kit" | ConvertTo-Json -Depth 20 | Set-Content .\uai-adoption-kit.jsonInvoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/catalog"Invoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" | ConvertTo-Json -Depth 20 | Set-Content .\example-record.json$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ message = $message; format = "result" } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "https://uaix.org/wp-json/uaix/v1/validate" -ContentType "application/json" -Body $body$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ scenario = "accepted-task"; format = "exchange"; message = $message } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "https://uaix.org/wp-json/uaix/v1/mock-exchange" -ContentType "application/json" -Body $bodyimport json, urllib.request
kit = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/adoption-kit"))import json, urllib.request
catalog = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/catalog"))example_record = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1"))
message = example_record.get("message", example_record)payload = json.dumps({"message": message, "format": "result"}).encode("utf-8")
request = urllib.request.Request("https://uaix.org/wp-json/uaix/v1/validate", data=payload, headers={"Content-Type": "application/json"}, method="POST")
result = json.load(urllib.request.urlopen(request))payload = json.dumps({"scenario": "accepted-task", "format": "exchange", "message": message}).encode("utf-8")
request = urllib.request.Request("https://uaix.org/wp-json/uaix/v1/mock-exchange", data=payload, headers={"Content-Type": "application/json"}, method="POST")
exchange = json.load(urllib.request.urlopen(request))const kit = await fetch("https://uaix.org/wp-json/uaix/v1/adoption-kit").then((response) => response.json());const catalog = await fetch("https://uaix.org/wp-json/uaix/v1/catalog").then((response) => response.json());const exampleRecord = await fetch("https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1").then((response) => response.json());
const message = exampleRecord.message ?? exampleRecord;const result = await fetch("https://uaix.org/wp-json/uaix/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ message, format: "result" }),
}).then((response) => response.json());const exchange = await fetch("https://uaix.org/wp-json/uaix/v1/mock-exchange", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ scenario: "accepted-task", format: "exchange", message }),
}).then((response) => response.json());
Primer éxito mínimo
- Elija un perfil publicado y cree un mensaje que coincida con el propósito declarado.
- Valide ese mensaje con el esquema publicado y el registro de registro.
- Compare el mensaje con un dispositivo de ejemplo publicado.
- Guarde el registro de validación resultante como parte de su evidencia de liberación.
Primera prueba pública
- Comience con un perfil publicado y un ejemplo coincidente o un mensaje de candidato que permanezca dentro de la misma familia de registros públicos.
- resolver el emparejamientoEsquema, Registroy rutas de páginas canónicas antes de la validación para que otro revisor pueda reproducir el mismo paquete.
- Ejecute elValidador, exporte el resultado y conserve el ejemplo exacto o el mensaje candidato utilizado durante la verificación.
- Adjunte lo pertinenteImplementaciónpista,Referencias y colaboradores, elRegistro de cambios, yNoticiasuna vez que el trabajo pasa de las pruebas locales a un contexto de revisión o lanzamiento público.
- Trate el paquete resultante como evidencia pública actual de alineación, no como una certificación permanente en revisiones futuras.
Qué puede reclamar en cada paso de preparación
- Después de pasar una ejecución del validador:Tiene evidencia pública actual de que un mensaje o accesorio se alineó con el registro publicado en el momento de la revisión.
- Después de armar un paquete de liberación:puede describir el trabajo como listo para su lanzamiento para revisión pública dentro de la vía de implementación elegida.
- Después de que exista un historial público de implementación:solo puede describir esa pista y lanzamiento nombrados como respaldados públicamente, y solo dentro del propietario y alcance indicados en el sitio.
- No convierta las pruebas locales, un resultado satisfactorio o un trabajo en tiempo de ejecución no publicado en afirmaciones de certificación, soporte general del ecosistema o compatibilidad permanente.
Readiness map
From first proof packet to an honest public support claim
Use this map when the next step is moving from one passing validator result into a release packet without overstating current support.
Stage 1
Validated packet
A published fixture or candidate message passed against the current public record.
- Useful for review, debugging, and regression work right away.
- Still evidence only until the result is attached to a named release lane.
Stage 2
Release-ready packet
The passing result now travels with implementation versioning, artifact links, and discovery context.
- Keep the checked packet, validator export, artifact URLs, and compatibility notes together.
- This is the handoff point for launch review, packaging, and repeatable QA.
Stage 3
Public support claim
The named implementation track and release trail now say what is publicly supported and what is still out of scope.
- Scope the claim to the exact profiles, transport bindings, and owner path that are actually published.
- Use the current conformance level and release links so another reader can verify the same state.
Packet essentials
Minimum first proof packet
- One published profile plus its matching schema and registry routes.
- One readable keyed JSON example or candidate message that was actually reviewed.
- One exported validator result tied to the exact packet that was checked.
- Discovery and citation links that let another reviewer resolve the same release state.
Next attachments
Add these before calling the work publicly supported
- The named implementation track and release or package version.
- Compatibility notes plus transport, trust, and error guidance when the workflow depends on them.
- Changelog and release-summary links whenever the result changes the public release posture.
- Only the exact scope that the site currently publishes, not a wider runtime or ecosystem promise.
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
Envolvente central L1
Produzca o consuma sobres con clave UAI para perfiles con nombre sin cambiar los campos raíz canónicos.
- Conserve uai_version, perfil, message_id, fuente, destino, conversación, entrega, confianza, cuerpo, procedencia, integridad y extensiones.
- Nombra el perfil exacto y la liberación para cada reclamo de soporte.
- No reclame la ejecución del tiempo de ejecución únicamente mediante soporte de sobre.
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
Validación del perfil L2
Pase las comprobaciones del esquema publicado y del validador para los perfiles exactos reclamados.
- Resuelva esquemas, entradas de registro, ejemplos y registros de campo de rutas públicas UAIX.
- Aprobar los elementos positivos y no aprobar los elementos negativos requeridos para cada perfil reclamado.
- Mantenga los controles omitidos y las advertencias del validador adjuntas a las pruebas.
Public claim: 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.
- Declarar canal de confianza y principal.
- Preservar la canonicalización de integridad y los metadatos de suma de comprobación.
- Valide los metadatos firmados, acreditados, did+vc y de seguimiento cuando se reclamen.
Public claim: 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.
- Publique descubrimiento, esquemas, registro, ejemplos, registro de campos, enlaces de transporte, canales de confianza, registro de errores, niveles de conformidad, orientación del validador, registro de cambios y evidencia de publicación.
- Mantenga el mapa del sitio, llms.txt y la navegación pública alineados con las rutas actuales.
- Evite registros privados o capturas de pantalla como única evidencia de respaldo.
Public claim: 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.
- Valide los perfiles de mensaje, confirmación, estado de tarea, bloqueador, propuesta de memoria, transferencia, informe final y corrección del agente.
- Rechace propuestas de memoria secretas, bloqueadores inseguros, promoción directa de memoria fría e informes finales incompletos.
- Llevar el límite de soporte UAIX en los registros pertinentes.
Public claim: 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.
- Requerir delivery.idempotency_key para cada operación destructiva o delegada distinta.
- Conservar conversation.correlation_id en todos los mensajes relacionados.
- Declare retry_count, secuencia, expires_at, ciclo de vida, timeout_ms, fallback_directive y expect_output_schema cuando se reclame la delegación.
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
Negociación de capacidad L7
Publique y valide el descubrimiento de capacidades, afirmaciones, fallas de negociación y respuestas de capacidades no respaldadas.
- Publique declaraciones de capacidad con perfiles exactos, enlaces, canales de confianza, niveles de conformidad y códigos de error.
- Devuelve capacidad_not_supported para solicitudes de capacidad no admitidas.
- No implica certificación, estado oficial del adaptador, mensajería alojada ni orquestación en tiempo de ejecución.
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
Public language should stay inside published evidence
- Las declaraciones de soporte deben nombrar el nivel más alto alcanzado más los perfiles exactos, vinculaciones de transporte, canales de confianza y casos de conformidad implementados.
- Un proyecto solo puede reclamar perfiles, vinculaciones, canales de confianza y niveles de conformidad que demuestren los dispositivos públicos y las pruebas de validación.
- Un resultado aprobado del validador es evidencia, no certificación, respaldo, soporte oficial del adaptador, mensajería alojada, sincronización automática o ejecución en tiempo de ejecución.
- Las reclamaciones de registros públicos requieren esquemas detectables, registros de registro, ejemplos, registros de campo, códigos de error, casos de paquetes de conformidad, registros de cambios y notas de la versión.
- Revalide las reclamaciones de soporte cuando cambien los esquemas, los registros de registro, el orden de los campos, los ejemplos, el comportamiento del validador, la versión de implementación, la postura de confianza, el mapa del sitio o la navegación pública.
- La evidencia de conformidad no demuestra por sí sola la seguridad, la privacidad, la disponibilidad, el rendimiento, el cumplimiento legal, la infraestructura de confianza alojada ni las operaciones de producción.
- Keep the implementation page, release trail, and citation/discovery links attached when another team needs to verify the same public state.
Working rule: Use the conformance ladder for language, but use the named implementation track and release trail for the actual public support boundary.
Qué conservar con su primer lanzamiento público
- El registro de validación exportado desde elValidador.
- los elegidosImplementaciónpista y cualquier paquete o nota de tiempo de ejecución vinculada a ella.
- Referencias y colaboradorespara enlaces estables de descubrimiento y citas.
- ElRegistro de cambioscuando los implementadores posteriores necesitan una postura de migración.
- Noticiascuando el trabajo necesita un resumen de publicación de cara al público.
- Prensacuando el comunicado también necesita un lenguaje externo aprobado.
Siguiente paso
Continuar aUAI-1, luego avanzaEsquemas, Registro, Ejemplos, elValidador, yImplementacionesen ese orden. UsarReferencias y colaboradores, elRegistro de cambios, yNoticiaspara mantener rastreable la primera liberación pública.