Reglas Avanzadas

Reglas Avanzadas son un conjunto de pruebas automatizadas de accesibilidad que utilizan capturas de pantalla, visión por computadora y modelos de lenguaje avanzados para detectar problemas que el estándar axe-core no puede — tales como encabezados que solo parecen encabezados, imágenes informativas con texto alternativo poco útil y contraste de texto sobre degradados o imágenes.

La herramienta analyze puede ejecutar las Reglas Avanzadas junto con el conjunto de reglas estándar de axe-core. Cuando lo hace, los hallazgos avanzados se fusionan en el mismo arreglo de resultados que ya consume su agente, por lo que no se requiere ningún cambio en sus indicaciones o flujo de trabajo.

Las Reglas Avanzadas están reguladas por la Configuración de Axe de su organización, y — donde lo permita su administrador — pueden ser anuladas por servidor o por escaneo.

Valores preestablecidos aceptados

Las Reglas Avanzadas que usan IA informan una puntuación de confianza en lugar de un pase o fallo definitivo, y un preajuste establece el umbral en o por encima del cual se informa un hallazgo. Para saber qué significa cada preajuste y cómo elegir entre ellos, vea Controles de Confianza — los umbrales son idénticos en cada producto que ejecuta Reglas Avanzadas.

En cualquier lugar donde el Servidor Axe MCP acepte un preajuste — ya sea el argumento de la herramienta advancedRules o la variable de entorno AXE_ADVANCED_RULES — estos son los valores que reconoce:

Los valores no distinguen entre mayúsculas y minúsculas, y los espacios circundantes se ignoran, por lo que " Balanced " y "BALANCED" ambos se resuelven a balanced. No hay alias porcentual para disabled.

Elegir un preajuste

Hay tres formas de establecer el preajuste. Cuando hay más de uno presente, gana el de mayor precedencia:

1. El argumento de la herramienta advancedRules — por escaneo
2. La variable de entorno AXE_ADVANCED_RULES — por servidor
3. Predeterminado de Configuración de Axe de su organización — por organización

Cualquiera que sea la fuente utilizada, el valor resuelto se informa de vuelta en la bloque advancedRules de la respuesta, para que su agente siempre pueda ver qué preajuste se ejecutó realmente.

Predeterminado de la Organización

El predeterminado de su organización proviene de la configuración Reglas Avanzadas Predeterminadas en Configuración de Axe, que un administrador gestiona en el Portal de Cuentas Axe. Esa página documenta las opciones disponibles y la casilla de verificación “Permitir a los usuarios cambiar” que decide si se permiten las dos anulaciones a continuación.

Dos cosas específicas del Servidor Axe MCP:

• El servidor lee la Configuración de Axe en cada llamada cada analyze, por lo que un cambio que haga su administrador entra en vigor en su próximo escaneo — no es necesario reiniciar el servidor o el cliente.
• Si la configuración está bloqueada, la variable de entorno y el argumento de la herramienta se ignoran silenciosamente y la respuesta informa "source": "org_policy_locked", para que pueda saber que una anulación fue descartada en lugar de aplicada.

variable de entorno AXE_ADVANCED_RULES

Establezca AXE_ADVANCED_RULES en la configuración de su servidor MCP para elegir un preajuste para cada escaneo que realice ese servidor. Este es el lugar adecuado para una elección a nivel de equipo o proyecto, que no debería repetirse en cada indicación.

{
  "servers": {
    "axe-mcp-server": {
      "command": "npx",
      "args": ["-y", "axe-mcp-server"],
      "env": {
        "AXE_ACCESS_TOKEN": "<your-token>",
        "AXE_ADVANCED_RULES": "thorough"
      }
    }
  }
}

Consulte la Referencia de Configuración para más detalles, y su guía de configuración del cliente para ver dónde vive el bloque env en su cliente.

Invalid Advanced Rules value: "high". Expected one of: 'precise' (90%), 'balanced' (70%), 'thorough' (50%), 'disabled'.

argumento de la herramienta advancedRules

Pase advancedRules a una llamada única analyze para anular el preajuste solo para ese escaneo. Indique a su agente de IA en lenguaje natural — el agente traduce su intención en la llamada de la herramienta:

Analyze http://localhost:3000 for accessibility issues using the
thorough advanced rules preset

El agente llama a la herramienta analyze con una carga similar a:

{
  "url": "http://localhost:3000",
  "advancedRules": "thorough"
}

Un valor inválido aquí es un error de validación de esquema por llamada que nombra los valores aceptados; no afecta al servidor ni a llamadas posteriores.

Utiliza el argumento de la herramienta cuando desees una desviación puntual, por ejemplo, thorough en una página que estás auditando activamente, o disabled en una página grande donde solo quieres resultados estándar rápidos:

Analyze http://localhost:3000 with advanced rules disabled

El bloque de respuesta advancedRules

Cada respuesta de analyze incluye un bloque de advancedRules que informa sobre el preajuste que realmente se ejecutó y de dónde provino:

{
  "pageUrl": "http://localhost:3000",
  "data": [],
  "advancedRules": {
    "value": "balanced",
    "source": "org_default"
  }
}

value siempre es uno de los cuatro preajustes. source explica cómo se alcanzó ese valor:

Comportamiento de falla-cerrada

El Servidor MCP de Axe nunca adivina un preajuste. Si la Configuración de Axe es accesible pero falta la configuración de Reglas Avanzadas, o tiene un valor que esta versión del servidor no reconoce, el escaneo informa "value": "disabled", "source": "unavailable" y ejecuta solo el núcleo estándar de axe — no no recurre a un preajuste codificado. Esto evita que un desnivel de versión entre tu servidor y el Portal de Cuentas de Axe aplique silenciosamente un umbral que nadie eligió.

