Geavanceerde Regels

Geavanceerde Regels zijn een reeks geautomatiseerde toegankelijkheidstests die gebruikmaken van screenshots, computervisie en grote taalmodellen om problemen te identificeren die de standaard axe-core niet kan detecteren—zoals koppen die alleen op koppen lijken, informatieve afbeeldingen met niet-informatieve alternatieve tekst, en tekstcontrast over verlopen of afbeeldingen.

Het analyze-hulpmiddel kan Geavanceerde Regels uitvoeren naast de standaard axe-core regels. Wanneer dit gebeurt, worden geavanceerde bevindingen samengevoegd in dezelfde resultatenreeks die uw agent al gebruikt, dus er is geen wijziging in uw prompts of workflow nodig.

Geavanceerde Regels worden beheerd door de Axe-configuratie van uw organisatie en kunnen — waar uw beheerder dit toestaat — per server of per scan worden overschreven.

Geaccepteerde presetwaarden

Geavanceerde Regels die AI gebruiken, rapporteren een vertrouwen-score in plaats van een definitieve goedkeuring of afwijzing, en een preset stelt de drempel in op of boven welke een bevinding wordt gerapporteerd. Voor wat elke preset betekent en hoe te kiezen tussen hen, zie Vertrouwenscontroles — de drempels zijn identiek in elk product dat Geavanceerde Regels uitvoert.

Waar de Axe MCP Server een preset accepteert — het advancedRules-hulpmiddelargument of de AXE_ADVANCED_RULES-omgevingsvariabele — herkent het deze waarden:

Waarden zijn niet hoofdlettergevoelig en omliggende spaties worden genegeerd, dus " Balanced " en "BALANCED" lossen beide op naar balanced. Er is geen percentage-alias voor disabled.

Een preset kiezen

Er zijn drie manieren om de preset in te stellen. Wanneer er meer dan één aanwezig is, wint degene met de hoogste prioriteit:

1. Het advancedRules-hulpmiddelargument — per scan
2. De AXE_ADVANCED_RULES-omgevingsvariabele — per server
3. De standaard Axe-configuratie van uw organisatie — per organisatie

Welke bron ook wordt gebruikt, de opgeloste waarde wordt gerapporteerd in de advancedRules-blok van de reactie, zodat uw agent altijd kan zien welke preset daadwerkelijk is uitgevoerd.

Standaard van de organisatie

De standaard van uw organisatie komt van de Standaard Geavanceerde Regels-instelling in Axe-configuratie, die een beheerder beheert in het Axe Account Portaal. Die pagina documenteert de beschikbare opties en de „Gebruikers toestaan om te wijzigen“-selectievakje dat bepaalt of de twee onderstaande overschrijvingen helemaal toegestaan zijn.

Twee dingen specifiek voor de Axe MCP Server:

• De server leest de Axe-configuratie bij elk analyze-oproep, dus een wijziging die uw beheerder aanbrengt, wordt van kracht bij uw volgende scan — geen server- of clientherstart nodig.
• Als de instelling is vergrendeld, worden de omgevingsvariabele en het hulpmiddelargument stilzwijgend genegeerd en rapporteert de reactie "source": "org_policy_locked", zodat u kunt zien dat een overschrijving is verwijderd in plaats van toegepast.

AXE_ADVANCED_RULES-omgevingsvariabele

Stel AXE_ADVANCED_RULES in uw MCP-serverconfiguratie in om een preset te kiezen voor elke scan die die server uitvoert. Dit is de juiste plaats voor een team- of projectbrede keuze die niet in elke prompt herhaald hoeft te worden.

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

Zie de Configuratiereferentie voor details, en uw handleiding voor clientinstallatie voor waar het env-blok zich in uw client bevindt.

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

advancedRules-hulpmiddelargument

Geef advancedRules door aan een enkele analyze-oproep om de preset alleen voor die scan te overschrijven. Geef uw AI-agent opdracht in natuurlijke taal — de agent vertaalt uw intentie naar de hulpmiddeloproep:

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

De agent roept het analyze-hulpmiddel aan met een payload die lijkt op:

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

Een ongeldige waarde hier is een per-oproep schema validatiefout waarin de geaccepteerde waarden worden genoemd; het heeft geen invloed op de server of volgende oproepen.

Gebruik het argument tool wanneer je een eenmalige afwijking wilt — bijvoorbeeld thorough op een pagina die je actief aan het auditen bent, of disabled op een grote pagina waar je alleen snelle standaardresultaten wilt:

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

Het advancedRulesresponseblok

Elke analyze respons bevat een advancedRules blok dat rapporteert welke preset daadwerkelijk is uitgevoerd en waar deze vandaan kwam:

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

value is altijd één van de vier presets. source legt uit hoe die waarde is bereikt:

Fail-closed gedrag

De Axe MCP Server raadt nooit een preset. Als de Axe Configuratie bereikbaar is maar de instelling voor Geavanceerde Regels ontbreekt, of een waarde heeft die deze versie van de server niet herkent, rapporteert de scan "value": "disabled", "source": "unavailable" en voert alleen de standaard axe-core uit — het doet niet geen beroep op een hardgecodeerde preset. Dit voorkomt dat een versieverschil tussen je server en het Axe Account Portal ongemerkt een drempelwaarde toepast die niemand heeft gekozen.

