GET-Action es una URL-primera alternativa para acciones idempotentes, limitadas y enumeradas explícitamente.Existe para agentes L1 que pueden sintetizar un URL pero no pueden enviar de forma segura POST JSON.
Forma de ruta estándar
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-keyForma de respuesta
Las respuestas de acción GET de baja capacidad utilizan exactamente dos claves: code y url. Los códigos aceptados son ok, human_review_required y rejected.
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }Emparejamiento requerido
Cada GET-Action que pueda cambiar de estado debe publicar un equivalente POST para clientes L2 y superiores. POST posee cargas útiles ricas, autenticación, validación, campos privados y detalles de errores complejos.
URL-primeras claves semánticas
Las instrucciones de baja capacidad deben usar claves semánticas literales y enumerar el GET URL antes del equivalente 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" }No es un atajo
GET-La acción no debe reemplazar a POST, eludir el consentimiento, contener secretos, realizar trabajos destructivos, publicar sin revisión, escribir repositorios sin revisión ni convertir el tráfico del rastreador en ejecución.
Propuestas de arquitectura
UAI-1 v1.0 sigue siendo el contrato publicado actual. Las propuestas con versiones independientes describen intercambios, capacidades, recuperación y conservación de las fuentes.
Son diseños propuestos y ejemplos de referencia locales; no se afirma que existan servicios de ejecución alojados ni interoperabilidad independiente verificada.
La propuesta inglesa es la fuente para la interpretación normativa. Este resumen no constituye una traducción normativa revisada.
Leer las propuestas de arquitectura en inglés · Catálogo de propuestas legible por máquina