Erweiterte Regeln

Erweiterte Regeln sind eine Reihe automatisierter Barrierefreiheitstests, die Screenshots, Computer Vision und große Sprachmodelle verwenden, um Probleme zu erkennen, die das Standard-axe-core nicht erfassen kann – wie Überschriften, die nur wie Überschriften aussehen, informative Bilder mit unzureichendem alternativen Text und Textkontrast über Farbverläufen oder Bildern.

Das analyze-Tool kann erweiterte Regeln zusammen mit dem Standard-axe-core-Regelsatz ausführen. Wenn es das tut, werden die erweiterten Ergebnisse in das gleiche Ergebnisarray integriert, das Ihr Agent bereits nutzt, sodass keine Änderungen an Ihren Eingaben oder Ihrem Workflow erforderlich sind.

Erweiterte Regeln werden von der Axe-Konfiguration Ihrer Organisation gesteuert und können – sofern es Ihr Administrator zulässt – pro Server oder pro Scan überschrieben werden.

Akzeptierte Voreinstellungswerte

Erweiterte Regeln, die KI verwenden, berichten einen Vertrauen-Wert anstelle eines definitiven Erfolgs oder Misserfolgs, und eine Voreinstellung legt den Schwellenwert fest, bei dem ein Ergebnis gemeldet wird. Für eine Erklärung, was jede Voreinstellung bedeutet und wie man zwischen ihnen wählt, siehe Vertrauenssteuerungen – die Schwellenwerte sind in jedem Produkt, das erweiterte Regeln ausführt, identisch.

Überall dort, wo der Axe MCP Server eine Voreinstellung akzeptiert – das advancedRules-Tool-Argument oder die AXE_ADVANCED_RULES-Umgebungsvariable – sind dies die Werte, die er erkennt:

Die Werte sind nicht auf Groß- und Kleinschreibung empfindlich und umgebende Leerzeichen werden ignoriert, daher lösen " Balanced " und "BALANCED" beide zu balanced auf. Es gibt kein Prozentverhältnis für disabled.

Auswahl einer Voreinstellung

Es gibt drei Möglichkeiten, die Voreinstellung festzulegen. Wenn mehr als eine vorhanden ist, gewinnt die mit der höchsten Priorität:

1. Das advancedRules-Tool-Argument – pro Scan
2. Die AXE_ADVANCED_RULES-Umgebungsvariable – pro Server
3. Die Standardkonfiguration Ihrer Organisation für Axe – pro Organisation

Welcher Quelle auch immer verwendet wird, der ermittelte Wert wird in der advancedRules-Block der Antwort zurückgemeldet, sodass Ihr Agent jederzeit sehen kann, welche Voreinstellung tatsächlich ausgeführt wurde.

Organisationsstandard

Der Standard Ihrer Organisation stammt aus der Standardmäßig erweiterte Regeln-Einstellung in Axe-Konfiguration, die ein Administrator im Axe Account Portal verwaltet. Auf dieser Seite sind die verfügbaren Optionen und das „Benutzern ermöglichen, Änderungen vorzunehmen“-Kontrollkästchen dokumentiert, das entscheidet, ob die beiden untenstehenden Überschreibungen überhaupt zulässig sind.

Zwei Dinge, die speziell für den Axe MCP Server gelten:

• Der Server liest die Axe-Konfiguration bei jedem jeder analyze-Aufruf, sodass eine Änderung, die Ihr Administrator vornimmt, bei Ihrem nächsten Scan wirksam wird – kein Neustart des Servers oder Clients erforderlich.
• Wenn die Einstellung gesperrt ist, werden die Umgebungsvariable und das Tool-Argument stillschweigend ignoriert und die Antwort meldet "source": "org_policy_locked", sodass Sie erkennen können, ob eine Überschreibung fallen gelassen wurde, anstatt angewendet zu werden.

AXE_ADVANCED_RULES-Umgebungsvariable

Setzen Sie AXE_ADVANCED_RULES in Ihrer MCP-Server-Konfiguration, um eine Voreinstellung für jeden Scan festzulegen, den dieser Server ausführt. Dies ist der richtige Ort für eine teamweite oder projektweite Auswahl, die nicht bei jedem Eingabeaufforderung wiederholt werden muss.

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

