Démarrer

Démarrer

Première orientation pour les implémenteurs qui évaluent UAIX, UAI et UAI-1 comme programme ouvert d'interopérabilité.

  • Dossier UAIX-GUID-0044
  • Chemin /fr-fr/get-started/
  • 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-GUID-0044
Surface
Démarrer
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez cette page pour passer de l'orientation au chemin actuel de lecture, de validation et de mise en œuvre UAI-1.

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.

Kit de lancement

UAI-1Référence APIKit d'adoptionValidateur

Chemin public le plus rapide

Zéro contexte pour le premier paquet UAI-1 valide

Utilisez le kit de lancement public en une seule passe: résolvez le kit d'adoption, choisissez un profil, validez un paquet, testez le même paquet par rapport à l'échange simulé en direct, puis transférez le résultat dans une piste de mise en œuvre nommée.

Lire la limite

Un profil, un contrat

Commencez par UAI-1, puis gardez le schéma et l'entrée de registre correspondants en vue afin que le contrat public reste concret.

Exécuter la preuve

Premières preuves appuyées par un validateur

Utilisez un exemple ou un message candidat, exécutez le validateur et conservez le résultat exporté avec les enregistrements exacts que vous avez résolus.

Reporter

Choisissez la voie de sortie

Accédez aux implémentations, puis joignez la piste de publication via les pages du journal des modifications, des actualités et de transfert des contributeurs.

Kit de lancement

UAI-1Contrat normatif en vigueur.Référence APIManuel d'itinéraire et export OpenAPI.Kit d'adoptionPublication du bundle de première épreuve et des fichiers de démarrage.ValidateurExécution d’épreuves face à l’homme et exportation des résultats.Échange simuléSurface de réponse de référence en direct pour une forme de réponse réelle.Paquet de conformitéPaquet de version réutilisable pour la révision du lancement.

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.
Appels de démarragePremiers contrôles machine
curl -s https://uaix.org/wp-json/uaix/v1/catalog
curl -s https://uaix.org/wp-json/uaix/v1/schemas/uai.intent.request.v1
curl -s https://uaix.org/wp-json/uaix/v1/adoption-kit
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

Résolvez d'abord le catalogue, puis un schéma, puis le kit d'adoption, puis une exécution du validateur, puis un échange simulé en direct. Il s’agit du chemin le plus court vers le dossier public et vers l’arrière via une véritable enveloppe de réponse.

Pour qui c’est

Utilisez UAIX si vous mettez en œuvre, évaluez, gouvernez ou citez des échanges de systèmes d’IA qui nécessitent une structure déclarée et révisable. UAIX est le site public de normes et de publication, UAI est la famille de normes et UAI-1 est la version normative actuelle.

Parcours des lecteurs par rôle

Mémoire IA et chemin de transfert

Si vous intégrez une nouvelle IA, un nouveau sous-traitant ou une deuxième équipe à partir des fichiers du référentiel plutôt qu’à partir de l’historique des discussions privées, commencez parMémoire IApour le cadrage public et le package de démarrage en direct, puis utilisezTransfert de projetlorsque vous avez besoin du modèle d’ingénierie pour un fichier racine AGENTS.md, un briefing .uai/readme.human et un bundle local .uai/.

15 premières minutes

Utilisez ce chemin rapide lorsque vous essayez de comprendre où UAIX s’intègre dans une architecture agentique: le harnais exécute le travail, MCP et A2A peuvent prendre en charge la coordination d’exécution et UAIX préserve les preuves examinées et la mémoire du projet qui devraient survivre à l’exécution.

  1. Orient:commencer parUAI-1, Ajustement aux normes, etFeuille de routede séparer le marché public actuel des travaux de pont prévus.
  2. Construire de la mémoire:utiliserMémoire IA, leAssistant de paquet de mémoire IA, etTransfert de projetlorsque le prochain humain ou agent a besoin d’un contexte de démarrage durable.
  3. Prouvez un échange:choisissez-en unExemple, exécutez leValidateur, et conservez le résultat à côté duKit d’adoptionouPaquet de conformitélorsque le paquet passe en revue.
  4. Planifier l’ajustement agent:utiliserStratégies de harnais agent et UAIpour conserver l’orchestration, les outils, les approbations, le traçage et la mémoire vive pendant l’exécution pendant que UAIX enregistre la preuve portable.
  5. Vérifiez la réclamation:une épreuve est une preuve de paquet, et non une certification, une approbation, une prise en charge officielle de l’adaptateur, SDK, CLI, une synchronisation automatique ou une large conformité.

