Herramientas

Kit de adopción

Paquete de primera prueba publicado con archivos de inicio, cargas útiles listas para el validador, transferencia de respuesta simulada y próximos pasos de implementación.

  • Registro UAIX-TOOL-0063
  • Ruta /es-es/tools/adoption-kit/
  • 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-0063
Superficie
Herramientas
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta página para obtener el paquete de incorporación publicado, los archivos de inicio y el paquete de transferencia de primera prueba.

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.

Superficies relacionadas

ComenzarValidadorReferencia APIPaquete de conformidad

Paquete de primera prueba

Empiece aqui cuando un paquete respaldado por el validador deba circular limpiamente

El kit de adopcion es la superficie publica de inicio mas breve. Reune archivos iniciales, cargas listas para el validador, ejemplos de intercambio simulado, la lista de evidencia de implementacion, el paquete de fixtures de conformidad y los siguientes pasos para que los equipos pasen de la primera lectura al primer paquete de prueba reutilizable sin armar a mano el mapa de rutas.

Que incluye

Archivos iniciales y llamadas multilenguaje

Use el kit cuando necesite un paquete publico que ya incluya la primera solicitud al validador, el paquete de traspaso simulado y fragmentos de cliente copiables.

Como probarlo

Validador e intercambio simulado juntos

El kit tiene mas valor cuando alimenta un paquete respaldado por el validador y una respuesta simulada en vivo, en lugar de quedar como muestra de solo lectura.

A donde va despues

Lista de evidencia y paquete de fixtures

Lleve el paquete de primera prueba a Implementaciones para las pistas de soporte nombradas; luego ejecute el paquete de fixtures y complete la lista de evidencia antes de que el paquete de conformidad pase a la revision de lanzamiento.

Superficies relacionadas

ComenzarRuta de incorporación de cara humana al paquete.ValidadorEjecución de prueba de cara humana y exportación de resultados.Referencia APIInventario de ruta completo y contrato OpenAPI.Paquete de conformidadPaquete más amplio de evidencia de lanzamiento para revisión de lanzamiento.ImplementacionesCarriles de liberación con nombre para llevar el paquete hacia adelante.

Camino de prueba

Ruta de prueba respaldada por un validador

Mantenga el orden de lectura pública vinculado a un rastro de evidencia: perfil, esquema, ejemplo, resultado del validador y registro de publicación.

  1. 1Elija un perfil de mensaje.Comience con un perfil UAI-1 publicado y la familia de registros que coincida con el intercambio que necesita demostrar.
  2. 2Compárelo con esquemas y ejemplos.Resuelva el esquema, la entrada del registro y un elemento fijo antes de escribir o mapear su paquete candidato.
  3. 3Ejecute la evidencia del validador.Valide JSON con clave, clave minificada o sin clave con los registros públicos UAI-1 actuales.
  4. 4Adjunte el resultado a los registros de implementación o transferencia.Lleve el resultado exportado al paquete de conformidad, al seguimiento de implementación, al registro de cambios o a la evidencia de transferencia del proyecto.
carrera inicialObtenga el paquete, valide un paquete y luego pruebe la transferencia de respuesta
curl -s https://uaix.org/wp-json/uaix/v1/adoption-kit
curl -OJ "https://uaix.org/wp-json/uaix/v1/adoption-kit?download=1"
curl -s -X POST https://uaix.org/wp-json/uaix/v1/validate -H "Content-Type: application/json" -d @validate-request.json
curl -s -X POST https://uaix.org/wp-json/uaix/v1/mock-exchange -H "Content-Type: application/json" -d @mock-exchange-request.json

Utilice la ruta del kit de adopción como transferencia legible por máquina para la incorporación, luego valide y simule el mismo paquete antes de ampliar el paquete de evidencia.

Para qué es esta página

Utilice esta página como el paquete de incorporación publicado más corto para una primera ejecución de prueba en la superficie UAI-1 en vivo. Mantiene los archivos de inicio, las cargas útiles listas para el validador, los ejemplos de intercambio simulado, una lista de verificación de evidencia de implementación, el paquete de dispositivos de conformidad y los próximos pasos de implementación en un paquete público.

