Outils

Outils

Validateur, découverte, registre des champs et outils de révision qui aident les équipes à tester et adopter UAI-1.

  • Dossier UAIX-TOOL-0060
  • Chemin /fr-fr/tools/
  • Utilisation Dossier public canonique

Statut du document

Page des normes publiques Publié le UAIX dans le cadre du dossier actuel des normes publiques
Code
UAIX-TOOL-0060
Surface
Outils
Accès
Public et accessible par lien

Comment utiliser cette page

Utilisez cette page pour trouver le validateur et d'autres outils de support pour l'inspection, la découverte et l'adoption.

Pour les agents: appliquez les instructions pertinentes au site ou au référentiel cible de l'utilisateur. Ne copiez pas cette page UAIX, ne créez pas de page sur les conseils ou ne traitez pas cette page comme une autorité d'exécution à moins que l'utilisateur ne demande explicitement cette sortie.

Outillage

Les outils UAIX prennent en charge la validation, l’inspection, la gouvernance des commandes sur le terrain, l’examen du transport et de la confiance, les tests de montage, la découverte lisible par machine et l’intégration de la mise en œuvre pour UAI-1.

Quels outils devraient aider

  • Résolvez le dossier public actuel sans supprimer le texte de la page.
  • Inspectez les cibles de schéma, les ID de profil, l’ordre des champs, les appareils, les liaisons de transport, les canaux de confiance, les codes d’erreur et les attentes de conformité avant la publication.
  • Dérive structurelle, erreurs de flux de travail asynchrones, problèmes de contexte de trace et lacunes en matière de politique de confiance avant que les utilisateurs en aval n’en dépendent.
  • Exportez les résultats de conformité sous forme d’enregistrements révisables pouvant être intégrés aux notes de version, aux journaux CI ou aux preuves d’audit.

Chemin d’outillage principal

La plupart des lecteurs devraient commencer par leValidateur, puis revenez àExemplesou transférer versImplémentationsselon que le prochain besoin est le débogage ou la publication de preuves.

WordPress surface de gestion de la mémoire

UAI Gestion de la mémoireest le package d’administration UAIX.org WordPress pour conserver la mémoire .uai active, les fichiers Advanced Persona, les surfaces de mémoire docs/ et wiki/ existantes, les invites de mise à jour protégées et les exportations de Project Handoff alignées. Utilisez-le lorsqu’un site WordPress a besoin que des humains et des agents voient la mémoire obsolète, surdimensionnée, dupliquée ou manquante avant que cette dérive ne pollue le contexte futur.

Surface de nourriture expérimentale pour chiens

UAIX Protocole des agentsreste l’ancien enregistrement dogfood pour la même lignée de plugins, les vérifications en amont ZIP, le refus d’échec de validation, le nettoyage et les preuves de fumée d’activation. Traitez cet itinéraire comme une preuve historique; utilisez UAI Memory Management pour la surface actuelle du plug-in d’administration public.

Chemin de conformité Hello-World

  1. Choisissez-en un publiéExempleou préparez un message de candidat lié à un profil public connu.
  2. Résolvez les enregistrements de schéma, de registre, d’ordre de champ, de transport, de confiance et d’erreur correspondants avant d’exécuter la vérification afin qu’un autre réviseur puisse reproduire le même paquet.
  3. Exécutez leValidateuret exportez le résultat sous forme d’enregistrement révisable.
  4. Portez ce résultat dansImplémentations, leJournal des changements, Actualités, etRéférences et contributeurslorsque le chèque soutient une divulgation publique ou une demande de soutien.
  5. Répétez l’exécution chaque fois que les schémas, les mappages de registre, l’ordre des champs, les instructions de transport, les codes d’erreur, le comportement du validateur ou les mappages d’exécution changent.

Chemin de démarrage publié

Utilisez l’exécution de la preuve publique et les appels clients ci-dessous lorsque la tâche suivante consiste à intégrer un outil, un script ou un flux d’assurance qualité sur la surface publique en direct sans aides privées.

Chemin de preuve

