Démarrer

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.

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.

• 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#

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#

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

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

{
    "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": "/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
        }
    ]
}

curl -sS /wp-json/uaix/v1/catalog

const catalog = await fetch('/wp-json/uaix/v1/catalog').then((response) => response.json());

$catalog = json_decode(file_get_contents('/wp-json/uaix/v1/catalog'), true, 512, JSON_THROW_ON_ERROR);

catalog = requests.get('/wp-json/uaix/v1/catalog', timeout=10).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.

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.