Siehe die Konfigurationsreferenz für Details, und Ihre Einrichtungsanleitung für den Client, um zu erfahren, wo der env-Block in Ihrem Client lebt.

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

advancedRules-Tool-Argument

Geben Sie advancedRules bei einem einzelnen analyze-Aufruf an, um die Voreinstellung nur für diesen Scan zu überschreiben. Fordern Sie Ihren KI-Agenten in natürlicher Sprache auf – der Agent übersetzt Ihre Absicht in den Tool-Aufruf:

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

Der Agent ruft das analyze-Tool mit einem ähnlichen Payload auf:

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

Ein ungültiger Wert hier ist ein Validierungsfehler pro Aufruf im Schema, der die akzeptierten Werte benennt; es beeinflusst nicht den Server oder nachfolgende Aufrufe.

Verwenden Sie das Tool-Argument, wenn Sie eine einmalige Abweichung möchten — zum Beispiel thorough auf einer Seite, die Sie derzeit prüfen, oder disabled auf einer großen Seite, auf der Sie nur schnelle Standardergebnisse wünschen:

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

Der advancedRules-Antwortblock

Jede analyze-Antwort enthält einen advancedRules-Block, der das tatsächlich ausgeführte Preset und dessen Herkunft meldet:

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

value ist immer eines der vier Presets. source erklärt, wie dieser Wert erreicht wurde:

Fehlverhalten bei Ausfallsicherung

Der Axe MCP Server rät nie ein Preset. Wenn die Axe-Konfiguration erreichbar ist, aber die Einstellung für erweiterte Regeln fehlt oder einen Wert enthält, den diese Version des Servers nicht erkennt, meldet der Scan "value": "disabled", "source": "unavailable" und führt nur standardmäßige axe-core durch — er fällt nicht auf ein fest codiertes Preset zurück. Dies verhindert, dass ein Versionsunterschied zwischen Ihrem Server und dem Axe Account Portal stillschweigend ein ungewolltes Schwellenwert-Setting anwendet.

Wenn die Axe-Konfiguration überhaupt nicht abgerufen werden kann (Netzwerkausfall, ungültige Anmeldeinformationen), schlägt der analyze-Aufruf vollständig fehl, anstatt mit unbekannten Einstellungen zu scannen. Dies ist das bestehende Verhalten für alle Einstellungen, nicht spezifisch für erweiterte Regeln — siehe Authentifizierungsfehler.

Wenn erweiterte Regeln nicht ausgeführt werden

Ein effektiver Wert von disabled bedeutet, dass erweiterte Regeln wirklich nicht in den Scan geladen sind: Es wird kein Screenshot für sie erstellt, nichts wird zur Bewertung an Deque gesendet, und keine KI-Kredite werden verbraucht. Ihre standardmäßigen axe-core-Ergebnisse werden genau so zurückgegeben, wie sie es sonst auch würden.

Wenn Sie ein Preset angefordert haben, das nicht umgesetzt werden konnte, weil erweiterte Regeln für Ihren Server nicht verfügbar sind, gibt das messages-Array der Antwort dies an:

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

Es wird keine Nachricht ausgegeben, wenn Sie nichts angefordert haben — ein disabled-Organisationsstandard ist eine bewusste Entscheidung, kein Problem, das gemeldet werden muss.

Teilweise Beeinträchtigung

Erweiterte Regeln schlagen einen Scan nie fehl. Wenn die Regeln geladen werden, aber ihre serverseitige Auswertung auf Probleme stößt, gibt analyze Ihre standardmäßigen axe-core-Ergebnisse plus eine Nachricht zurück, die beschreibt, was verloren ging:

Verfügbarkeit

Der Axe MCP Server ist im Axe DevTools für Web-Paket enthalten, und erweiterte Regeln sind enthalten. Wenn Sie Zugang zum Axe MCP Server haben, haben Sie auch erweiterte Regeln — es gibt keinen separaten Kauf für erweiterte Regeln.

Eine Sache kann sie dennoch unzugänglich machen: Erweiterte Regeln werden serverseitig ausgewertet, daher muss Ihre Bereitstellung mit der KI-Infrastruktur von Deque verbunden sein. Private Cloud- und On-Premises-Bereitstellungen benötigen die ML- und LLM-Dienste — sehen Sie AI Feature Availability Guide. SaaS-Kunden sind von Haus aus verbunden.

