GET-Action 是显式列出的、有界的、幂等操作的 URL-first 后备。它适用于可以合成 URL 但无法安全发送 POST JSON 的 L1 代理。
标准路线形状
GET /api/{version}/{resource}/{action}?public_param=value&idempotency_key=stable-key响应形状
低能力 GET - 操作响应仅使用两个键：code 和 url。接受的代码为 ok、human_review_required 和 rejected。
{ "code": "ok", "url": "https://example.org/public/result/agent_req_001" }所需配对
每个可以更改状态的 GET-Action 都应该为 L2 及更高版本的客户端发布等效的 POST 。 POST 拥有丰富的有效负载、身份验证、验证、私有字段和复杂的错误详细信息。
URL-第一个语义键
低功能指令应使用文字语义键，并在 POST 等效项之前列出 GET URL 。
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" }不是捷径
GET - 操作不得取代 POST、绕过同意、携带秘密、执行破坏性工作、未经审查而发布、未经审查而写入存储库或将爬虫程序流量转化为执行。
架构提案
UAI-1 v1.0 仍是当前发布的契约。独立版本的提案涵盖独立交换、能力声明、故障恢复和源记录保留。
这些内容是提议的设计和本地参考示例，并不声称提供托管运行时服务或已验证独立互操作性。
规范解释以英文提案为源文；此界面摘要不代表已审定的规范译文。