Quel problème UAI-1 résout

UAI-1 offre aux implémenteurs une enveloppe publique stable pour l’identité, la déclaration de profil, l’intention, le contexte, la provenance, le transfert de charge utile, les sorties et les erreurs. L’objectif est de rendre la communication interopérable entre machines plus facile à valider, à auditer et à évoluer que les dialectes privés exécution par exécution.

Comment s’organise le travail public aujourd’hui

UAIX organise actuellement son travail public à travers des familles d’enregistrements et des pistes de mise en œuvre plutôt que via un calendrier d’événements distinct, un programme d’adhésion ou un vaste portail communautaire.

Liste de contrôle d’évaluation rapide

  1. Confirmez que le dossier public actuel existe sur des routes canoniques stables:UAI-1, Schémas, Registre, Exemples, leValidateur, Implémentations, leJournal des changements, etRéférences et contributeurs.
  2. Décidez si vous avez besoin d’un suivi de mise en œuvre publié à jour ou uniquement d’une référence portable. Aujourd’hui, les pistes publiques sont la piste de publication WordPress et la piste.NET Bridge décrites sousImplémentations.
  3. Vérifiez si la piste de publication est visible et à jour: utilisez leJournal des changementsetActualitéspour voir comment les modifications sont datées, expliquées et liées aux enregistrements concernés.
  4. Vérifiez si le transfert des contributeurs et des citations est suffisant pour votre cas d’utilisation:Références et contributeursdevrait laisser un autre réviseur résoudre les mêmes enregistrements publics sans notes privées.
  5. Considérez les canaux de contact public plus larges, les rôles de gouvernance multipartites nommés et les pistes d’exécution supplémentaires comme des travaux futurs à moins qu’ils ne soient explicitement publiés sur le site. UtiliserGouvernance, Politique et sécurité, Confidentialité et données, Accessibilité, Analytique, etRéférences et contributeurspour la posture de confiance actuellement publiée sur la surface de lancement.

Que lire en premier

  1. Commencez parUAI-1comprendre le modèle de message normatif actuel.
  2. LireSchémasetRegistreensemble afin que les règles de champ, les identifiants de profil et les poignées de compatibilité restent alignés.
  3. RevoirExempleset exécutez leValidateuravant de traiter une implémentation comme conforme.
  4. UtiliserImplémentationspour choisir la publication ou la piste d’exécution qui correspond à votre environnement.

Parcours développeur de cinq minutes

  1. OuvrirUAI-1et lisez les premières sections de démarcation pour savoir ce que couvre le marché public actuel.
  2. Choisissez-en un publiéExempleet résoudre sa correspondanceSchémaetRegistreentrée.
  3. Exécutez le même paquet via leValidateurvous disposez donc de preuves révisables au lieu d’une simple impression de prose.
  4. UtiliserImplémentationsseulement pour décider quel support est réellement publié aujourd’hui; ne déduisez pas un SDK ou un catalogue d’exécution plus large à partir de la norme elle-même.

