Outils

Kit d'adoption

Ensemble publié de première épreuve avec des fichiers de démarrage, des charges utiles prêtes pour le validateur, un transfert de réponse simulée et les prochaines étapes de mise en œuvre.

  • Dossier UAIX-TOOL-0063
  • Chemin /fr-fr/tools/adoption-kit/
  • Utilisation Dossier public canonique

Statut du document

Page des normes publiques Publié le UAIX dans le cadre du dossier actuel des normes publiques
Code
UAIX-TOOL-0063
Surface
Outils
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez cette page pour récupérer le package d'intégration publié, les fichiers de démarrage et le paquet de transfert de première preuve.

Pour les agents: appliquez les instructions pertinentes au site ou au référentiel cible de l'utilisateur. Ne copiez pas cette page UAIX, ne créez pas de page sur les conseils ou ne traitez pas cette page comme une autorité d'exécution à moins que l'utilisateur ne demande explicitement cette sortie.

Surfaces associées

DémarrerValidateurRéférence APIPaquet de conformité

Paquet de premiere preuve

Commencer ici lorsqu'un paquet valide par le validateur doit circuler proprement

Le kit d'adoption est la surface d'accueil publiee la plus courte. Il regroupe les fichiers de depart, les charges utiles pretes pour le validateur, les exemples d'echange simule, la liste de preuves d'implementation, le paquet de fixtures de conformite et les prochaines etapes afin qu'une equipe passe de la premiere lecture au premier paquet de preuve reutilisable sans reconstruire la carte des routes a la main.

Ce qui est inclus

Fichiers de depart et appels multilangues

Utilisez le kit lorsque vous voulez un paquet public qui inclut deja la premiere requete de validation, le paquet de transfert simule et des extraits client copiables.

Comment le prouver

Validateur et echange simule ensemble

Le kit est surtout utile lorsqu'il alimente un paquet appuye par le validateur et une reponse simulee active, au lieu de rester un simple exemple en lecture seule.

Etape suivante

Liste de preuves et paquet de fixtures

Portez le paquet de premiere preuve dans les implementations pour les pistes de support nommees, puis executez le paquet de fixtures et remplissez la liste de preuves avant que le paquet de conformite parte en revue de lancement.

Surfaces associées

DémarrerChemin d'intégration face à l'humain dans le bundle.ValidateurExécution d’épreuves face à l’homme et exportation des résultats.Référence APIInventaire complet de l'itinéraire et contrat OpenAPI.Paquet de conformitéEnsemble plus large de preuves de publication pour l'examen du lancement.ImplémentationsVoies de libération nommées pour faire avancer le paquet.

Chemin de preuve

Chemin de preuve soutenu par le validateur

Gardez l'ordre de lecture publique lié à une seule piste de preuves: profil, schéma, exemple, résultat du validateur et enregistrement de publication.

  1. 1Choisissez un profil de message.Commencez par un profil UAI-1 publié et la famille d'enregistrements qui correspond à l'échange que vous devez prouver.
  2. 2Comparez-le avec des schémas et des exemples.Résolvez le schéma, l'entrée de registre et un appareil avant d'écrire ou de mapper votre dossier de candidat.
  3. 3Exécutez des preuves de validation.Validez les JSON avec clé, à clé minifiée ou sans clé par rapport aux enregistrements publics UAI-1 actuels.
  4. 4Joignez le résultat aux enregistrements d’implémentation ou de transfert.Transportez le résultat exporté dans le pack de conformité, le suivi de mise en œuvre, le journal des modifications ou les preuves de transfert de projet.
Course de démarrageRécupérez le bundle, validez un paquet, puis testez le transfert de réponse
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

Utilisez la route du kit d'adoption comme transfert lisible par machine pour l'intégration, puis validez et simulez le même paquet avant d'élargir l'ensemble des preuves.

À quoi sert cette page

Utilisez cette page comme le package d’intégration publié le plus court pour une première exécution d’épreuve sur la surface UAI-1 en direct. Il conserve les fichiers de démarrage, les charges utiles prêtes pour le validateur, les exemples d’échange simulé, une liste de contrôle des preuves de mise en œuvre, le pack de dispositifs de conformité et les prochaines étapes de mise en œuvre dans un seul paquet public.

Ce qui est livré dans le kit

  • Fichiers de démarrage copiables pour le premier message, la demande du validateur et le transfert de révision de la version.
  • Le démarreur multilingue appelle curl, PowerShell, Python et TypeScript.
  • Une liste de contrôle des preuves de mise en œuvre couvrant l’identité, la portée du profil pris en charge, le résultat du validateur, l’état de l’itinéraire machine et du cache, les limites de confiance et de menace, l’assurance qualité des paramètres régionaux et de l’accessibilité, les appareils, la piste de version et les limites de prise en charge.
  • Un pack d’appareils de conformité avec les cas actuels avec clé positive/minifiée/sans clé, les métadonnées d’équivalence de hachage canonique et les cas de profil manquant négatif, de champ obligatoire manquant, de champ non déclaré, de traceparent invalide, de preuve de confiance DID/VC, de forme sans clé, de débordement sans clé et d’alias non pris en charge.
  • Un paquet d’échange simulé de référence ainsi que des liens directs vers des schémas, un registre, des exemples et des pistes de mise en œuvre.

