Comenzar

¿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.

1. Orientar:empezar conUAI-1, Ajuste de estándares, yHoja de rutaseparar el contrato público actual de las obras previstas para el puente.
2. 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.
3. 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.
4. 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.
5. 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#

1. 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.
2. 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.
3. 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.
4. 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.
5. 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#

1. Empezar conUAI-1comprender el modelo de mensaje normativo actual.
2. LeerEsquemasyRegistrojuntos para que las reglas de campo, los identificadores de perfil y los identificadores de compatibilidad permanezcan alineados.
3. RevisarEjemplosy ejecutar elValidadorantes de tratar una implementación como conforme.
4. UsarImplementacionespara elegir la publicación o pista de tiempo de ejecución que se adapte a su entorno.

Ruta de desarrollador de cinco minutos#

1. AbiertoUAI-1y lea las primeras secciones de límites para saber qué cubre el contrato público actual.
2. Elige uno publicadoEjemploy resolver su coincidenciaEsquemayRegistroentrada.
3. Ejecute el mismo paquete a través delValidadorpara que tenga evidencia revisable en lugar de solo una impresión en prosa.
4. 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#

1. Elija un perfil UAI-1 y confirme por qué ese perfil coincide con el intercambio que desea respaldar.
2. Cree o asigne un mensaje candidato con campos explícitos de versión, perfil, fuente, destino, cuerpo, procedencia e integridad.
3. Valide el mensaje y guarde el resultado antes de conectarlo a una ruta de liberación.
4. 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.
5. 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.

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.json

Utilice 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.

{
    "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
        }
    ]
}

curl -sS /wp-json/uaix/v1/catalog

const catalog = await fetch('/wp-json/uaix/v1/catalog').then((response) => response.json());

$catalog = json_decode(file_get_contents('/wp-json/uaix/v1/catalog'), true, 512, JSON_THROW_ON_ERROR);

catalog = requests.get('/wp-json/uaix/v1/catalog', timeout=10).json()

Primer éxito mínimo#

1. Elija un perfil publicado y cree un mensaje que coincida con el propósito declarado.
2. Valide ese mensaje con el esquema publicado y el registro de registro.
3. Compare el mensaje con un dispositivo de ejemplo publicado.
4. Guarde el registro de validación resultante como parte de su evidencia de liberación.

Primera prueba pública#

1. 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.
2. resolver el emparejamientoEsquema, Registroy rutas de páginas canónicas antes de la validación para que otro revisor pueda reproducir el mismo paquete.
3. Ejecute elValidador, exporte el resultado y conserve el ejemplo exacto o el mensaje candidato utilizado durante la verificación.
4. 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.
5. 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.

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.