Liste de contrôle pour l’adoption

  1. Choisissez un profil UAI-1 et confirmez pourquoi ce profil correspond à l’échange que vous souhaitez prendre en charge.
  2. Créez ou mappez un message candidat avec des champs explicites de version, de profil, de source, de cible, de corps, de provenance et d’intégrité.
  3. Validez le message et enregistrez le résultat avant de le connecter à un chemin de version.
  4. Décidez quelle voie publique portera ensuite le travail: publication WordPress, intégration de pont.NET ou autre chemin de mise en œuvre lié au dossier public.
  5. Enregistrez toutes les hypothèses de compatibilité dans le journal des modifications ou les notes de version avant que les utilisateurs en aval ne dépendent du comportement.

Chemin de lecture adaptatif aux capacités

Si le prochain lecteur peut être un robot d’exploration, un récupérateur de jetons à faible niveau, un agent assisté par navigateur, un agent appelant un outil, un agent de workflow, un environnement d’exécution multi-agent ou un système audité, lisezInteraction Web adaptative aux capacitésavant d’élargir les demandes de pension alimentaire.

De quels enregistrements vous aurez besoin ensuite

Portée actuelle de la mise en œuvre publique

Le site public documente actuellement deux voies de mise en œuvre à traversImplémentations: un chemin de publication WordPress et un chemin de pont.NET.

  • Ne présumez pas de prise en charge de Python, JavaScript, SDK, CLI ou autre runtime à moins qu’un enregistrement d’implémentation public n’ait été publié.
  • Si vous évaluez un autre environnement, traitez UAI-1, les schémas, les entrées de registre, les exemples et les preuves du validateur comme référence portable jusqu’à ce qu’une piste publique existe.

Kit de développement public actuel

  • Publié maintenant:UAI-1, schémas, registre, exemples, outils, validateur, itinéraires de découverte, itinéraires de validation, la piste de publication WordPress et la piste de pont.NET.
  • Pas encore publié:un SDK public, CLI, un lien source-référentiel autonome, un serveur de référence à usage général ou un catalogue de support d’exécution plus large.
  • Meilleure lecture du jour:traitez le kit de développement comme les pages canoniques, les itinéraires lisibles par machine, les exemples de luminaires et les exportations du validateur jusqu’à ce que ces surfaces supplémentaires soient officiellement publiées.

Comment UAI-1 s’intègre avec MCP et A2A

  • UAI-1:l’enveloppe publique, la confiance, la provenance, la livraison asynchrone et la couche de preuve de libération pour un échange.
  • MCP:sessions d’outils hôte-client-serveur locaux et négociation de capacités à l’intérieur d’une limite d’application.
  • A2A:découverte d’agents, délégation et coordination du flux de tâches entre les systèmes coopérants.
  • Meilleur ajustement:utilisez UAI-1 au-dessus ou à côté de MCP et A2A lorsqu’une autre équipe a besoin d’un enregistrement portable et citable plutôt que d’une simple interaction locale à l’exécution. UtiliserAjustement aux normespour le sélecteur complet UAI-1, MCP et A2A.

Protocol fit

When to use UAI-1 vs MCP, A2A, and OpenAPI

Use this decision table when you need to explain quickly why UAIX publishes UAI-1 beside MCP, A2A, and the live OpenAPI route surface.

Comparison point UAI-1 MCP A2A OpenAPI
Primary role Portable public exchange, trust declaration, async-delivery, and release-evidence record. Host-client-server tool sessions and capability negotiation inside an application boundary. Agent discovery, delegation, and task-flow coordination across cooperating systems. Route-level HTTP API description for onboarding, documentation, and client generation.
Best when Another team needs a citable message contract and validator-backed evidence. One host application needs local tool, resource, or model integration. Multiple agents need explicit handoff, delegation, and task-state coordination. You need a documented HTTP surface, including the UAIX machine-facing REST routes.
Carries on the record Identity, workflow continuity, trust posture, provenance, typed errors, and conformance evidence. Tools, resources, prompts, and runtime session capabilities within the host boundary. Agent capabilities, task lifecycles, delegation state, and inter-agent coordination. Endpoints, methods, parameters, request bodies, responses, and auth schemes for an API.
Does not try to replace Transport choice, local orchestration, a single credential stack, or the runtime tool bus itself. Portable public release records or validator-backed support claims outside the local session boundary. A general-purpose public message envelope or long-term release-evidence record. Message-level provenance, portable trust posture, or validator-driven interoperability evidence.