Als de Axe Configuratie helemaal niet kan worden opgehaald (netwerkfout, ongeldige inloggegevens), mislukt de analyze oproep volledig in plaats van te scannen met onbekende instellingen. Dat is bestaand gedrag voor alle instellingen, niet specifiek voor Geavanceerde Regels — zie Authenticatiefouten.

Wanneer Geavanceerde Regels niet draaien

Een effectieve waarde van disabled betekent dat Geavanceerde Regels echt niet in de scan zijn geladen: er wordt geen screenshot voor hen gemaakt, er wordt niets naar Deque gestuurd voor evaluatie en er worden geen AI-credits verbruikt. Je standaard axe-core bevindingen worden precies geretourneerd zoals ze anders ook zouden zijn.

Als je om een preset vroeg die niet kon worden gehonoreerd omdat Geavanceerde Regels niet beschikbaar zijn voor je server, meldt de messages array van de respons dat:

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

Er wordt geen bericht uitgezonden wanneer je nergens om gevraagd hebt — een disabled organisatiestandaard is een weloverwogen keuze, geen probleem om te melden.

Gedeeltelijke degradatie

Geavanceerde Regels laten nooit een scan mislukken. Als de regels laden maar hun server-side evaluatie probleem ondervindt, geeft analyze je standaard axe-core resultaten plus een bericht dat beschrijft wat verloren ging:

Beschikbaarheid

De Axe MCP Server is inbegrepen in het Axe DevTools voor Web pakket, en Geavanceerde Regels komen erbij. Als je toegang hebt tot de Axe MCP Server, heb je Geavanceerde Regels — er hoeft geen aparte aankoop van Geavanceerde Regels te worden gedaan.

Er is nog maar één ding dat ze onbeschikbaar kan maken: Geavanceerde Regels worden server-side geëvalueerd, dus je implementatie moet verbonden zijn met Deque's AI-infrastructuur. Privé-cloud en on-premises implementaties hebben de ML- en LLM-diensten nodig — zie de AI Feature Availability Guide. SaaS-klanten zijn out of the box verbonden.

Als scans "source": "unavailable" rapporteren en je verwacht dat Geavanceerde Regels beschikbaar zijn, neem dan contact op met je Customer Success Manager. Beschikbaarheid wordt opgelost wanneer de server start, dus herstart de MCP-server (of je MCP-client) na een wijziging van de abonnement, in plaats van te verwachten dat de volgende scan het oppikt.

Wat wordt naar Deque gestuurd

Geavanceerde regels zijn het enige geval waarin analyze paginagegevens naar Deque-servers sturen. Wanneer een actieve preset is opgelost, de scan:

1. Maakt een volledige pagina screenshot in de browser en uploadt het naar Deque's screenshot endpoint.
2. Stuurt de evaluatielading van de recorder — de paginastructuur, berekende stijlen en geometrie die de geavanceerde regels nodig hebben — naar Deque's geavanceerde-regels endpoint, waar de ML- en LLM-modellen het evalueren.
3. Voegt de geretourneerde bevindingen samen met je resultaten.

Standaard axe-core scannen wordt niet beïnvloed: met Geavanceerde Regels disabled, stuurt de analyze tool niets naar Deque behalve authenticatie- en configuratieverzoeken.

AI-credits

Geavanceerde Regels die grote taalmodellen gebruiken verbruiken AI-credits uit de maandelijkse toewijzing van je organisatie. Organisaties met een toegewijd Geavanceerde Regels abonnement worden niet belast met credits.

Wanneer uw kredietsaldo is uitgeput, worden de door AI aangedreven geavanceerde regels overgeslagen en blijven de resterende geavanceerde regels actief — de scan mislukt niet. Zie AI-credits voor monitoring en aankopen.

Scantijd

Geavanceerde regels voegen betekenisvolle tijd toe aan een scan — meestal 15 tot 20 seconden, bovenop het maken en uploaden van de schermafbeelding. Als uw scans beginnen te verlopen na het inschakelen van geavanceerde regels, verhoog BROWSER_TIMEOUT_MS (zie de Configuratiereferentie) of gebruik disabled voor iteratie en een actief preset voor een laatste controle.

Betrouwbaarheid

Omdat sommige geavanceerde regels AI gebruiken, kunnen de resultaten enigszins variëren tussen uitvoeringen op dezelfde pagina. Een bevinding die met 75% zekerheid wordt gerapporteerd, kan bij de volgende scan 65% scoren, wat kan beïnvloeden of het uw drempel overschrijdt. Resultaten kunnen ook variëren tussen verschillende machines en omgevingen, omdat besturingssysteem, GPU en beeldschermkenmerken allemaal invloed hebben op het renderen.

Behandel een verschil tussen uitvoeringen in geavanceerde bevindingen als verwachte variatie in plaats van een regressie. Zie Beperkingen en overwegingen voor het volledige beeld.

Relatie met andere instellingen

• Experimentele regels zijn onafhankelijk. advancedRules: "disabled" schakelt experimentele axe-core regels niet uit, en het inschakelen van experimentele regels omzeilt uw geavanceerde regelspreset niet. De twee instellingen worden gecombineerd.
• Er is geen aparte optie voor de zekerheid drempel. De drempel is afgeleid van het preset, overeenkomstig met Axe Configuration en de Axe DevTools Browser Extension.
• Toegankelijkheidsstandaard, beste praktijken en beoordeling zijn nog steeds van toepassing. Geavanceerde bevindingen worden gefilterd door dezelfde Axe Configuration-instellingen als standaardbevindingen.