¿Qué se envía en el kit?

  • Archivos de inicio copiables para el primer mensaje, la solicitud del validador y la transferencia de revisión de versión.
  • El iniciador en varios idiomas requiere curl, PowerShell, Python y TypeScript.
  • Una lista de verificación de evidencia de implementación que cubre la identidad, el alcance del perfil admitido, la salida del validador, la ruta de la máquina y la postura de la caché, los límites de confianza y amenazas, el control de calidad local y de accesibilidad, los accesorios, el rastro de lanzamiento y los límites de soporte.
  • Un paquete de accesorios de conformidad con casos actuales con clave positiva/minificada/sin clave, metadatos de equivalencia de hash canónico y casos de perfil faltante negativo, campo requerido faltante, campo no declarado, traceparent no válido, DID/VC evidencia de confianza, forma sin llave, desbordamiento sin llave y alias no admitidos.
  • Un paquete de intercambio simulado de referencia más enlaces directos a esquemas, registros, ejemplos y pistas de implementación.

Cuando usarlo

  1. Comience aquí cuando un equipo necesite la ruta más corta desde la lectura de UAI-1 hasta la producción de un paquete reutilizable respaldado por un validador.
  2. Complete la lista de verificación y ejecute el paquete de accesorios antes de convertir una primera prueba en un lanzamiento público o en un lenguaje de soporte.
  3. Convidar aReferencia APIcuando necesite el inventario de ruta completo y el contrato OpenAPI.
  4. Convidar aPaquete de conformidadcuando el paquete necesita el paquete más amplio de evidencia de publicación para la revisión del lanzamiento o el trabajo de regresión.

Definición de hecho para una primera prueba

  • El mensaje declara un perfil publicado y pasa las comprobaciones de política de validación y esquema coincidente.
  • El paquete de evidencia nombra el esquema, la entrada del registro, el registro de campo, el ejemplo o dispositivo, el resultado del validador y la ruta verificada URLs.
  • La implementación nombra exactamente lo que admite y lo que no antes de utilizar cualquier lenguaje de soporte público.
  • La postura de la ruta de la máquina, las POST barreras de seguridad, las suposiciones del canal de confianza y los enlaces de la ruta de liberación se capturan junto al paquete.
  • Otro revisor puede volver a ejecutar la prueba desde rutas públicas UAIX sin notas privadas.

Paquete de incorporación publicado

Utilice el kit de adopción a continuación para obtener el paquete de primera prueba actual y mantener juntos los archivos iniciales exactos, la lista de verificación y el paquete de accesorios.

Kit de adopción

Published first-proof bundle

Use this bundle when you want one machine-readable onboarding packet that starts from the public contract, carries a validator-ready request, includes a conformance record, and points to the next release lane without private context.

What ships together

Minimal public proof packet

  • Starter message, validation request, conformance record, and mock-exchange request.
  • Schema, registry, example, and machine-route links for the first starter profile.
  • Implementation-track entry points for the WordPress and .NET release lanes.
  • Downloadable JSON that another reviewer can reuse without private setup notes.

Best use

Move a team from reading to proof

Use the adoption kit for first-day onboarding, launch QA, evaluator handoff, or internal pairing when a teammate needs the shortest public route from the spec to one reviewable packet.

Starter sequence

How to use the kit on a real first pass

  1. Open the published adoption kit page or JSON route first so onboarding starts from the current public packet instead of private notes.
  2. Resolve one starter profile, then keep its schema, registry entry, and example fixture together as the first proof packet.
  3. Run the validator and keep the resulting conformance record attached to the exact starter packet used during review.
  4. Post the same packet to the mock exchange when you want one live conforming response bundle before a runtime track ships its own implementation.
  5. Fill the implementation evidence checklist before moving from a first proof into public release or support language.
  6. Use the conformance fixture pack to check current positive and negative validator behavior before widening the release packet.
  7. Use the bridge evidence pack when a candidate implementation needs to show how A2A, MCP, OpenAPI, DID/VC, or Trace Context evidence maps into UAI-1 records.
  8. Carry the proof packet into the named implementation track, conformance pack, and release trail before making outward support claims.