Typical combination: use MCP or A2A for runtime coordination, UAI-1 for the portable public record, and OpenAPI for the route-level HTTP description when an API is involved.

Architecture map

How the launch surface fits together from runtime to release

Use this visual path when onboarding new readers: start from the runtime layer, shape one UAI-1 packet, validate it against the published artifacts, then carry only the named release evidence forward.

Runtime layer

MCP, A2A, orchestrators, SDKs

These layers can handle local tool use, delegation, and execution flow without being treated as the public release record.

Portable public layer

UAI-1 envelope, trust, provenance, delivery

UAI-1 keeps the exchange citable, reviewable, and validator-ready when it has to travel beyond one runtime boundary.

Artefacts lisibles par machine

Schemas, registry, examples, validator

These records turn the written contract into machine checks, fixtures, route lookups, and exportable conformance evidence.

Release surface

Conformance pack, implementation tracks, release trail

Carry the validated packet into the named implementation lane and the public release trail instead of leaving support claims as local notes.

Companion records: transport bindings, trust channels, the error registry, and conformance levels stay beside the message contract so delivery, identity posture, typed failures, and support claims remain explicit.

  1. 1

    Start where the work already happens

    An agent runtime, tool session, or delegated task flow begins the exchange in its native environment.

  2. 2

    Shape one portable UAI-1 record

    Keep identity, target, workflow state, trust posture, and provenance explicit in the public envelope.

  3. 3

    Resolve the matching public artifacts

    Use the schema, registry entry, field order, examples, and operating-surface records that match the packet you want to publish.

  4. 4

    Run the validator and assemble evidence

    Export the conformance result and keep it with the exact artifacts and packet that were reviewed.

  5. 5

    Publish only the named support lane

    Use the implementation track, conformance pack, changelog, and release trail to describe current support without overclaiming the rest of the stack.

Points d’entrée des machines prêtes au lancement

  • Référence APItraduit la surface REST en direct en un manuel itinéraire par itinéraire avec des requêtes d’exportation et de démarrage OpenAPI.
  • Kit d’adoptionpublie le premier ensemble de preuves avec des fichiers de démarrage, des charges utiles prêtes pour le validateur et un paquet d’échange simulé de référence.
  • Paquet de conformitérassemble les artefacts de version plus larges dans un paquet JSON réutilisable pour le travail de révision et de régression du lancement.
  • /wp-json/uaix/v1/adoption-kitpublie le package d’intégration lisible par machine et prend en charge un formulaire de téléchargement direct avec ?download=1.
  • /wp-json/uaix/v1/openapi.jsonpublie la description actuelle OpenAPI 3.1 des routes UAIX orientées machine.
  • /wp-json/uaix/v1/conformance-packpublie le paquet de conformité actuel lisible par machine et prend en charge un formulaire de téléchargement direct avec ?download=1.

Premiers appels machine

Exemple de code
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

Utilisez d’abord le catalogue, puis résolvez un schéma ou un exemple, extrayez le bundle d’intégration publié et soumettez une exécution du validateur. Il s’agit du chemin le plus court pour la machine, depuis la lecture de la norme jusqu’à la preuve d’un paquet par rapport au dossier public.

Première épreuve publiée

Utilisez le runbook public et les appels de démarrage ci-dessous lorsque l’objectif suivant est un paquet soutenu par un validateur, entièrement construit à partir de la surface actuellement publiée.

First proof run

Get to one valid UAI-1 message in five minutes

Use this runbook when the next goal is one validator-backed packet built only from the currently published public surface.

Étape 1

Resolve the live catalog

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

Étape 2

Fetch one starter example

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

Étape 3

Wrap the message for validation

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

Étape 4

Run one validator check

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

Étape 5

Test the live reference response

