Validateur

Ce que vérifie le validateur#

L'atelier de validation inspecte les messages candidats UAI par rapport aux schémas de profil publiés, aux enregistrements de gouvernance d'ordre de champ et aux attentes actuelles de la surface d'exploitation pour UAI-1.

• Alignement du schéma pour les six familles de messages publiées.
• Résolution de profils et d’identifiants basés sur le registre.
• Attentes de commande sur le terrain et de transport sans clé via le registre public de terrain.
• Vérifications du contexte de trace, de la livraison, du canal de confiance, de l'état des tâches asynchrones et du résumé de conformité qui vont au-delà de la pure structure JSON.
• Validation des échecs typés par rapport au registre d'erreurs publié et vérifications des déclarations de capacité par rapport aux liaisons de transport et aux niveaux de conformité publiés.
• Rapports de problèmes prévisibles en cas d'échec de la conformité ou de début de dérive.

Que signifie un résultat de conformité#

Un résultat de conformité est la preuve lisible par machine qu'un message candidat a été vérifié par rapport au dossier public actuel. Il est approprié pour l'examen, les étapes de validation, les contrôles de régression et les éléments probants d'audit. Il ne constitue pas un substitut à un paquet de version ou à une demande de support d'implémentation en soi.

Ce qu'un résultat passager fait et ne vous permet pas de prétendre#

• Prise en charge:une affirmation selon laquelle le message examiné correspondait au dossier public publié au moment de la validation.
• Ne prend pas en charge:une demande de certification, d'approbation du partenaire, de compatibilité permanente ou de prise en charge générale de l'exécution au-delà du dossier d'implémentation ci-joint.
• Il en faut plus avant le soutien public:un paquet de version, un historique de mise en œuvre, une entrée de piste de version et le niveau de conformité publié approprié pour la réclamation que vous souhaitez faire.

Comment les équipes doivent utiliser le validateur avant le déploiement#

1. Charger une publicationExempleou collez un message de candidat.
2. Confirmez que le message est résolu comme prévuRegistreprofil, le pertinentordre des champs, et le schéma correspondant.
3. Lorsque le transport, la confiance ou le comportement des erreurs sont importants, transférez les liaisons de transport publiées, les canaux de confiance, le registre des erreurs et les niveaux de conformité avec le même paquet de révision.
4. Examinez l’enregistrement des résultats générés, puis conservez cet enregistrement de conformité avec les preuves de version d’implémentation.
5. Utilisez le résultat pour décider si l'étape suivante appartient àImplémentations.

Surfaces de validation en direct en béton#

• Établi face à l'homme:utilisez cette page pour le chargement des appareils, la révision côte à côte et les enregistrements de conformité téléchargeables.
• Itinéraire de validation face à la machine: /wp-json/uaix/v1/validateaccepte les demandes JSON POST pour les pipelines d'automatisation et de publication.
• Prise en charge des itinéraires d'enregistrement lisibles par machine: /wp-json/uaix/v1/catalog, /wp-json/uaix/v1/schemas, /wp-json/uaix/v1/registry, /wp-json/uaix/v1/field-registry, et/wp-json/uaix/v1/examplesexposer le catalogue principal, le schéma, le registre, l'ordre des champs et l'inventaire des appareils utilisés lors de la validation.
• Itinéraires de guidage opérationnels: /wp-json/uaix/v1/transport-bindings, /wp-json/uaix/v1/trust-channels, /wp-json/uaix/v1/conformance-levels, et/wp-json/uaix/v1/error-registryexposer les conseils en matière de transport, de confiance, de demande de support et de gestion des échecs auxquels le validateur fait désormais référence.

Comment la preuve de conformité devient un enregistrement public#

• Attachez les résultats de conformité exportés à l’implémentation ou à la version du package concerné plutôt que de les laisser sous forme de contrôles locaux privés.
• Utilisez leJournal des changementslorsque les changements de schéma, de profil, d’ordre des champs, de transport, de confiance ou de comportement du validateur affectent les attentes en matière de migration.
• UtiliserActualitéslorsqu'une version réussie ou défaillante nécessite un résumé public.
• UtiliserRéférences et contributeurslorsque la version a besoin de liens de découverte et de citation stables autour de sa preuve de conformité.

Interprétation des résultats de validation#

• Passer:le message soumis correspondait au profil public, au schéma, au registre et à la politique actuelle du validateur au moment de la vérification enregistrée.
• Avertissement:le message peut être structurellement utilisable mais comporte des dérives, des preuves manquantes, une faible position de confiance ou un contexte de révision qui doivent être résolus avant que le langage de support ne se développe.
• Échouer:le message ne doit pas être utilisé comme preuve de publication jusqu'à ce que les problèmes de profil, de schéma, d'ordre de champ, de confiance, de trace, de livraison ou de corps répertoriés soient corrigés et réexécutés.
• Déclencheur de réexécution:réexécutez lorsque l'enregistrement public, le comportement du validateur, la version d'implémentation, la position de l'itinéraire ou la revendication de support changent.

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

Le validateur ci-dessous se base désormais sur une couche opérationnelle publiée plus large, et pas seulement sur les schémas et les accessoires.

Runbook de paquets de preuve#

Utilisez le runbook publié ci-dessous lorsqu'un message candidat doit devenir une preuve de version réutilisable au lieu de rester une vérification de validateur locale unique.

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

Établi du validateur#

Utilisez l'atelier public ci-dessous pour charger un appareil publié ou valider un message candidat UAI par rapport à la version actuelle, puis téléchargez l'enregistrement de conformité résultant lorsque vous avez besoin d'un rapport durable lisible par machine.

Run the validator to generate a conformance record.

Run the mock exchange to capture a deterministic response envelope.

Étape suivante#

Continuez àImplémentationsune fois le message du candidat passé. Utilisez leWordPress Piste de publicationpour la publication et l'emballage, ou lePiste de pont.NETpour une intégration plus approfondie du runtime, puis enregistrez les modifications apportées à la version via leJournal des changementsetActualités.