Starter file manifest Fetch starter files from the adoption kit JSON uai-adoption-kit-manifest.json
Ejemplo de código
{
    "adoption_kit_url": "https://uaix.org/wp-json/uaix/v1/adoption-kit",
    "download_url": "https://uaix.org/wp-json/uaix/v1/adoption-kit?download=1",
    "starter_files": [
        {
            "label": "Starter message",
            "filename": "starter-message.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Validation request",
            "filename": "validate-request.json",
            "top_level_keys": [
                "message",
                "normalization_mode",
                "format"
            ]
        },
        {
            "label": "Mock exchange request",
            "filename": "mock-exchange-request.json",
            "top_level_keys": [
                "scenario",
                "format",
                "message"
            ]
        },
        {
            "label": "Conformance record",
            "filename": "uai-conformance-record.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Implementation evidence checklist",
            "filename": "implementation-evidence-checklist.json",
            "top_level_keys": [
                0,
                1,
                2,
                3,
                4,
                5,
                6,
                7,
                8,
                9
            ]
        },
        {
            "label": "Conformance fixture pack",
            "filename": "conformance-fixture-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "current_release",
                "uai_version",
                "profile_id",
                "purpose",
                "fixture_count",
                "positive_count",
                "negative_count",
                "coverage",
                "canonical_hash_equivalence",
                "route_contract",
                "cases"
            ]
        },
        {
            "label": "Bridge evidence pack",
            "filename": "bridge-evidence-pack.json",
            "top_level_keys": [
                "kind",
                "generated_at",
                "standard_family",
                "current_release",
                "uai_version",
                "release_date",
                "description",
                "support_boundary",
                "case_count",
                "validated_case_count",
                "adjacent_standard_count",
                "adjacent_standards",
                "uai_profiles",
                "available_in",
                "verification",
                "cases"
            ]
        },
        {
            "label": "Capability profile starter",
            "filename": "capability-profile.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        },
        {
            "label": "Capability negotiation starter",
            "filename": "capability-negotiation.json",
            "top_level_keys": [
                "uai_version",
                "profile",
                "message_id",
                "source",
                "target",
                "conversation",
                "delivery",
                "trust",
                "body",
                "provenance",
                "integrity",
                "extensions"
            ]
        }
    ],
    "use": "Fetch the adoption kit JSON for the full starter file contents."
}
模拟交换响应 已接收任务参考包 uai-mock-exchange.json
Ejemplo de código
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-07-26T07:59:46+00:00",
    "route_url": "https://uaix.org/wp-json/uaix/v1/mock-exchange",
    "scenario": "accepted-task",
    "http_status": 202,
    "summary": "The reference surface accepted the request and returned a conforming async handoff using `uai.intent.response.v1`.",
    "request": {
        "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
                }
            ]
        },
        "validation": {
            "valid": true,
            "checked_at": "2026-07-26T07:59:46+00:00",
            "profile": "uai.intent.request.v1",
            "current_release": "UAI-1",
            "uai_version": "1.0",
            "schema_route_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
            "registry_route_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
            "issue_count": 0,
            "error_count": 0,
            "warning_count": 0,
            "errors": [],
            "warnings": [],
            "status": "pass",
            "normalization": {
                "mode": "keyed-json",
                "status": "current",
                "supported": true,
                "input_shape": "json-object",
                "normalized": false,
                "registry_release": "UAI-1",
                "registry_release_date": "2026-06-02",
                "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "canonicalization": "jcs-compatible-sorted-json",
                "canonical_hash": "sha256:df1471b14bfab5649ab461956640cfe8201aab274f3db190bc621dc195dc2abd",
                "byte_count": 2665
            },
            "conformance_record": {
                "uai_version": "1.0",
                "profile": "uai.conformance.result.v1",
                "message_id": "msg-20260726T075946Z-00d1e16835a8",
                "source": {
                    "type": "service",
                    "id": "uaix.validator",
                    "label": "UAIX Validator",
                    "uri": "https://uaix.org/en-us/tools/validator/",
                    "did": "did:web:uaix.org",
                    "role": "conformance-checker",
                    "implementation": "uaix-core-3.188.0"
                },
                "target": {
                    "type": "message",
                    "id": "msg-2026-04-22-0001",
                    "label": "uai.intent.request.v1",
                    "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                    "did": "did:web:uaix.org",
                    "role": "checked-record",
                    "implementation": "uai.intent.request.v1"
                },
                "conversation": {
                    "conversation_id": "conv-2026-04-22-uaix-001",
                    "turn_id": "turn-validator-00d1e16835a8",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-08-02T07:59:46+00:00",
                    "reply_requested": false,
                    "ack_required": false
                },
                "trust": {
                    "channel": "signed-envelope",
                    "auth_scheme": "validator-record",
                    "principal": "did:web:uaix.org",
                    "credential_ref": "https://uaix.org/.well-known/uai.json",
                    "signature_ref": "https://uaix.org/en-us/tools/validator/",
                    "replay_window_id": "rw-conformance-20260726-00d1e16835a8"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-07-26T07:59:46+00:00"
                    },
                    "artifacts": {
                        "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
                        "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1",
                        "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.request.v1",
                        "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1",
                        "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                        "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                        "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                        "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                        "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                        "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
                    },
                    "target_message_ref": "msg-2026-04-22-0001"
                },
                "provenance": {
                    "trace_id": "trace-7f3a2d",
                    "issued_at": "2026-07-26T07:59:46+00:00",
                    "log_ref": "urn:uaix:log:2026:0001",
                    "agent_id": "uaix.validator",
                    "model_id": "model.uaix.validator-1",
                    "confidence": 1,
                    "lineage": [
                        {
                            "stage": "conformance-export",
                            "actor_id": "uaix.validator",
                            "model_id": "model.uaix.validator-1",
                            "note": "Generated a validator-backed evidence record for the checked message using keyed-json normalization."
                        }
                    ],
                    "parent_trace_id": "trace-7f3a2d"
                },
                "integrity": {
                    "version": 2,
                    "algorithm": "sha256",
                    "canonicalization": "jcs",
                    "checksum": "sha256:d5c3fef11e65c44dcd91b164df0ce15c03cf39c8b69ced323dcdab8c7da7d07d"
                },
                "extensions": [
                    {
                        "namespace": "urn:uaix:ext:evidence",
                        "purpose": "Links conformance output to the exact public artifacts used during validation.",
                        "critical": false
                    }
                ]
            },
            "download_filename": "msg-20260726T075946Z-00d1e16835a8.json"
        }
    },
    "response_profile": "uai.intent.response.v1",
    "response_message": {
        "uai_version": "1.0",
        "profile": "uai.intent.response.v1",
        "message_id": "msg-mock-accepted-597a626a1d45",
        "source": {
            "type": "service",
            "id": "uaix.mock.exchange",
            "label": "UAIX Mock Exchange",
            "uri": "https://uaix.org/wp-json/uaix/v1/mock-exchange",
            "did": "did:web:uaix.org",
            "role": "reference-server",
            "implementation": "uaix-core-3.188.0"
        },
        "target": {
            "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"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-mock-597a626a1d45",
            "parent_message_id": "msg-2026-04-22-0001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01",
            "sequence": 2
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00+00:00",
            "reply_requested": false,
            "ack_required": true,
            "task_ref": "task-mock-597a626a1d45"
        },
        "trust": {
            "channel": "signed-envelope",
            "auth_scheme": "jws",
            "principal": "did:web:uaix.org",
            "credential_ref": "https://uaix.org/.well-known/uai.json",
            "signature_ref": "https://uaix.org/wp-json/uaix/v1/mock-exchange#signature-597a626a1d45",
            "replay_window_id": "rw-mock-597a626a1d45"
        },
        "body": {
            "status": "accepted",
            "subject": "uai.task.status.v1",
            "request_message_id": "msg-2026-04-22-0001",
            "result": {
                "task_id": "task-mock-597a626a1d45",
                "status_profile": "uai.task.status.v1",
                "status_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1",
                "response_profile": "uai.intent.response.v1",
                "follow_up_scenarios": [
                    "completed-response",
                    "typed-error"
                ],
                "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                "mock_exchange_url": "https://uaix.org/wp-json/uaix/v1/mock-exchange"
            },
            "notices": [
                "accepted-task-started",
                "use-task-status-example-for-shape-checks",
                "reference-surface-response"
            ],
            "task_ref": "task-mock-597a626a1d45"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "issued_at": "2026-04-22T16:00:03+00:00",
            "log_ref": "urn:uaix:log:mock:20260726:597a626a1d45",
            "agent_id": "uaix.mock.exchange",
            "model_id": "model.uaix.mock.exchange-1",
            "confidence": 1,
            "lineage": [
                {
                    "stage": "mock-acceptance",
                    "actor_id": "uaix.mock.exchange",
                    "model_id": "model.uaix.mock.exchange-1",
                    "note": "Accepted the request and published a deterministic async handoff from the UAIX mock exchange surface."
                }
            ],
            "parent_trace_id": "trace-7f3a2d"
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:79e9cd5e255815bddda09f81492e6f3fd34855b5739aa6fcace3d03df595935a"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:mock-exchange",
                "purpose": "Marks this envelope as a deterministic response from the UAIX live reference surface for scenario `accepted-task`.",
                "critical": false
            }
        ]
    },
    "response_validation": {
        "valid": true,
        "checked_at": "2026-07-26T07:59:46+00:00",
        "profile": "uai.intent.response.v1",
        "current_release": "UAI-1",
        "uai_version": "1.0",
        "schema_route_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
        "registry_route_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
        "issue_count": 0,
        "error_count": 0,
        "warning_count": 0,
        "errors": [],
        "warnings": [],
        "status": "pass",
        "normalization": {
            "mode": "keyed-json",
            "status": "current",
            "supported": true,
            "input_shape": "json-object",
            "normalized": false,
            "registry_release": "UAI-1",
            "registry_release_date": "2026-06-02",
            "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
            "canonicalization": "jcs-compatible-sorted-json",
            "canonical_hash": "sha256:4cd5bc053a1d0c36611db7d4baccfa3a90613b39edc0d8fe3cfe8031e78601a0",
            "byte_count": 2709
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260726T075946Z-f7da9f6753ce",
            "source": {
                "type": "service",
                "id": "uaix.validator",
                "label": "UAIX Validator",
                "uri": "https://uaix.org/en-us/tools/validator/",
                "did": "did:web:uaix.org",
                "role": "conformance-checker",
                "implementation": "uaix-core-3.188.0"
            },
            "target": {
                "type": "message",
                "id": "msg-mock-accepted-597a626a1d45",
                "label": "uai.intent.response.v1",
                "uri": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                "did": "did:web:uaix.org",
                "role": "checked-record",
                "implementation": "uai.intent.response.v1"
            },
            "conversation": {
                "conversation_id": "conv-2026-04-22-uaix-001",
                "turn_id": "turn-validator-f7da9f6753ce",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-08-02T07:59:46+00:00",
                "reply_requested": false,
                "ack_required": false
            },
            "trust": {
                "channel": "signed-envelope",
                "auth_scheme": "validator-record",
                "principal": "did:web:uaix.org",
                "credential_ref": "https://uaix.org/.well-known/uai.json",
                "signature_ref": "https://uaix.org/en-us/tools/validator/",
                "replay_window_id": "rw-conformance-20260726-f7da9f6753ce"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-07-26T07:59:46+00:00"
                },
                "artifacts": {
                    "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
                    "schema_url": "https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.response.v1",
                    "registry_url": "https://uaix.org/wp-json/uaix/v1/registry/uai.intent.response.v1",
                    "example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
                    "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
                    "transport_bindings_url": "https://uaix.org/wp-json/uaix/v1/transport-bindings",
                    "trust_channels_url": "https://uaix.org/wp-json/uaix/v1/trust-channels",
                    "conformance_levels_url": "https://uaix.org/wp-json/uaix/v1/conformance-levels",
                    "error_registry_url": "https://uaix.org/wp-json/uaix/v1/error-registry",
                    "validate_url": "https://uaix.org/wp-json/uaix/v1/validate"
                },
                "target_message_ref": "msg-mock-accepted-597a626a1d45"
            },
            "provenance": {
                "trace_id": "trace-7f3a2d",
                "issued_at": "2026-07-26T07:59:46+00:00",
                "log_ref": "urn:uaix:log:mock:20260726:597a626a1d45",
                "agent_id": "uaix.validator",
                "model_id": "model.uaix.validator-1",
                "confidence": 1,
                "lineage": [
                    {
                        "stage": "conformance-export",
                        "actor_id": "uaix.validator",
                        "model_id": "model.uaix.validator-1",
                        "note": "Generated a validator-backed evidence record for the checked message using keyed-json normalization."
                    }
                ],
                "parent_trace_id": "trace-7f3a2d"
            },
            "integrity": {
                "version": 2,
                "algorithm": "sha256",
                "canonicalization": "jcs",
                "checksum": "sha256:18d6d036b574ddb9ca03c1c4cd0a0d8dc1125c3e9f115ad3728c312dc40e1dc3"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact public artifacts used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260726T075946Z-f7da9f6753ce.json"
    },
    "links": {
        "catalog_url": "https://uaix.org/wp-json/uaix/v1/catalog",
        "validate_url": "https://uaix.org/wp-json/uaix/v1/validate",
        "field_registry_url": "https://uaix.org/wp-json/uaix/v1/field-registry",
        "response_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.response.v1",
        "task_status_example_url": "https://uaix.org/wp-json/uaix/v1/examples/uai.task.status.v1"
    }
}

Keep the starter packet, validator record, mock response, and named implementation lane together. That bundle is the public adoption handoff the site now publishes directly.

Llamadas iniciales a nivel de ruta

Utilice los ejemplos de ruta y lenguaje a continuación cuando desee el mismo paquete en curl, PowerShell, Python o TypeScript.

Client examples

Route-level starter requests in curl, PowerShell, Python, and TypeScript

Use these snippets when you want the live catalog, example, validator, and mock-response calls without reverse-engineering the REST surface.

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

Siguiente paso

Continuar aImplementacionescuando la ejecución de prueba necesite una línea de liberación con nombre, regrese aValidadorcuando desee el flujo de trabajo del banco de trabajo, o utiliceReferencia APIcuando necesite el contrato de máquina más amplio detrás del kit.