Post the same validated packet to the mock exchange route when you want one real conforming response shape before a runtime track exists.

Étape 6

Carry only the named next step

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

起步消息 Example packet JSON starter-message.json
Exemple de code
{
    "uai_version": "1.0",
    "profile": "uai.intent.request.v1",
    "message_id": "msg-2026-04-22-0001",
    "source": {
        "type": "agent",
        "id": "agent.alpha",
        "label": "Agent Alpha",
        "uri": "https://agents.alpha.example/runtime",
        "did": "did:web:agents.alpha.example",
        "role": "requesting-agent",
        "implementation": "alpha-runtime-2.4.1"
    },
    "target": {
        "type": "service",
        "id": "uaix.gateway",
        "label": "UAIX Gateway",
        "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
        "did": "did:web:uaix.org",
        "role": "public-record-gateway",
        "implementation": "uaix-core-0.4.0"
    },
    "conversation": {
        "conversation_id": "conv-2026-04-22-uaix-001",
        "turn_id": "turn-001",
        "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
        "sequence": 1
    },
    "delivery": {
        "mode": "async",
        "priority": "interactive",
        "expires_at": "2026-04-22T16:05:00Z",
        "reply_requested": true,
        "ack_required": true
    },
    "trust": {
        "channel": "credentialed",
        "auth_scheme": "did+vc",
        "principal": "did:web:agents.alpha.example",
        "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
        "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_window_id": "rw-2026-04-22-0001",
        "trust_profile": "uai.trust.did-vc-reference.v1",
        "verification_status": "not_verified",
        "credential_status": "not_checked",
        "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
        "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
        "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
        "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
        "verification_checked_at": "2026-04-22T16:00:00Z",
        "verification_expires_at": "2026-04-22T16:05:00Z",
        "assurance_level": "reference_only"
    },
    "body": {
        "intent": "resolve-profile",
        "subject": "uai.task.status.v1",
        "requested_profile": "uai.task.status.v1",
        "parameters": {
            "include_schema": true,
            "include_example": true,
            "include_field_registry": true
        },
        "constraints": [
            "public-record-only",
            "trace-linked",
            "validator-ready"
        ],
        "response_profile": "uai.intent.response.v1"
    },
    "provenance": {
        "trace_id": "trace-7f3a2d",
        "parent_trace_id": "trace-root-uaix-2026",
        "issued_at": "2026-04-22T16:00:00Z",
        "log_ref": "urn:uaix:log:2026:0001",
        "agent_id": "agent.alpha",
        "model_id": "model.alpha.reasoner-2",
        "confidence": 0.98,
        "lineage": [
            {
                "stage": "request-composition",
                "actor_id": "agent.alpha",
                "model_id": "model.alpha.reasoner-2",
                "note": "Requested the async task-status profile and matching field registry."
            }
        ]
    },
    "integrity": {
        "version": 2,
        "algorithm": "sha256",
        "canonicalization": "jcs",
        "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
    },
    "extensions": [
        {
            "namespace": "urn:uaix:ext:delivery",
            "purpose": "Explicit async request handling and expiry semantics.",
            "critical": false
        }
    ]
}
验证请求 Wrap the packet for validator POST validate-request.json
Exemple de code
{
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX Gateway",
            "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    },
    "format": "result"
}
Reference exchange Ask the live mock surface for one conforming response mock-exchange-request.json
Exemple de code
{
    "scenario": "accepted-task",
    "format": "exchange",
    "message": {
        "uai_version": "1.0",
        "profile": "uai.intent.request.v1",
        "message_id": "msg-2026-04-22-0001",
        "source": {
            "type": "agent",
            "id": "agent.alpha",
            "label": "Agent Alpha",
            "uri": "https://agents.alpha.example/runtime",
            "did": "did:web:agents.alpha.example",
            "role": "requesting-agent",
            "implementation": "alpha-runtime-2.4.1"
        },
        "target": {
            "type": "service",
            "id": "uaix.gateway",
            "label": "UAIX Gateway",
            "uri": "https://uaix.org/wp-json/uaix/v1/discovery",
            "did": "did:web:uaix.org",
            "role": "public-record-gateway",
            "implementation": "uaix-core-0.4.0"
        },
        "conversation": {
            "conversation_id": "conv-2026-04-22-uaix-001",
            "turn_id": "turn-001",
            "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01",
            "sequence": 1
        },
        "delivery": {
            "mode": "async",
            "priority": "interactive",
            "expires_at": "2026-04-22T16:05:00Z",
            "reply_requested": true,
            "ack_required": true
        },
        "trust": {
            "channel": "credentialed",
            "auth_scheme": "did+vc",
            "principal": "did:web:agents.alpha.example",
            "credential_ref": "https://agents.alpha.example/credentials/uai-interop.json",
            "signature_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_window_id": "rw-2026-04-22-0001",
            "trust_profile": "uai.trust.did-vc-reference.v1",
            "verification_status": "not_verified",
            "credential_status": "not_checked",
            "verifier_ref": "https://agents.alpha.example/verifiers/uai-trust-policy.json",
            "trust_root_ref": "https://agents.alpha.example/.well-known/uai.json",
            "proof_ref": "https://agents.alpha.example/signatures/msg-2026-04-22-0001.jws",
            "replay_policy_ref": "https://agents.alpha.example/trust/replay-policy.json",
            "verification_checked_at": "2026-04-22T16:00:00Z",
            "verification_expires_at": "2026-04-22T16:05:00Z",
            "assurance_level": "reference_only"
        },
        "body": {
            "intent": "resolve-profile",
            "subject": "uai.task.status.v1",
            "requested_profile": "uai.task.status.v1",
            "parameters": {
                "include_schema": true,
                "include_example": true,
                "include_field_registry": true
            },
            "constraints": [
                "public-record-only",
                "trace-linked",
                "validator-ready"
            ],
            "response_profile": "uai.intent.response.v1"
        },
        "provenance": {
            "trace_id": "trace-7f3a2d",
            "parent_trace_id": "trace-root-uaix-2026",
            "issued_at": "2026-04-22T16:00:00Z",
            "log_ref": "urn:uaix:log:2026:0001",
            "agent_id": "agent.alpha",
            "model_id": "model.alpha.reasoner-2",
            "confidence": 0.98,
            "lineage": [
                {
                    "stage": "request-composition",
                    "actor_id": "agent.alpha",
                    "model_id": "model.alpha.reasoner-2",
                    "note": "Requested the async task-status profile and matching field registry."
                }
            ]
        },
        "integrity": {
            "version": 2,
            "algorithm": "sha256",
            "canonicalization": "jcs",
            "checksum": "sha256:dd8a9d16c9226cc9d1f4888a4d2bbcbf06b5b4b8"
        },
        "extensions": [
            {
                "namespace": "urn:uaix:ext:delivery",
                "purpose": "Explicit async request handling and expiry semantics.",
                "critical": false
            }
        ]
    }
}

