Règles avancées

Règles avancées sont un ensemble de tests d'accessibilité automatisés qui utilisent des captures d'écran, la vision par ordinateur et de grands modèles de langage pour détecter des problèmes que l'axe-core standard ne peut pas — tels que des titres qui ne ressemblent qu'à des titres, des images informatives avec un texte alternatif peu utile, et des contrastes de texte sur des dégradés ou des images.

L'outil analyze peut exécuter les Règles avancées parallèlement au jeu de règles standard d'axe-core. Lorsqu'il le fait, les résultats avancés sont fusionnés dans le même tableau de résultats que votre agent utilise déjà, donc aucun changement à vos invites ou à votre flux de travail n'est nécessaire.

Les Règles avancées sont régies par la Configuration Axe de votre organisation et — là où votre administrateur le permet — peuvent être remplacées par serveur ou par analyse.

Valeurs prédéfinies acceptées

Les Règles avancées qui utilisent l'IA fournissent un score de confiance plutôt qu'un succès ou un échec définitif, et un préréglage définit le seuil à partir duquel une découverte est signalée. Pour savoir ce que chaque préréglage signifie et comment choisir entre eux, voir Contrôles de confiance — les seuils sont identiques dans chaque produit qui exécute les Règles avancées.

Partout où le serveur Axe MCP accepte un préréglage — l'argument outil advancedRules ou la variable d'environnement AXE_ADVANCED_RULES — voici les valeurs qu'il reconnaît :

Les valeurs ne sont pas sensibles à la casse et les espaces entourant sont ignorés, donc " Balanced " et "BALANCED" se résolvent tous deux en balanced. Il n'y a pas d'alias de pourcentage pour disabled.

Choisir un préréglage

Il y a trois façons de définir le préréglage. Lorsque plus d'un est présent, celui de plus haute priorité l'emporte :

1. L'argument outil advancedRules — par analyse
2. La variable d'environnement AXE_ADVANCED_RULES — par serveur
3. La configuration Axe par défaut de votre organisation — par organisation

Quelle que soit la source utilisée, la valeur résolue est signalée dans la réponse advancedRules bloc, afin que votre agent puisse toujours voir quel préréglage a réellement été exécuté.

Valeur par défaut de l'organisation

La valeur par défaut de votre organisation provient du paramètre Règles avancées par défaut dans Configuration Axe, qu'un administrateur gère dans le portail de compte Axe. Cette page documente les options disponibles et la case à cocher « Autoriser les utilisateurs à modifier » qui décide si les deux remplacements ci-dessous sont permis du tout.

Deux choses spécifiques au serveur Axe MCP :

• Le serveur lit la configuration Axe à chaque appel chaque analyze, de sorte qu'un changement effectué par votre administrateur prend effet lors de votre prochaine analyse — aucun redémarrage du serveur ou du client n'est nécessaire.
• Si le paramètre est verrouillé, la variable d'environnement et l'argument outil sont ignorés sans avertissement et la réponse signale "source": "org_policy_locked", vous permettant de savoir qu'un remplacement a été abandonné plutôt qu'appliqué.

AXE_ADVANCED_RULESvariable d'environnement

Définissez AXE_ADVANCED_RULES dans votre configuration du serveur MCP pour choisir un préréglage pour chaque analyse exécutée par ce serveur. C'est l'endroit idéal pour un choix à l'échelle de l'équipe ou du projet qui ne devrait pas être répété dans chaque invite.

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

Voir le Référence de configuration pour les détails, et votre guide de configuration du client pour savoir où se trouve le bloc env dans votre client.

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

advancedRulesargument outil

Passez advancedRules à un seul appel analyze pour remplacer le préréglage uniquement pour cette analyse. Incitez votre agent IA en langage naturel — l'agent traduit votre intention en appel d'outil :

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

L'agent appelle l'outil analyze avec une charge utile similaire à :

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

Une valeur invalide ici génère une erreur de validation de schéma par appel nommant les valeurs acceptées ; cela n'affecte pas le serveur ni les appels suivants.

Utilisez l'argument de l'outil lorsque vous souhaitez un écart ponctuel — par exemple thorough sur une page que vous auditez activement, ou disabled sur une grande page où vous ne souhaitez que des résultats standard rapides :

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

Le bloc de réponse advancedRules

Chaque réponse analyze inclut un bloc advancedRules signalant le préréglage qui a effectivement été utilisé et son origine :

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

value est toujours l'un des quatre préréglages. source explique comment cette valeur a été déterminée :

Comportement de fermeture en cas d’échec

Le serveur MCP Axe ne devine jamais un préréglage. Si la configuration Axe est accessible mais que le paramètre des règles avancées est manquant, ou contient une valeur que cette version du serveur ne reconnaît pas, la vérification signale "value": "disabled", "source": "unavailable" et exécute uniquement le standard axe-core — il ne fait pas recours à un préréglage codé en dur. Cela empêche un problème de version entre votre serveur et le portail de compte Axe de s'appliquer silencieusement à un seuil que personne n'a choisi.