Wenn Scans "source": "unavailable" berichten und Sie erwarten, dass erweiterte Regeln verfügbar sind, kontaktieren Sie Ihren Customer Success Manager. Die Verfügbarkeit wird beim Start des Servers festgelegt, daher starten Sie den MCP-Server (oder Ihren MCP-Client) nach einer Abo-Änderung neu, anstatt zu erwarten, dass der nächste Scan sie aufnimmt.

Was an Deque gesendet wird

Erweiterte Regeln sind der einzige Fall, bei dem analyze Seitendaten an Deque-Server sendet. Wenn ein aktives Preset aufgelöst wird, der Scan:

1. Erfasst einen Vollständiger Seiten-Screenshot im Browser und lädt ihn zum Screenshot-Endpunkt von Deque hoch.
2. Sendet die Auswertungsdaten des Rekorders — die Seitenstruktur, berechnete Stile und Geometrie, die die erweiterten Regeln benötigen — an den erweiterten Regeln-Endpunkt von Deque, wo die ML- und LLM-Modelle sie auswerten.
3. Fügt die zurückgegebenen Ergebnisse in Ihre Resultate ein.

Standardmäßiges axe-core-Scannen bleibt unberührt: mit erweiterten Regeln disabled sendet das analyze-Tool nichts an Deque außer Authentifizierungs- und Konfigurationsanfragen.

AI-Kredite

Erweiterte Regeln, die große Sprachmodelle nutzen, verbrauchen AI-Kredite von der monatlichen Zuteilung Ihrer Organisation. Organisationen mit einem dedizierten Abonnement für erweiterte Regeln werden keine Kredite belastet.

Wenn Ihr Guthaben erschöpft ist, werden die KI-gestützten erweiterten Regeln übersprungen und die verbleibenden erweiterten Regeln weiterhin ausgeführt – der Scan schlägt nicht fehl. Siehe AI-Kredite für Überwachung und Kauf.

Scan-Zeit

Erweiterte Regeln fügen einem Scan bedeutende Zeit hinzu – typischerweise 15 bis 20 Sekunden, zusätzlich zur Screenshot-Aufnahme und -Hochladen. Wenn Ihre Scans nach der Aktivierung der erweiterten Regeln beginnen, zeitlich abzulaufen, erhöhen Sie BROWSER_TIMEOUT_MS (siehe die Konfigurationsreferenz) oder verwenden Sie disabled für Iteration und eine aktive Voreinstellung für eine abschließende Überprüfung.

Zuverlässigkeit

Da einige erweiterte Regeln KI verwenden, können die Ergebnisse leicht zwischen den Läufen auf derselben Seite variieren. Ein Befund, der mit 75 % Vertrauen gemeldet wird, kann beim nächsten Scan 65 % erreichen, was beeinflussen kann, ob er Ihre Schwelle überschreitet. Ergebnisse können auch je nach Maschine und Umgebung variieren, da Betriebssystem, GPU und Anzeigeeigenschaften das Rendering beeinflussen.

Betrachten Sie eine Lauf-zu-Lauf-Unterschied in erweiterten Erkenntnissen als erwartete Varianz und nicht als Regression. Siehe Einschränkungen und Überlegungen für das vollständige Bild.

Beziehung zu anderen Einstellungen

• Experimentelle Regeln sind unabhängig. advancedRules: "disabled" deaktiviert experimentelle axe-core-Regeln nicht, und die Aktivierung experimenteller Regeln umgeht nicht Ihre Voreinstellung für erweiterte Regeln. Die beiden Einstellungen werden kombiniert.
• Es gibt keine separate Option für die Vertrauensgrenzwert. Der Schwellenwert wird aus der Voreinstellung abgeleitet, entsprechend der Axe-Konfiguration und der Axe DevTools Browser-Erweiterung.
• Barrierefreiheitsstandard, bewährte Praktiken und Überprüfungsbedarf gelten weiterhin. Erweiterte Erkenntnisse werden mit denselben Axe-Konfigurationseinstellungen gefiltert wie Standarderkenntnisse.