Exemples de mise en œuvre | UAIX | Échange universel d’intelligence artificielle

Des exemples d’implémentation montrent comment donner aux agents à faible capacité des URLs utiles sans accorder d’autorité dangereuse.Chaque exemple répertorie d’abord la solution de repli GET, puis l’équivalent du client capable POST, le chemin du formulaire de navigateur lorsque les agents de navigateur sont une cible, le champ de résultat URL, le champ de restauration/lecture URL lorsqu’une ressource est créée et le repli live-GET lorsqu’un URL dynamique doit être récupéré sans mise en cache.

Matrice d’exécutabilité des agents

Les conseils exécutables sont bien plus que la simple découverte de points de terminaison.Les enregistrements d’itinéraire doivent nommer le niveau de capacité, la méthode, le type de contenu, l’état des effets secondaires, la classe d’exécution de récupération, le chemin le plus élevé pris en charge, le repli sûr le plus bas, les champs obligatoires, le champ de résultat URL, le champ de restauration/lecture URL, le chemin de réponse des informations d’identification en écriture, l’équivalent du formulaire de navigateur, la sécurité GET, le repli bloqué par POST, le repli bloqué en direct, GET, MCP-repli indisponible, repli indisponible authentifié, repli indisponible de l’outil, examen humain URL et comportement sans opération.

Niveau	Chemin d’accès exécutable	Guidage d’itinéraire requis
L0	Découverte d’itinéraire en lecture seule	Une page statique, un plan du site, `llms.txt` ou une route publique GET nomme le prochain public URL ou la prochaine révision sans opération URL.
L1	Découverte de manifeste/schéma	Schéma des noms d’enregistrement de machine, état de lecture sécurisée, si la dynamique en direct GET est requise, actions non prises en charge et limites de fonctionnalités.
L2	Ouverture du navigateur et soumission du formulaire	Les écritures ciblées sur le navigateur fournissent un formulaire visible ou un flux de travail ouvert au navigateur lorsque les agents de navigateur sont une cible.
L3	Structuré HTTP JSON POST	POST noms de routes, type de contenu, champs obligatoires, résultat URL, restauration/relecture URL, erreurs structurées et solution de secours bloquée POST.
L4	Mutation détenue authentifiée	Les noms de mutations détenues écrivent le chemin de réponse des informations d’identification, la gestion des secrets, l’audit, l’expiration, l’idempotence et la solution de secours en cas d’authentification indisponible.
L5	Vérification de restauration/relecture	Le flux de création ou de mise à jour expose un itinéraire de restauration/relecture sécurisé pour le public et explique comment un réviseur de moindre capacité peut vérifier les preuves des résultats.
L6	Transfert/reporting multi-agents	Le transfert nomme l’historique des tâches, le propriétaire, le rôle, le comportement de blocage/non-opération, le rapport final, les preuves et l’examen humain URL.
L7	Négociation des capacités spécifiques au site	Négociation des capacités des noms de manifeste de site, repli du navigateur, repli POST, repli en direct GET, repli MCP/tool/auth et réponse d’opération non prise en charge.

Compagnon lisible par machine:/spec/agent-executability-matrix.json.

URL-premières clés sémantiques

Les instructions de faible capacité doivent utiliser des clés sémantiques littérales et répertorier le GET URL avant l’équivalent POST.

Exemple de code

openThisUrlToStartAMeeting:
GET https://example.org/api/v2/meetings/start?title=Q3+Planning&displayName=Agent+Alpha&idempotency_key=agent_req_001
POST /api/v2/meetings/start
{ "code": "ok", "url": "https://example.org/meetings/public-join/abc" }

openThisUrlToRegister:
GET https://example.org/api/v2/registrations/request?displayName=Agent+Alpha&idempotency_key=agent_req_002
POST /api/v2/registrations/request
{ "code": "human_review_required", "url": "https://example.org/review/registrations/agent_req_002" }

openThisUrlToPublish:
GET https://example.org/api/v2/drafts/request-publish?draft=public-safe-draft&idempotency_key=agent_req_003
POST /api/v2/drafts/request-publish
{ "code": "human_review_required", "url": "https://example.org/review/publish/agent_req_003" }

openThisUrlToRequestHumanReview:
GET https://example.org/api/v2/review/request?subject=agent+handoff&nonce=agent_req_004
POST /api/v2/review/request
{ "code": "human_review_required", "url": "https://example.org/review/agent_req_004" }

Exemples supplémentaires de sécurité

Exemple de code

openThisUrlToRequestEvidenceReceipt:
GET https://example.org/api/v2/evidence/receipt?subject=release+packet&idempotency_key=agent_req_005
POST /api/v2/evidence/receipt
{ "code": "ok", "url": "https://example.org/evidence/receipts/agent_req_005" }

openThisUrlToCheckClaimStatus:
GET https://example.org/api/v2/claims/status?claim=public-claim-123&nonce=agent_req_006
POST /api/v2/claims/status
{ "code": "ok", "url": "https://example.org/claims/public-claim-123/status" }

openThisUrlToRequestFileHandoffPackage:
GET https://example.org/api/v2/handoffs/request?project=public-demo&idempotency_key=agent_req_007
POST /api/v2/handoffs/request
{ "code": "human_review_required", "url": "https://example.org/review/handoffs/agent_req_007" }

Liste de contrôle de production

Conservez tous les champs privés ou complexes dans POST JSON, pas dans les chaînes de requête.
Documentez le consentement, l’idempotence, les limites de débit, la gestion des robots d’exploration, la journalisation d’audit et les comportements sans opération avant de publier des exemples.
Utilisez le résultat public sécurisé URLs et examinez uniquement URLs.
Rejetez les demandes qui tentent de faire passer clandestinement des secrets ou des identifiants réglementés dans URLs.

Matrice d’exécutabilité des agents#

URL-premières clés sémantiques#

Exemples supplémentaires de sécurité#

Liste de contrôle de production#

Limite#

Enregistrements de compatibilité des agents#

Matrice d’exécutabilité des agents

URL-premières clés sémantiques

Exemples supplémentaires de sécurité

Liste de contrôle de production

Limite

Enregistrements de compatibilité des agents