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
- Metteurs en œuvre:commencer parUAI-1, puis passez à traversSchémas, Registre, Exemples, leValidateur, etImplémentations.
- Constructeurs d’outils:commencer parSchémas, Registre, Exemples, leValidateuret la surface de découverte publiée afin que l’automatisation puisse résoudre proprement les itinéraires actuels.
- Chercheurs et lecteurs de normes:commencer parUAI-1, puis utilisez leJournal des changements, Actualités, etRéférences et contributeurslorsque vous avez besoin de la piste de révision publique et du contexte de citation.
- Rédacteurs, réviseurs et contributeurs:commencer parRéférences et contributeurs, leJournal des changements, Actualités, et leValidateurles propositions restent donc attachées au dossier public plutôt qu’à des notes privées.
- Lecteurs publics et presse:commencer parActualitéspour la piste de diffusion publique, puis utilisezPresseetRéférences et contributeurspour un langage tourné vers l’extérieur et des liens durables.
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/.
- Orientation la plus rapide:lireMémoire IAd’abord, puisTransfert de projet, alorsTransfert de fichiers agentpour le modèle d’admission de dossier de dépôt actif, puis leSpécification de liaison AGENTS.md .uailorsque vous avez besoin d’une syntaxe de lien explicite.
- Contexte plus approfondi:utiliserRapportsetAffinement du protocole UAI pour la communication des agentslorsque vous avez besoin d’un raisonnement plus long en matière de validation, d’interopérabilité et de sécurité derrière la couche de transfert.
- Lorsque le transfert devient une preuve publique:revenir àUAI-1, Schémas, Registre, Exemples, leValidateur, etImplémentations.
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.
- Orient:commencer parUAI-1, Ajustement aux normes, etFeuille de routede séparer le marché public actuel des travaux de pont prévus.
- 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.
- 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.
- 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.
- 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.
- UtiliserUAI-1, Schémas, Registre, Exemples, Validateur, etImplémentationscomme plan de programme pratique pour l’adoption technique.
- UtiliserJournal des changements, Actualités, Références et contributeurs, etPresseen tant que couche de support de publication, de citation et destinée au public autour de cette carte.
Liste de contrôle d’évaluation rapide
- 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.
- 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.
- 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.
- 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.
- 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
- Commencez parUAI-1comprendre le modèle de message normatif actuel.
- LireSchémasetRegistreensemble afin que les règles de champ, les identifiants de profil et les poignées de compatibilité restent alignés.
- RevoirExempleset exécutez leValidateuravant de traiter une implémentation comme conforme.
- UtiliserImplémentationspour choisir la publication ou la piste d’exécution qui correspond à votre environnement.
Parcours développeur de cinq minutes
- OuvrirUAI-1et lisez les premières sections de démarcation pour savoir ce que couvre le marché public actuel.
- Choisissez-en un publiéExempleet résoudre sa correspondanceSchémaetRegistreentrée.
- Exécutez le même paquet via leValidateurvous disposez donc de preuves révisables au lieu d’une simple impression de prose.
- 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
- Choisissez un profil UAI-1 et confirmez pourquoi ce profil correspond à l’échange que vous souhaitez prendre en charge.
- 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é.
- Validez le message et enregistrez le résultat avant de le connecter à un chemin de version.
- 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.
- 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
- Le dossier normatif surUAI-1.
- Cibles de validation automatique surSchémas.
- Profil stable et références d’identifiant surRegistre.
- Appareils de travail surExemples.
- Preuve de validation duValidateur.
- Direction de déploiement à partir deImplémentations.
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 Use this decision table when you need to explain quickly why UAIX publishes UAI-1 beside MCP, A2A, and the live OpenAPI route surface. 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 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 These layers can handle local tool use, delegation, and execution flow without being treated as the public release record. Portable public layer UAI-1 keeps the exchange citable, reviewable, and validator-ready when it has to travel beyond one runtime boundary. Artefacts lisibles par machine These records turn the written contract into machine checks, fixtures, route lookups, and exportable conformance evidence. Release surface 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.When to use UAI-1 vs MCP, A2A, and OpenAPI
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.
How the launch surface fits together from runtime to release
MCP, A2A, orchestrators, SDKs
UAI-1 envelope, trust, provenance, delivery
Schemas, registry, examples, validator
Conformance pack, implementation tracks, release trail
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
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.jsonUtilisez 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 Use this runbook when the next goal is one validator-backed packet built only from the currently published public surface. Étape 1 Pull the current route inventory first so the rest of the proof run stays anchored to the published machine surface. Étape 2 Use one published request example as the first packet so your review starts from current public structure instead of local guesswork. Étape 3 Build one validator request body with the example packet nested under `message` and request the result record format. Étape 4 Submit the validation request to the live POST route and keep the returned result record with the exact packet that was checked. Étape 5 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 Move from proof into the named implementation lane, conformance pack, and release trail instead of claiming broader support than the site publishes. 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 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. Fits local Windows review and operational scripts without adding extra HTTP tooling. Useful when a team wants a portable script without depending on a published SDK yet. Good for browser or Node-based tooling that needs typed request handling around the live public routes.Get to one valid UAI-1 message in five minutes
Resolve the live catalog
Fetch one starter example
Wrap the message for validation
Run one validator check
Test the live reference response
Carry only the named next step
/wp-json/uaix/v1/catalog
Schéma
/wp-json/uaix/v1/schemas/uai.intent.request.v1
Exemple
/wp-json/uaix/v1/examples/uai.intent.request.v1
Valider
/wp-json/uaix/v1/validate
Kit d'adoption
/wp-json/uaix/v1/adoption-kit
Échange simulé
/wp-json/uaix/v1/mock-exchange
{
"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
}
]
}{
"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"
}{
"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
}
]
}
}Copyable starter requests in curl, PowerShell, Python, and TypeScript
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.jsoncurl -sS "https://uaix.org/wp-json/uaix/v1/catalog"curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.jsoncurl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
-H "Content-Type: application/json" \
-d @validate-request.jsoncurl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
-H "Content-Type: application/json" \
-d @mock-exchange-request.jsonInvoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/adoption-kit" | ConvertTo-Json -Depth 20 | Set-Content .\uai-adoption-kit.jsonInvoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/catalog"Invoke-RestMethod -Uri "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" | ConvertTo-Json -Depth 20 | Set-Content .\example-record.json$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ message = $message; format = "result" } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "https://uaix.org/wp-json/uaix/v1/validate" -ContentType "application/json" -Body $body$message = (Get-Content -Raw .\example-record.json | ConvertFrom-Json).message
$body = @{ scenario = "accepted-task"; format = "exchange"; message = $message } | ConvertTo-Json -Depth 20
Invoke-RestMethod -Method Post -Uri "https://uaix.org/wp-json/uaix/v1/mock-exchange" -ContentType "application/json" -Body $bodyimport json, urllib.request
kit = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/adoption-kit"))import json, urllib.request
catalog = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/catalog"))example_record = json.load(urllib.request.urlopen("https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1"))
message = example_record.get("message", example_record)payload = json.dumps({"message": message, "format": "result"}).encode("utf-8")
request = urllib.request.Request("https://uaix.org/wp-json/uaix/v1/validate", data=payload, headers={"Content-Type": "application/json"}, method="POST")
result = json.load(urllib.request.urlopen(request))payload = json.dumps({"scenario": "accepted-task", "format": "exchange", "message": message}).encode("utf-8")
request = urllib.request.Request("https://uaix.org/wp-json/uaix/v1/mock-exchange", data=payload, headers={"Content-Type": "application/json"}, method="POST")
exchange = json.load(urllib.request.urlopen(request))const kit = await fetch("https://uaix.org/wp-json/uaix/v1/adoption-kit").then((response) => response.json());const catalog = await fetch("https://uaix.org/wp-json/uaix/v1/catalog").then((response) => response.json());const exampleRecord = await fetch("https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1").then((response) => response.json());
const message = exampleRecord.message ?? exampleRecord;const result = await fetch("https://uaix.org/wp-json/uaix/v1/validate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ message, format: "result" }),
}).then((response) => response.json());const exchange = await fetch("https://uaix.org/wp-json/uaix/v1/mock-exchange", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ scenario: "accepted-task", format: "exchange", message }),
}).then((response) => response.json());
Premier succès minime
- Choisissez un profil publié et créez un message qui correspond à son objectif déclaré.
- Validez ce message par rapport au schéma publié et à l’enregistrement de registre.
- Comparez le message à un exemple d’appareil publié.
- Enregistrez le dossier de validation résultant dans le cadre de votre preuve de libération.
Première épreuve publique
- 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.
- 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.
- Exécutez leValidateur, exportez le résultat et conservez l’exemple exact ou le message candidat utilisé lors de la vérification.
- 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.
- 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.