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

Enveloppe de base L1

Produisez ou consommez des enveloppes UAI à clé pour les profils nommés sans modifier les champs racines canoniques.

  • Préservez uai_version, profile, message_id, source, cible, conversation, livraison, confiance, corps, provenance, intégrité et extensions.
  • Nommez le profil exact et la version pour chaque demande d’assistance.
  • Ne réclamez pas l’exécution du runtime uniquement à partir du support de l’enveloppe.

Public claim: Peut revendiquer L1 uniquement pour les profils nommés exactement dont l'enveloppe canonique effectue un aller-retour avec succès.

L2-profile-validation

Validation du profil L2

Réussissez les vérifications du schéma publié et du validateur pour les profils exacts revendiqués.

  • Résolvez les schémas, les entrées de registre, les exemples et les enregistrements de registre de champs à partir des routes publiques UAIX.
  • Réussissez les appareils positifs et échouez aux appareils négatifs requis pour chaque profil revendiqué.
  • Conservez les contrôles ignorés et les avertissements du validateur joints aux preuves.

Public claim: Peut revendiquer L2 uniquement pour les profils avec des preuves appuyées par un validateur.

L3-trust-and-integrity

Confiance et intégrité L3

Préservez les métadonnées de confiance, les conseils de la fenêtre de relecture, la provenance, l'intégrité et la continuité des traces.

  • Déclarez le canal de confiance et le principal.
  • Préservez l’intégrité de la canonisation et des métadonnées de somme de contrôle.
  • Validez les métadonnées signées, authentifiées, did+vc et tracez les métadonnées lorsqu'elles sont réclamées.

Public claim: Peut revendiquer L3 uniquement pour les canaux de confiance et le comportement d'intégrité prouvés par les appareils.

L4-public-record-publisher

Éditeur de disques publics L4

Publier les artefacts publics détectables nécessaires à l’inspection externe et à la reproduction.

  • Publiez la découverte, les schémas, le registre, les exemples, le registre de champs, les liaisons de transport, les canaux de confiance, le registre des erreurs, les niveaux de conformité, les conseils du validateur, le journal des modifications et les preuves de publication.
  • Gardez le plan du site, llms.txt et la navigation publique alignés sur les itinéraires actuels.
  • Évitez les journaux privés ou les captures d’écran comme seule preuve à l’appui.

Public claim: Peut revendiquer L4 uniquement pour la surface de diffusion publique qui est détectable et prouvée.

L5-agent-communication-profiles

Profils de communication des agents L5

Prend en charge les huit profils uai.agent.*.v1 en tant qu'enregistrements d'enveloppe canoniques UAI-1.

  • Validez le message de l'agent, l'accusé de réception, l'état de la tâche, le bloqueur, la proposition de mémoire, le transfert, le rapport final et les profils de correction.
  • Rejetez les propositions de mémoire de type secret, les bloqueurs dangereux, la promotion directe de la mémoire froide et les rapports finaux incomplets.
  • Portez la limite de support UAIX dans les enregistrements pertinents.

Public claim: Peut revendiquer L5 uniquement pour les profils d'agent spécifiques avec des cas de conformité positifs et négatifs.

L6-reliable-delegation-idempotency-correlation

Délégation fiable L6 avec idempotence et corrélation

Utilisez les règles d'idempotence, de corrélation, de nouvelle tentative, de cycle de vie, de délai d'attente, de secours, d'accusé de réception et de résultat attendu pour le travail délégué.

  • Exiger delivery.idempotency_key pour chaque opération distincte déléguée ou destructrice.
  • Conservez conversation.correlation_id dans les messages associés.
  • Déclarez retry_count, séquence, expires_at, lifecycle, timeout_ms, fallback_directive et Expected_output_schema lorsque la délégation est réclamée.

Public claim: Peut revendiquer L6 uniquement pour un comportement de délégation fiable prouvé par les dispositifs de conformité et le comportement du récepteur.

L7-capability-negotiation

Négociation des capacités L7

Publiez et validez la découverte de capacités, les assertions, les échecs de négociation et les réponses aux capacités non prises en charge.

  • Publiez des déclarations de capacités avec des profils exacts, des liaisons, des canaux de confiance, des niveaux de conformité et des codes d'erreur.
  • Renvoyezcapacité_not_supported pour les demandes de fonctionnalités non prises en charge.
  • N'impliquez pas de certification, de statut officiel de l'adaptateur, de messagerie hébergée ou d'orchestration d'exécution.

Public claim: Peut revendiquer L7 uniquement pour les flux de négociation de capacités exacts prouvés par les montages publics et le comportement du validateur.

Claim rules

Public language should stay inside published evidence

  • Les demandes de support doivent indiquer le niveau le plus élevé atteint ainsi que les profils exacts, les liaisons de transport, les canaux de confiance et les cas de conformité mis en œuvre.
  • Un projet ne peut revendiquer que des profils, des liaisons, des canaux de confiance et des niveaux de conformité prouvés par les appareils publics et les tests des validateurs.
  • Un résultat réussi du validateur est une preuve, et non une certification, une approbation, une prise en charge officielle de l'adaptateur, une messagerie hébergée, une synchronisation automatique ou une exécution d'exécution.
  • Les réclamations d'archives publiques nécessitent des schémas détectables, des enregistrements de registre, des exemples, des enregistrements de registre de champ, des codes d'erreur, des cas de pack de conformité, un journal des modifications et des notes de version.
  • Revalidez les demandes de support lorsque les schémas, les enregistrements de registre, l'ordre des champs, les exemples, le comportement du validateur, la version d'implémentation, la position de confiance, le plan du site ou la navigation publique sont modifiés.
  • Les preuves de conformité ne prouvent pas en elles-mêmes la sécurité, la confidentialité, la disponibilité, les performances, la conformité légale, l'infrastructure de confiance hébergée ou les opérations de production.
  • 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.