How the first proof packet should move through validation

Use this flow when a candidate message needs to become exportable evidence instead of staying a local test.

Étape 1

Resolve the live catalog

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

Étape 2

Fetch one starter example

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

Étape 3

Wrap the message for validation

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

Étape 4

Run one validator check

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

Étape 5

Test the live reference response

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

Étape 6

Carry only the named next step

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

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

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

Client examples

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

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

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

curl

Plain shell

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

Kit d'adoption Fetch the published onboarding bundle uai-adoption-kit.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/adoption-kit" -o uai-adoption-kit.json
Catalogue Resolve the live route catalog
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/catalog"
Exemple Fetch one published starter packet example-record.json
Exemple de code
curl -sS "https://uaix.org/wp-json/uaix/v1/examples/uai.intent.request.v1" -o example-record.json
Valider Submit the packet for a result record validate-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/validate" \
  -H "Content-Type: application/json" \
  -d @validate-request.json
Échange simulé Request one live conforming response mock-exchange-request.json
Exemple de code
curl -sS -X POST "https://uaix.org/wp-json/uaix/v1/mock-exchange" \
  -H "Content-Type: application/json" \
  -d @mock-exchange-request.json

Surfaces de découverte et de plan de site

L’automatisation et le contrôle qualité public devraient être capables de résoudre le même inventaire de pages à la fois à partir de la surface de découverte racine et de l’espace de routage préfixé par les paramètres régionaux.

  • Utiliser/.well-known/uaix.jsoncomme manifeste lisible par machine préféré.
  • Utiliser/sitemap.xmlet/sitemap.htmlcomme les surfaces d’exploration et de répertoire racine durables.
  • Utiliser/en-us/sitemap.xmlet/en-us/sitemap.htmllorsque les lecteurs ou les outils localisés ont besoin du même inventaire via l’espace de routage anglais.
  • Traitez les fichiers de plan de site racine comme la surface de référencement publique canonique, même lorsque les itinéraires de plan de site préfixés par les paramètres régionaux sont également en ligne et testés.

Itinéraires actuels face à la machine

La surface d’outils publics comprend une page de validation destinée aux humains ainsi que des itinéraires REST orientés machine pour l’automatisation et les contrôles de version.

Référence API et surfaces de pack réutilisables

  • Assistant de paquet de mémoire IAguide un bundle de démarrage pris en charge dans un modèle de package, un profil système rempli, un paquet de fichiers copier-coller, un brief du récepteur, un paquet de démarrage, une superposition de manifeste, un registre de pointeurs sémantiques à long terme requis pour la configuration de la mémoire durable, les métadonnées de préparation et le téléchargement ZIP canonique sans revendiquer la génération générale hébergée, les écritures automatiques du référentiel ou la synchronisation automatique du wiki.
  • Référence APItransforme la surface REST en direct en un manuel itinéraire par itinéraire avec un document OpenAPI 3.1 publié et des exemples de demandes de démarrage.
  • Kit d’adoptionpublie le premier package d’intégration à l’épreuve avec des fichiers de démarrage, des charges utiles prêtes pour le validateur et des exemples d’échange simulé.
  • Paquet de conformitérassemble les schémas plus larges, les données de registre, les appareils, les conseils de transport et de confiance, ainsi que les points d’entrée du validateur dans un paquet réutilisable lisible par machine.
  • /wp-json/uaix/v1/adoption-kitest l’ensemble d’intégration orienté machine pour la première exécution réutilisable la plus courte; ajoutez ?download=1 lorsque vous souhaitez la même réponse en pièce jointe.
  • /wp-json/uaix/v1/openapi.jsonest l’exportation OpenAPI face à la machine pour la surface UAIX REST en direct.
  • /wp-json/uaix/v1/conformance-packest le paquet JSON orienté machine pour la révision du lancement et le travail de conformité reproductible; ajoutez ?download=1 lorsque vous souhaitez la même réponse en pièce jointe.
  • /wp-json/uaix/v1/roadmapest l’enregistrement du plan prévisionnel face à la machine pour les travaux en cours, à venir, planifiés et en cours de recherche; ajoutez ?download=1 lorsque vous souhaitez la même réponse en pièce jointe.

