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
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.