Keep the starter packet, validator request, and mock-exchange request required for mock-exchange configuration together with the returned result. That bundle is the smallest repeatable proof-and-response packet on the current public surface.

Client examples

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

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

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

curl

Plain shell

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

Kit 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

Premier succès minime

  1. Choisissez un profil publié et créez un message qui correspond à son objectif déclaré.
  2. Validez ce message par rapport au schéma publié et à l’enregistrement de registre.
  3. Comparez le message à un exemple d’appareil publié.
  4. Enregistrez le dossier de validation résultant dans le cadre de votre preuve de libération.

Première épreuve publique

  1. Commencez avec un profil publié et soit un exemple d’appareil correspondant, soit un message de candidat qui reste dans la même famille d’enregistrements publics.
  2. Résoudre la correspondanceSchéma, Registreet les chemins de page canoniques avant validation afin qu’un autre réviseur puisse reproduire le même paquet.
  3. Exécutez leValidateur, exportez le résultat et conservez l’exemple exact ou le message candidat utilisé lors de la vérification.
  4. Joindre le correspondantMise en oeuvrepiste,Références et contributeurs, leJournal des changements, etActualitésune fois que le travail passe des tests locaux à un contexte d’examen public ou de publication.
  5. Traitez le paquet résultant comme une preuve publique actuelle de l’alignement, et non comme une certification permanente pour les révisions futures.

