GET-Action est une première solution de secours URL pour les actions explicitement répertoriées, délimitées et idempotentes.Il existe pour les agents L1 qui peuvent synthétiser un URL mais ne peuvent pas envoyer en toute sécurité POST JSON.
Forme d'itinéraire standard
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-keyForme de réponse
Les réponses d'action GET à faible capacité utilisent exactement deux clés: code et url. Les codes acceptés sont ok, human_review_required et rejected.
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }Appairage requis
Chaque GET-Action qui peut changer d'état doit publier un équivalent POST pour les clients L2 et supérieurs. POST possède des charges utiles riches, une authentification, une validation, des champs privés et des détails d'erreur complexes.
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.
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" }Pas un raccourci
GET-Action ne doit pas remplacer POST, contourner le consentement, contenir des secrets, effectuer un travail destructeur, publier sans examen, écrire des référentiels sans examen ou transformer le trafic des robots en exécution.
Propositions d’architecture
UAI-1 v1.0 reste le contrat actuellement publié. Des propositions versionnées séparément décrivent les échanges indépendants, les capacités, la reprise et la préservation des sources.
Il s’agit de propositions et d’exemples de référence locaux ; aucun service d’exécution hébergé ni résultat d’interopérabilité indépendante n’est revendiqué.
La proposition anglaise fait foi pour l’interprétation normative. Ce résumé ne constitue pas une traduction normative validée.
Lire les propositions d’architecture en anglais · Catalogue des propositions lisible par machine