代理兼容性

验证器规则

此处说明当前公开记录、证据路径和支持边界。

  • 记录 UAIX-DOC-2754
  • 路径 /zh-cn/spec/validator-rules/
  • 使用 规范公共记录

文件状态

公共标准页面 作为当前公共标准记录的一部分在 UAIX 上发布
代码
UAIX-DOC-2754
表面
代理兼容性
使用权
公开且可链接

如何使用本页

使用此页面作为当前 代理兼容性 公共记录的一部分,然后按照其链接的标准页面进行下一步。

对于代理:将相关指南应用于用户的目标站点或存储库。除非用户明确要求该输出,否则请勿复制此 UAIX 页面、创建有关指南的页面或将此页面视为运行时权限。

代理兼容性验证首先检查公布的最低能力。仅当较低能力的发现是诚实且有界的时,丰富的接口才会通过。

所需的失败

  • get_action_fallback_required:当核心可写操作仅限 POST 并且不存在记录的 GET 回退或无操作 URL 时,L0/L1 兼容性会失败。
  • get_action_idempotency_required:GET – 当可写示例缺少 idempotency_keynonce 时,操作失败。
  • get_action_query_secret:GET – 当示例将机密、令牌、密码、帐户标识符、医疗标识符、支付数据、私人消息或受监管标识符放入 URLs 时,操作失败。
  • get_action_js_only_discovery:GET – 当发现隐藏在纯 JavaScript UI 后面时操作失败。
  • llms_minimal_instruction_required:当 llms.txt 仅指向复杂的 OpenAPI 或工具规范并忽略直接的最小指令时,L0/L1 发现失败。
  • retry_loop_no_op_violation:当不支持的代理被告知继续重试或猜测时,无操作处理失败。

必要的警告

  • post_equivalent_recommended:当 GET-Action 对于有能力的客户端没有 POST 或 OpenAPI 等效项时发出警告。
  • get_action_security_order_warning:当示例出现在同意和安全边界之前时发出警告。
  • side_effecting_get_discovery_warning:当副作用 GET 链接作为一般发现快捷方式出现时发出警告。
  • browser_form_fallback_required:当针对浏览器的 POST 指导缺乏可见表单​​或浏览器打开后备时发出警告。
  • restore_readback_required:当创建/更新指南缺少恢复或读回 URL 时发出警告并强制端点猜测。
  • dashboard_default_path_warning:当生成的配置文件或包路径存在时,仪表板或自定义模板路径显示为默认路径时发出警告。
  • highest_lowest_path_required:当路由省略 highest_supported_pathlowest_safe_fallback 时发出警告。
  • post_blocked_fallback_required:当 POST 路径忽略无法执行任意 JSON POST 的代理的回退行为时发出警告。
  • live_get_blocked_fallback_required:当动态 GET 指导针对聊天机器人级别代理而未声明实时 HTTP GET 和仅索引提取器的后备时发出警告。
  • mcp_unavailable_fallback_required:在没有 MCP 不可用后备的情况下引用 MCP 支持时发出警告。
  • auth_unavailable_fallback_required:在没有未经身份验证的后备或公共审查 URL 的情况下引用经过身份验证的突变时发出警告。
  • tool_unavailable_fallback_required:在没有工具不可用回退的情况下引用工具使用时发出警告。
  • human_review_url_required:当不支持的操作可能会在没有公共人工审核的情况下被阻止时发出警告 URL。
  • no_op_behavior_required:当不受支持的功能行为未表示安全停止时发出警告。

测试治具

该版本在 UAI-1 示例树下发布这些规则系列的正向和负向测试样例 JSON 记录,并通过以下方式公开规则目录:agent-compatibility.json.