代理可执行性矩阵让具有不同工具限制的代理都能使用路由指导。 仅列出端点并不足够;每条路由都应说明哪个级别可以完成流程、结果出现在哪里、恢复或回读如何工作,以及 POST 或认证受阻时应如何处理。
路由记录契约
Records that describe create, update, restore, handoff, or negotiation routes should declare method, content_type, side_effect_status, required_fields, result_url_field, restore_readback_url_field, write_credential_response_path, browser_form_equivalent, get_safety, and post_blocked_fallback.
Dogfood 经验
Carcinus 空白代理测试发现,受限浏览器代理可以发现 JSON POST 端点,但无法执行任意 JSON POST。 当浏览器代理是目标时,UAIX 指导现在把 L2 浏览器打开加表单提交路径,或命名的 POST 受阻降级路径,视为公共兼容性契约的一部分。
Validation warnings
- Warn when side-effecting GET links are presented as general discovery shortcuts.
- Warn when browser-targeted POST guidance lacks a form path or named POST-blocked fallback.
- Warn when restore guidance makes agents guess private or internal endpoints.
- Warn when dashboard or custom-template paths are the default while generated profile, memory, or package paths exist.