Outils

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.

{
    "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()

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.

• /wp-json/uaix/v1/cataloget/wp-json/uaix/v1/discoveryexposer le catalogue de normes et le manifeste de découverte actuels.
• /wp-json/uaix/v1/statuset/wp-json/uaix/v1/modulesexposer l’état d’exécution et l’inventaire des modules.
• /wp-json/uaix/v1/schemas, /wp-json/uaix/v1/registry, /wp-json/uaix/v1/field-registry, et/wp-json/uaix/v1/examplesexposer les familles d’enregistrements lisibles par machine publiées.
• /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 directives opérationnelles qui rendent explicites le transport, la confiance, les demandes de support et la gestion des pannes.
• /wp-json/uaix/v1/validateest le point de terminaison de validation JSON POST pour l'automatisation; utiliser leValidateurpage lorsqu'un humain a besoin de l'expérience Workbench.
• /wp-json/uaix/v1/roadmapexpose les limites du plan prospectif pour les travaux en cours, à venir, planifiés et en cours de recherche.

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.

Surface de découverte#

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

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