Compatibilidad de agentes

Reglas del validador

Fallos y advertencias del validador de compatibilidad del agente para GET-Reserva de acciones, idempotencia, secretos de consulta, descubrimiento solo de JavaScript, reservas de POST/live GET/MCP/auth/tool, revisión humana y comportamiento no operativo.

  • Registro UAIX-DOC-2754
  • Ruta /es-es/spec/validator-rules/
  • Uso Registro público canónico

Estado del documento

Página de estándares públicos Publicado el UAIX como parte del registro de estándares públicos actuales
Código
UAIX-DOC-2754
Superficie
Compatibilidad de agentes
Acceso
Público y enlazable

Cómo usar esta página

Utilice esta página como parte del registro público Compatibilidad de agentes actual y luego siga las páginas de estándares vinculadas para el siguiente paso.

Para agentes: aplique la guía relevante al sitio o repositorio de destino del usuario. No copie esta página UAIX, no cree una página sobre la guía ni trate esta página como autoridad de tiempo de ejecución a menos que el usuario solicite explícitamente ese resultado.

La validación de compatibilidad del agente comprueba primero la capacidad anunciada más baja.Las interfaces enriquecidas sólo pasan cuando el descubrimiento de menor capacidad es honesto y limitado.

Fallos requeridos

  • get_action_fallback_required: La compatibilidad L0/L1 falla cuando una acción de escritura principal es solo POST y no existe ningún respaldo GET documentado o URL no operativo.
  • get_action_idempotency_required: GET: la acción falla cuando un ejemplo con capacidad de escritura carece de idempotency_key o nonce.
  • get_action_query_secret: GET: la acción falla cuando los ejemplos colocan secretos, tokens, contraseñas, identificadores de cuenta, identificadores médicos, datos de pago, mensajes privados o identificadores regulados en URLs.
  • get_action_js_only_discovery: GET: la acción falla cuando el descubrimiento está oculto detrás de la interfaz de usuario solo de JavaScript.
  • llms_minimal_instruction_required: El descubrimiento L0/L1 falla cuando llms.txt apunta solo a OpenAPI complejas o especificaciones de herramientas y omite instrucciones mínimas directas.
  • retry_loop_no_op_violation: el manejo no operativo falla cuando a los agentes no admitidos se les dice que sigan intentando o adivinando.

Advertencias requeridas

  • post_equivalent_recommended: advierte cuando una acción GET no tiene equivalente POST o OpenAPI para clientes capaces.
  • get_action_security_order_warning: advierte cuando aparecen ejemplos antes de los límites de consentimiento y seguridad.
  • side_effecting_get_discovery_warning: advierte cuando los enlaces GET con efectos secundarios se presentan como accesos directos de descubrimiento general.
  • browser_form_fallback_required: advierte cuando la guía POST dirigida al navegador carece de un formulario visible o de respaldo para abrir el navegador.
  • restore_readback_required: advierte cuando la guía de creación/actualización carece de restauración o lectura URL y fuerza la adivinación del punto final.
  • dashboard_default_path_warning: advierte cuando las rutas del panel o de la plantilla personalizada se presentan de forma predeterminada mientras existen rutas de paquete o perfil generado.
  • highest_lowest_path_required: avisa cuando una ruta omite highest_supported_path o lowest_safe_fallback.
  • post_blocked_fallback_required: advierte cuando una ruta POST omite el comportamiento alternativo para agentes que no pueden ejecutar JSON POST arbitrario.
  • live_get_blocked_fallback_required: advierte cuando la guía dinámica GET se dirige a agentes de nivel de chatbot sin declarar HTTP GET en vivo y un respaldo para los buscadores solo indexados.
  • mcp_unavailable_fallback_required: advierte cuando se hace referencia al soporte MCP sin un respaldo MCP no disponible.
  • auth_unavailable_fallback_required: advierte cuando se hace referencia a una mutación autenticada sin una reserva no autenticada o una revisión pública URL.
  • tool_unavailable_fallback_required: advierte cuando se hace referencia al uso de herramientas sin un respaldo de herramienta no disponible.
  • human_review_url_required: advierte cuando una acción no admitida puede bloquearse sin una revisión humana pública URL.
  • no_op_behavior_required: advierte cuando el comportamiento de capacidad no compatible no indica que se detenga de forma segura.

Accesorios de prueba

El lanzamiento publica registros fijos positivos y negativos JSON para estas familias de reglas en el árbol de ejemplos UAI-1 y expone el catálogo de reglas a través deagent-compatibility.json.