Références publiées sur les surfaces opérationnelles

Les enregistrements ci-dessous font partie de la surface du protocole en direct lisible par machine et doivent être accompagnés d’un schéma et d’un exemple de résolution lorsque vous évaluez l’interopérabilité ou les demandes de support.

Operating surface

Transport, trust, errors, and conformance

These records make the UAI-1 operating layer explicit instead of leaving transport binding, trust posture, typed failure semantics, or support claims to private convention.

Transport

Published bindings

Default
https-json-envelope.v1
Bindings
2
  • https-json-envelope.v1: application/vnd.uaix.uai+json
  • https-json-keyless.v1: application/vnd.uaix.uai-keyless+json

Trust

Published trust channels

  • public-web: Enregistrements lisibles publiquement sur HTTPS sans configuration de confiance bilatérale préalable.
  • private-api: Échange de service à service sur un réseau étendu ou une limite de locataire.
  • mtls: Échange authentifié par transport où l’identité des homologues est ancrée au niveau de la couche de connexion.
  • signed-envelope: Une signature au niveau du message ou une référence de signature détachée accompagne l'enregistrement.
  • credentialed: L'expéditeur ou le contexte d'exécution est soutenu par un identifiant vérifiable par machine ou une assertion d'identité signée comparable.

Conformance

Published level ladder

  • L1-core-envelope: Enveloppe de base L1
  • L2-profile-validation: Validation du profil L2
  • L3-trust-and-integrity: Confiance et intégrité L3
  • L4-public-record-publisher: Éditeur de disques publics L4
  • L5-agent-communication-profiles: Profils de communication des agents L5
  • L6-reliable-delegation-idempotency-correlation: Délégation fiable L6 avec idempotence et corrélation
  • L7-capability-negotiation: Négociation des capacités L7

Errors

Published message error codes

  • invalid_message: Message invalide
  • unknown_profile: Profil inconnu
  • capability_not_supported: Capacité non prise en charge
  • auth_required: Authentification requise
  • insufficient_trust: Confiance insuffisante
  • task_not_found: Tâche introuvable

Surface de découverte

L’automatisation doit commencer avec le manifeste de découverte et le catalogue de normes UAIX actuels.

Découverte

Machine-readable standards discovery

UAIX publishes a durable manifest so implementers, validators, and downstream tools can discover the current UAI-1 surfaces, including the adoption-kit bundle and live reference exchange route, without scraping the public pages.

Discovery manifest

Well-known entry points

Use the `.well-known` manifest for durable site discovery, or the REST discovery route when you want the same data from the API surface. Production deployments should publish the same manifest from the canonical HTTPS origin.

Release
UAI-1
Profiles
61
Generated
2026-07-25T23:35:35+00:00

Public routes

Current machine-facing surface

The manifest advertises the API and public publication paths that make up the current UAIX standards surface.

  • Catalogue: /wp-json/uaix/v1/catalog
  • Schémas: /wp-json/uaix/v1/schemas
  • Registre: /wp-json/uaix/v1/registry
  • Registre des champs: /wp-json/uaix/v1/field-registry
  • Fixations de transport: /wp-json/uaix/v1/transport-bindings
  • Canaux de confiance: /wp-json/uaix/v1/trust-channels
  • Niveaux de conformité: /wp-json/uaix/v1/conformance-levels
  • Registre des erreurs: /wp-json/uaix/v1/error-registry
  • Exemples: /wp-json/uaix/v1/examples
  • Valider: /wp-json/uaix/v1/validate (POST JSON)
  • Kit d'adoption: /wp-json/uaix/v1/adoption-kit
  • Échange simulé: /wp-json/uaix/v1/mock-exchange (GET metadata, POST message)

Étape suivante

Commencez par leValidateur, puis transférez les preuves obtenues dansImplémentations, leJournal des changements, etActualitéslorsque le résultat affecte une diffusion publique.