Ce que vous pouvez réclamer à chaque étape de préparation

  • Après une exécution réussie du validateur:vous disposez de preuves publiques actuelles qu’un message ou un élément correspondait au dossier publié au moment de l’examen.
  • Après avoir assemblé un paquet de version:vous pouvez décrire le travail comme étant prêt à être publié pour examen public dans le cadre de la piste de mise en œuvre choisie.
  • Une fois qu’un historique public de mise en œuvre existe:vous pouvez décrire uniquement la piste et la version nommées comme étant prises en charge publiquement, et uniquement dans le cadre du propriétaire et de la portée indiqués sur le site.
  • Ne transformez pas les tests locaux, un résultat réussi ou un travail d’exécution non publié en revendications de certification, de support global de l’écosystème ou de compatibilité permanente.

Readiness map

From first proof packet to an honest public support claim

Use this map when the next step is moving from one passing validator result into a release packet without overstating current support.

Stage 1

Validated packet

A published fixture or candidate message passed against the current public record.

  • Useful for review, debugging, and regression work right away.
  • Still evidence only until the result is attached to a named release lane.

Stage 2

Release-ready packet

The passing result now travels with implementation versioning, artifact links, and discovery context.

  • Keep the checked packet, validator export, artifact URLs, and compatibility notes together.
  • This is the handoff point for launch review, packaging, and repeatable QA.

Stage 3

Public support claim

The named implementation track and release trail now say what is publicly supported and what is still out of scope.

  • Scope the claim to the exact profiles, transport bindings, and owner path that are actually published.
  • Use the current conformance level and release links so another reader can verify the same state.

Packet essentials

Minimum first proof packet

  • One published profile plus its matching schema and registry routes.
  • One readable keyed JSON example or candidate message that was actually reviewed.
  • One exported validator result tied to the exact packet that was checked.
  • Discovery and citation links that let another reviewer resolve the same release state.

Next attachments

Add these before calling the work publicly supported

  • The named implementation track and release or package version.
  • Compatibility notes plus transport, trust, and error guidance when the workflow depends on them.
  • Changelog and release-summary links whenever the result changes the public release posture.
  • Only the exact scope that the site currently publishes, not a wider runtime or ecosystem promise.

Current public conformance levels: Use these levels for outward-facing language once the packet becomes part of a named release and implementation record.

L1-core-envelope

L1 Core Envelope

Produce or consume keyed UAI envelopes for named profiles without changing the canonical root fields.

  • Preserve uai_version, profile, message_id, source, target, conversation, delivery, trust, body, provenance, integrity, and extensions.
  • Name the exact profile and release for every support claim.
  • Do not claim runtime execution from envelope support alone.

Public claim: May claim L1 only for the exact named profiles whose canonical envelope round-trips successfully.

L2-profile-validation

L2 Profile Validation

Pass published schema and validator checks for the exact profiles claimed.

  • Resolve schemas, registry entries, examples, and field registry records from public UAIX routes.
  • Pass positive fixtures and fail required negative fixtures for each claimed profile.
  • Keep skipped checks and validator warnings attached to evidence.

Public claim: May claim L2 only for profiles with validator-backed evidence.

L3-trust-and-integrity

L3 Trust and Integrity

Preserve trust metadata, replay-window hints, provenance, integrity, and trace continuity.

  • Declare trust channel and principal.
  • Preserve integrity canonicalization and checksum metadata.
  • Validate signed, credentialed, did+vc, and trace metadata when claimed.