Si la Configuración de Axe no se puede recuperar en absoluto (fallo de red, credenciales inválidas), la llamada analyze falla por completo en lugar de escanear con configuraciones desconocidas. Ese es el comportamiento existente para todas las configuraciones, no específico de las Reglas Avanzadas — ver Errores de autenticación.

Cuando las Reglas Avanzadas no se ejecutan

Un valor efectivo de disabled significa que las Reglas Avanzadas no están realmente cargadas en el escaneo: no se captura ninguna captura de pantalla para ellas, nada se envía a Deque para evaluación, y no se consumen créditos de IA. Los resultados estándar de axe-core se devuelven exactamente como lo harían de otro modo.

Si solicitaste un preajuste que no pudo ser honrado porque las Reglas Avanzadas no están disponibles para tu servidor, el arreglo messages de la respuesta lo indica:

Advanced Rules are not enabled for this server; the scan used standard axe-core only.

No se emite ningún mensaje cuando no solicitaste nada — un defecto organizacional de disabled es una elección deliberada, no un problema a reportar.

Degradación parcial

Las Reglas Avanzadas nunca fallan un escaneo. Si las reglas se cargan pero su evaluación del lado del servidor encuentra problemas, analyze devuelve tus resultados estándar de axe-core más un mensaje describiendo lo que se perdió:

Disponibilidad

El Servidor MCP de Axe está incluido en el paquete Axe DevTools para Web, y las Reglas Avanzadas vienen con él. Si tienes acceso al Servidor MCP de Axe, tienes Reglas Avanzadas — no hay que hacer una compra separada de Reglas Avanzadas.

Una cosa todavía puede dejarlas no disponibles: las Reglas Avanzadas se evalúan del lado del servidor, por lo que tu implementación debe estar conectada a la infraestructura de IA de Deque. Las implementaciones en la nube privada y en las instalaciones necesitan los servicios de ML y LLM — consulta el Guía de Disponibilidad de Funciones de IA. Los clientes SaaS están conectados desde el principio.

Si los escaneos informan "source": "unavailable" y esperas que las Reglas Avanzadas estén disponibles, contacta a tu Gerente de Éxito del Cliente. La disponibilidad se resuelve cuando el servidor se inicia, por lo que reinicia el servidor MCP (o tu cliente MCP) después de un cambio de suscripción en lugar de esperar que el próximo escaneo lo recoja.

Qué se envía a Deque

Las Reglas Avanzadas son el único caso donde analyze envía datos de la página a los servidores de Deque. Cuando se resuelve un preajuste activo, el escaneo:

1. Captura una captura de pantalla de página completa en el navegador y la carga al punto de captura de pantalla de Deque.
2. Envía la carga útil de evaluación del grabador — la estructura de la página, los estilos calculados y la geometría que necesitan las reglas avanzadas — al punto de reglas avanzadas de Deque, donde los modelos de ML y LLM la evalúan.
3. Fusiona los hallazgos devueltos en tus resultados.

El escaneo estándar de axe-core no se ve afectado: con las Reglas Avanzadas disabled, la herramienta analyze no envía nada a Deque más allá de las solicitudes de autenticación y configuración.

Créditos de IA

Las Reglas Avanzadas que utilizan modelos de lenguaje grandes consumen Créditos de IA de la asignación mensual de tu organización. Las organizaciones con una suscripción dedicada a Reglas Avanzadas no son cobradas con créditos.

Cuando se agota su saldo de crédito, se omiten las reglas avanzadas impulsadas por IA y las reglas avanzadas que quedan todavía se ejecutan: el escaneo no falla. Consulte Créditos de IA para monitoreo y compra.

Tiempo de escaneo

Las Reglas Avanzadas añaden tiempo significativo a un escaneo: típicamente 15 a 20 segundos, además de la captura y carga de pantalla. Si sus escaneos comienzan a agotarse después de habilitar las Reglas Avanzadas, aumente BROWSER_TIMEOUT_MS (vea Referencia de Configuración) o use disabled para la iteración y un ajuste predefinido activo para una verificación final.

Confiabilidad

Debido a que algunas reglas avanzadas utilizan IA, los resultados pueden variar ligeramente entre ejecuciones en la misma página. Un hallazgo reportado con un 75% de confianza puede obtener un 65% en el siguiente escaneo, lo cual puede cambiar si pasa su umbral. Los resultados también pueden variar entre máquinas y entornos, ya que el sistema operativo, la GPU y las características de la pantalla afectan el renderizado.

Trate una diferencia de encontronazos avanzados de ejecución a ejecución como una variación esperada en lugar de una regresión. Consulte Limitaciones y Consideraciones para obtener la imagen completa.

Relación con otras configuraciones

• Las reglas experimentales son independientes. advancedRules: "disabled" no desactiva reglas experimentales de axe-core, y habilitar reglas experimentales no omite su ajuste predefinido de Reglas Avanzadas. Las dos configuraciones se combinan.
• No hay una opción de umbral de confianza separada. El umbral se deriva del ajuste predefinido, coincidiendo con la Configuración de Axe y la Extensión del Navegador Axe DevTools.
• El estándar de accesibilidad, las mejores prácticas, y las revisiones aún aplican. Los hallazgos avanzados se filtran con los mismos ajustes de Configuración de Axe que los hallazgos estándar.