Quand l’utiliser

  1. Commencez ici lorsqu’une équipe a besoin du chemin le plus court entre la lecture de UAI-1 et la production d’un paquet réutilisable soutenu par un validateur.
  2. Remplissez la liste de contrôle et exécutez le pack de luminaires avant de transformer une première épreuve en version publique ou en langage de support.
  3. Passer àRéférence APIlorsque vous avez besoin de l’inventaire complet de l’itinéraire et du contrat OpenAPI.
  4. Passer àPaquet de conformitélorsque le paquet a besoin de l’ensemble plus large de preuves de publication pour le travail de révision du lancement ou de régression.

Définition de fait pour une première preuve

  • Le message déclare un profil publié et réussit les vérifications de schéma et de politique de validation correspondantes.
  • Le paquet de preuves nomme le schéma, l’entrée de registre, le registre de champ, l’exemple ou l’appareil, le résultat du validateur et la route vérifiée URLs.
  • L’implémentation nomme exactement ce qu’elle prend en charge et ce qu’elle ne prend pas en charge avant d’utiliser un langage de support public.
  • La posture de l’itinéraire machine, les garde-fous POST, les hypothèses de canal de confiance et les liens de piste de publication sont capturés à côté du paquet.
  • La preuve peut être réexécutée par un autre réviseur à partir des routes publiques UAIX sans notes privées.

Pack d’intégration publié

Utilisez le kit d’adoption ci-dessous pour récupérer le paquet de première épreuve actuel et conserver ensemble les fichiers de démarrage exacts, la liste de contrôle et le pack de luminaires.

Kit d'adoption

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
Exemple de code
{
    "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
Exemple de code
{
    "kind": "uaix.mock.exchange.result.v1",
    "generated_at": "2026-07-27T01:05:34+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-27T01:05:34+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-20260727T010534Z-4b7dff60fcff",
                "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-4b7dff60fcff",
                    "parent_message_id": "msg-2026-04-22-0001",
                    "sequence": 2,
                    "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
                },
                "delivery": {
                    "mode": "sync",
                    "priority": "routine",
                    "expires_at": "2026-08-03T01:05:34+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-20260727-4b7dff60fcff"
                },
                "body": {
                    "status": "pass",
                    "checked_profile": "uai.intent.request.v1",
                    "issues": [],
                    "summary": {
                        "error_count": 0,
                        "warning_count": 0,
                        "checked_at": "2026-07-27T01:05:34+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-27T01:05:34+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-20260727T010534Z-4b7dff60fcff.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:20260727: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:126113ba38574d8f3103e6d036b0aed0b2c1b5e57ffe3ab5e2481151e13ea945"
        },
        "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-27T01:05:34+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:cf50851e845aa05069524c04ee3161b66c7245106d70ca09ca1515a87b4f0882",
            "byte_count": 2709
        },
        "conformance_record": {
            "uai_version": "1.0",
            "profile": "uai.conformance.result.v1",
            "message_id": "msg-20260727T010534Z-fc348324cd5c",
            "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-fc348324cd5c",
                "parent_message_id": "msg-mock-accepted-597a626a1d45",
                "sequence": 3,
                "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-550702a0f1ed2653-01"
            },
            "delivery": {
                "mode": "sync",
                "priority": "routine",
                "expires_at": "2026-08-03T01:05:34+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-20260727-fc348324cd5c"
            },
            "body": {
                "status": "pass",
                "checked_profile": "uai.intent.response.v1",
                "issues": [],
                "summary": {
                    "error_count": 0,
                    "warning_count": 0,
                    "checked_at": "2026-07-27T01:05:34+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-27T01:05:34+00:00",
                "log_ref": "urn:uaix:log:mock:20260727: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:49bb8800c0e13273846a444aca0bee980f3ed29b2f933092ada30709c648e60e"
            },
            "extensions": [
                {
                    "namespace": "urn:uaix:ext:evidence",
                    "purpose": "Links conformance output to the exact public artifacts used during validation.",
                    "critical": false
                }
            ]
        },
        "download_filename": "msg-20260727T010534Z-fc348324cd5c.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.

Appels de démarrage au niveau de la route

Utilisez les exemples d’itinéraire et de langage ci-dessous lorsque vous souhaitez le même paquet dans curl, PowerShell, Python ou 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 d'adoption Fetch the published onboarding bundle uai-adoption-kit.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalogue Resolve the live route catalog
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/catalog"
Exemple Fetch one published starter packet example-record.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Valider Submit the packet for a result record validate-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Échange simulé Request one live conforming response mock-exchange-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

Étape suivante

Continuez àImplémentationslorsque l’épreuve nécessite une voie de libération nommée, revenez àValidateurlorsque vous souhaitez utiliser le workflow Workbench, ou utilisezRéférence APIlorsque vous avez besoin du contrat de machine plus large derrière le kit.