Public claim: May claim L3 only for the trust channels and integrity behavior proven by fixtures.

L4-public-record-publisher

L4 Public Record Publisher

Publish discoverable public artifacts needed for external inspection and reproduction.

  • Publish discovery, schemas, registry, examples, field registry, transport bindings, trust channels, error registry, conformance levels, validator guidance, changelog, and release evidence.
  • Keep sitemap, llms.txt, and public navigation aligned with current routes.
  • Avoid private logs or screenshots as the only support evidence.

Public claim: May claim L4 only for the public release surface that is discoverable and evidenced.

L5-agent-communication-profiles

L5 Agent Communication Profiles

Support the eight uai.agent.*.v1 profiles as canonical UAI-1 envelope records.

  • Validate agent message, ack, task-status, blocker, memory-proposal, handoff, final-report, and correction profiles.
  • Reject secret-like memory proposals, unsafe blockers, cold-memory direct promotion, and incomplete final reports.
  • Carry the UAIX support boundary in relevant records.

Public claim: May claim L5 only for the specific agent profiles with passing positive and negative conformance cases.

L6-reliable-delegation-idempotency-correlation

L6 Reliable Delegation with Idempotency and Correlation

Use idempotency, correlation, retry, lifecycle, timeout, fallback, acknowledgement, and expected-output rules for delegated work.

  • Require delivery.idempotency_key for each distinct delegated or destructive operation.
  • Preserve conversation.correlation_id across related messages.
  • Declare retry_count, sequence, expires_at, lifecycle, timeout_ms, fallback_directive, and expected_output_schema when delegation is claimed.

Public claim: May claim L6 only for reliable delegation behavior proven by conformance fixtures and receiver behavior.

L7-capability-negotiation

L7 Capability Negotiation

Publish and validate capability discovery, assertions, negotiation failures, and unsupported-capability responses.

  • Publish capability statements with exact profiles, bindings, trust channels, conformance levels, and error codes.
  • Return capability_not_supported for unsupported capability requests.
  • Do not imply certification, official adapter status, hosted messaging, or runtime orchestration.

Public claim: May claim L7 only for the exact capability negotiation flows proven by public fixtures and validator behavior.

Claim rules

Public language should stay inside published evidence

  • Support claims must name the highest achieved level plus the exact profiles, transport bindings, trust channels, and conformance cases implemented.
  • A project may claim only profiles, bindings, trust channels, and conformance levels that public fixtures and validator tests prove.
  • A passing validator result is evidence, not certification, endorsement, official adapter support, hosted messaging, automatic sync, or runtime execution.
  • Public-record claims require discoverable schemas, registry records, examples, field registry records, error codes, conformance pack cases, changelog, and release notes.
  • Revalidate support claims when schemas, registry records, field order, examples, validator behavior, implementation version, trust posture, sitemap, or public navigation changes.
  • Conformance evidence does not prove security, privacy, availability, performance, legal compliance, hosted trust infrastructure, or production operations by itself.
  • Keep the implementation page, release trail, and citation/discovery links attached when another team needs to verify the same public state.

Working rule: Use the conformance ladder for language, but use the named implementation track and release trail for the actual public support boundary.

Que conserver avec votre première version publique

  • L’enregistrement de validation exporté depuis leValidateur.
  • L’éluMise en oeuvrepiste et toutes les notes d’emballage ou d’exécution qui y sont liées.
  • Références et contributeurspour des liens de découverte et de citation stables.
  • LeJournal des changementslorsque les responsables de la mise en œuvre en aval ont besoin d’une posture de migration.
  • Actualitéslorsque le travail nécessite un résumé de publication destiné au public.
  • Presselorsque la version nécessite également un langage approuvé destiné à l’extérieur.

Étape suivante

Continuez àUAI-1, puis passez à traversSchémas, Registre, Exemples, leValidateur, etImplémentationsdans cet ordre. UtiliserRéférences et contributeurs, leJournal des changements, etActualitéspour garder la traçabilité de la première version publique.