Si la configuration Axe ne peut être récupérée du tout (échec réseau, identifiants invalides), l'appel analyze échoue complètement plutôt que de procéder à une analyse avec des paramètres inconnus. C’est un comportement existant pour tous les paramètres, pas spécifiquement pour les règles avancées — voir Erreurs d'authentification.

Quand les règles avancées ne s'exécutent pas

Une valeur effective de disabled signifie que les règles avancées ne sont pas vraiment chargées dans l'analyse : aucune capture d'écran n'est enregistrée pour elles, rien n'est envoyé à Deque pour évaluation, et aucun crédit AI n'est consommé. Vos résultats axe-core standard sont renvoyés exactement comme ils le seraient autrement.

Si vous avez demandé un préréglage qui ne pouvait pas être honoré parce que les règles avancées ne sont pas disponibles pour votre serveur, le tableau messages de la réponse le signale :

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

Aucun message n'est émis lorsque vous n'avez rien demandé — un défaut d'organisation disabled est un choix délibéré, pas un problème à signaler.

Dégradation partielle

Les règles avancées ne font jamais échouer une analyse. Si les règles se chargent mais que leur évaluation côté serveur rencontre des problèmes, analyze renvoie vos résultats axe-core standard plus un message décrivant ce qui a été perdu :

Disponibilité

Le serveur MCP Axe est inclus dans le lot Axe DevTools pour le Web, et les règles avancées l'accompagnent. Si vous avez accès au serveur MCP Axe, vous disposez des règles avancées — il n'y a pas d'achat séparé à faire pour les règles avancées.

Une chose peut encore les rendre indisponibles : les règles avancées sont évaluées côté serveur, donc votre déploiement doit être connecté à l'infrastructure AI de Deque. Les déploiements en cloud privé et sur site ont besoin des services ML et LLM — voir le Guide de disponibilité des fonctionnalités AI. Les clients SaaS sont connectés dès la sortie de la boîte.

Si les analyses rapportent "source": "unavailable" et que vous vous attendez à ce que les règles avancées soient disponibles, contactez votre responsable de la réussite client. La disponibilité est résolue au démarrage du serveur, redémarrez donc le serveur MCP (ou votre client MCP) après un changement d'abonnement plutôt que d'attendre que la prochaine analyse prenne effet.

Ce qui est envoyé à Deque

Les règles avancées sont le seul cas où analyze envoie les données de page aux serveurs Deque. Lorsqu'un préréglage actif est résolu, l'analyse :

1. Capture une capture d'écran pleine page dans le navigateur et la télécharge sur le point de terminaison des captures d'écran de Deque.
2. Envoie la charge utile de l'évaluation du contrôleur — la structure de la page, les styles calculés et la géométrie nécessaires aux règles avancées — au point de terminaison des règles avancées de Deque, où les modèles ML et LLM l'évaluent.
3. Fusionne les résultats renvoyés dans vos résultats.

L'analyse standard axe-core n'est pas affectée : avec les règles avancées disabled, l'outil analyze n'envoie rien à Deque au-delà des demandes d'authentification et de configuration.

Crédits AI

Les règles avancées qui utilisent de grands modèles de langage consomment Crédits AI de l'allocation mensuelle de votre organisation. Les organisations avec un abonnement dédié aux règles avancées ne se voient pas facturer de crédits.

Lorsque votre solde de crédits est épuisé, les règles avancées pilotées par l'IA sont ignorées et les règles avancées restantes continuent à fonctionner — l'analyse ne échoue pas. Voir Crédits AI pour la surveillance et l'achat.

Temps d'analyse

Les règles avancées ajoutent un temps significatif à une analyse — généralement 15 à 20 secondes, en plus de la capture d'écran et du téléchargement. Si vos analyses commencent à expirer après l'activation des règles avancées, augmentez BROWSER_TIMEOUT_MS (voir Référence de configuration) ou utilisez disabled pour les itérations et un préréglage actif pour une vérification finale.

Fiabilité

Comme certaines règles avancées utilisent l'IA, les résultats peuvent légèrement varier d'une exécution à l'autre sur la même page. Un résultat rapporté avec une confiance de 75% peut obtenir un score de 65% lors de la prochaine analyse, ce qui peut changer s'il atteint votre seuil. Les résultats peuvent également varier d'une machine à l'autre et d'un environnement à l'autre, car le système d'exploitation, le GPU et les caractéristiques d'affichage influencent tous le rendu.

Considérez une différence d'une exécution à l'autre dans les résultats avancés comme une variance attendue plutôt qu'une régression. Voir Limitations et considérations pour une vue d'ensemble complète.

Relation avec les autres paramètres

• Les règles expérimentales sont indépendantes. advancedRules: "disabled" ne désactive pas règles expérimentales axe-core, et l'activation des règles expérimentales ne contourne pas votre préréglage des règles avancées. Les deux paramètres se combinent.
• Il n'y a pas d'option de seuil de confiance distincte. Le seuil est dérivé du préréglage, conformant à la configuration Axe et à l'extension du navigateur Axe DevTools.
• La norme d'accessibilité, les meilleures pratiques et les besoins de révision s'appliquent toujours. Les résultats avancés sont filtrés par les mêmes paramètres de configuration Axe que les résultats standard.