Regole Avanzate

Regole Avanzate sono un insieme di test di accessibilità automatizzati che utilizzano screenshot, visione artificiale e modelli linguistici di grandi dimensioni per individuare problemi che lo standard axe-core non può rilevare — come intestazioni che sembrano intestazioni solo nell'aspetto, immagini informative con testo alternativo inutile e contrasto di testo su gradienti o immagini.

Lo strumento analyze può eseguire le Regole Avanzate insieme al set di regole standard di axe-core. Quando lo fa, i risultati avanzati vengono uniti allo stesso array di risultati che il tuo agente già utilizza, quindi non è necessario modificare i tuoi prompt o il tuo flusso di lavoro.

Le Regole Avanzate sono disciplinate dalla Configurazione di Axe della tua organizzazione e — dove il tuo amministratore lo consente — possono essere sovrascritte per server o per scansione.

Valori preimpostati accettati

Le Regole Avanzate che utilizzano l'IA riportano un punteggio di affidabilità anziché un passaggio o un fallimento definitivo, e un preset imposta la soglia al di sopra della quale un risultato viene riportato. Per capire cosa significa ogni preset e come scegliere tra essi, vedere Controlli di Affidabilità — le soglie sono identiche in ogni prodotto che esegue Regole Avanzate.

Ovunque il Server Axe MCP accetti un preset — l'argomento dello strumento advancedRules o la variabile di ambiente AXE_ADVANCED_RULES — questi sono i valori che riconosce:

I valori non sono sensibili alle maiuscole e gli spazi circostanti vengono ignorati, quindi " Balanced " e "BALANCED" si risolvono entrambi a balanced. Non c'è un alias in percentuale per disabled.

Scelta di un preset

Ci sono tre modi per impostare il preset. Quando sono presenti più di uno, vince quello con la precedenza più alta:

1. L'argomento dello strumento advancedRules — per scansione
2. La variabile di ambiente AXE_ADVANCED_RULES — per server
3. Configurazione di Axe predefinita della tua organizzazione — per organizzazione

Qualunque sia la fonte utilizzata, il valore risolto viene riportato nella risposta di advancedRules blocco, quindi il tuo agente può sempre vedere quale preset è stato effettivamente eseguito.

Predefinito dell'organizzazione

Il predefinito della tua organizzazione proviene dalla configurazione Regole Avanzate Predefinite in Configurazione di Axe, gestita da un amministratore nel Portale Account Axe. Quella pagina documenta le opzioni disponibili e la casella di controllo „Permetti agli utenti di cambiare“ che decide se i due override di seguito sono consentiti.

Due aspetti specifici del Server Axe MCP:

• Il server legge la Configurazione di Axe a ogni analyze, quindi un cambiamento fatto dal tuo amministratore ha effetto alla tua prossima scansione — non è necessario riavviare server o client.
• Se l'impostazione è bloccata, la variabile di ambiente e l'argomento dello strumento vengono ignorati silenziosamente e la risposta riporta "source": "org_policy_locked", così puoi capire se un override è stato scartato piuttosto che applicato.

Variabile di ambiente AXE_ADVANCED_RULES

Imposta AXE_ADVANCED_RULES nella configurazione del tuo server MCP per scegliere un preset per ogni scansione eseguita da quel server. Questo è il posto giusto per una scelta a livello di team o di progetto che non dovrebbe essere ripetuta in ogni prompt.

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

Vedi Riferimento alla Configurazione per i dettagli e guida alla configurazione del client per dove si trova il blocco env nel tuo client.

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

Argomento dello strumento advancedRules

Passa advancedRules a una singola chiamata analyze per sovrascrivere il preset solo per quella scansione. Invita il tuo agente AI in linguaggio naturale — l'agente traduce il tuo intento nella chiamata allo strumento:

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

L'agente chiama lo strumento analyze con un payload simile a:

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

Un valore non valido qui è un errore di validazione dello schema per singola chiamata che nomina i valori accettati; non influisce sul server o sulle chiamate successive.

Usa l'argomento strumento quando desideri una deviazione unica — per esempio thorough su una pagina che stai auditando attivamente, o disabled su una pagina grande dove vuoi solo risultati standard veloci:

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

Il blocco risposta advancedRules

Ogni risposta analyze include un blocco advancedRules che riporta il preset effettivamente eseguito e da dove proviene:

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

value è sempre uno dei quattro preset. source spiega come è stato raggiunto quel valore:

Comportamento fail-closed

Il server MCP di Axe non ipotizza mai un preset. Se la configurazione Axe è raggiungibile ma manca l'impostazione delle Regole Avanzate, o contiene un valore che questa versione del server non riconosce, la scansione riporta "value": "disabled", "source": "unavailable" e esegue solo il classico axe-core — non torna a un preset codificato. Questo evita che uno sfasamento di versione tra il tuo server e il portale Axe Account applichi silenziosamente una soglia che nessuno ha scelto.

Se non è possibile recuperare affatto la configurazione Axe (guasto di rete, credenziali non valide), la chiamata analyze fallisce completamente piuttosto che eseguire una scansione con impostazioni sconosciute. Questo è il comportamento esistente per tutte le impostazioni, non specifico per le Regole Avanzate — consulta Errori di autenticazione.

Quando le Regole Avanzate non vengono eseguite

Un valore effettivo di disabled significa che le Regole Avanzate non sono effettivamente caricate nella scansione: non viene catturato alcuno screenshot per esse, nulla viene inviato a Deque per la valutazione e non vengono consumati crediti AI. I tuoi risultati standard di axe-core vengono restituiti esattamente come farebbero altrimenti.

Se hai richiesto un preset che non poteva essere soddisfatto perché le Regole Avanzate non sono disponibili per il tuo server, l'array messages della risposta lo indica:

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

Non viene emesso alcun messaggio quando non hai richiesto nulla: un default disabled dell'organizzazione è una scelta deliberata, non un problema da segnalare.

Degrado parziale

Le Regole Avanzate non falliscono mai una scansione. Se le regole vengono caricate ma la loro valutazione lato server incontra dei problemi, analyze restituisce i tuoi risultati standard di axe-core più un messaggio che descrive cosa è andato perso:

Disponibilità

Il server MCP di Axe è incluso nel pacchetto Axe DevTools per il Web, e le Regole Avanzate sono incluse con esso. Se hai accesso al server MCP di Axe, hai le Regole Avanzate — non c'è bisogno di un acquisto separato delle Regole Avanzate.

Una cosa può ancora renderle non disponibili: le Regole Avanzate sono valutate lato server, quindi il tuo deployment deve essere collegato all'infrastruttura AI di Deque. Le distribuzioni in cloud privato e on-premise necessitano dei servizi ML e LLM — consulta la Guida alla disponibilità delle funzionalità AI. I clienti SaaS sono connessi automaticamente.

Se le scansioni riportano "source": "unavailable" e ti aspetti che le Regole Avanzate siano disponibili, contatta il tuo Customer Success Manager. La disponibilità viene risolta quando il server si avvia, quindi riavvia il server MCP (o il tuo client MCP) dopo un cambiamento di abbonamento piuttosto che aspettarti che la scansione successiva lo rilevi.

Cosa viene inviato a Deque

Le Regole Avanzate sono l'unico caso in cui analyze invia dati della pagina ai server Deque. Quando un preset attivo viene risolto, la scansione:

1. Cattura uno screenshot dell'intera pagina nel browser e lo carica all'endpoint screenshot di Deque.
2. Invia il payload di valutazione del registratore — la struttura della pagina, gli stili calcolati e la geometria di cui le regole avanzate hanno bisogno — all'endpoint delle regole avanzate di Deque, dove i modelli ML e LLM lo valutano.
3. Unisce i risultati restituiti nei tuoi risultati.

La scansione axe-core standard non è influenzata: con Regole Avanzate disabled, lo strumento analyze non invia nulla a Deque oltre alle richieste di autenticazione e configurazione.

Crediti AI

Le Regole Avanzate che utilizzano modelli di linguaggio di grandi dimensioni consumano Crediti AI dalla tua allocazione mensile dell'organizzazione. Le organizzazioni con un abbonamento dedicato alle Regole Avanzate non vengono addebitate di crediti.

Quando il tuo saldo crediti è esaurito, le regole avanzate alimentate dall'IA vengono saltate e le rimanenti regole avanzate continuano a funzionare — la scansione non fallisce. Vedi Crediti AI per il monitoraggio e l'acquisto.

Tempo di scansione

Le Regole Avanzate aggiungono un tempo significativo a una scansione — tipicamente 15 a 20 secondi, oltre alla cattura e al caricamento degli screenshot. Se le tue scansioni iniziano a scadere dopo aver abilitato le Regole Avanzate, aumenta BROWSER_TIMEOUT_MS (vedi le Riferimento alla Configurazione) o usa disabled per l'iterazione e un preset attivo per un controllo finale.

Affidabilità

Poiché alcune regole avanzate usano l'IA, i risultati possono variare leggermente tra esecuzioni sulla stessa pagina. Un risultato riportato al 75% di fiducia potrebbe ottenere il 65% nella scansione successiva, il che può modificare se supera la tua soglia. I risultati possono variare anche tra macchine e ambienti, poiché sistema operativo, GPU e caratteristiche del display influenzano il rendering.

Tratta una differenza run-to-run nei risultati avanzati come una variazione prevista piuttosto che come una regressione. Vedi Limitazioni e Considerazioni per avere il quadro completo.

Relazione con altre impostazioni

• Le regole sperimentali sono indipendenti. advancedRules: "disabled" non disabilita regole experimental axe-core, e abilitare le regole sperimentali non bypassa il tuo preset di Regole Avanzate. Le due impostazioni si combinano.
• Non c'è un'opzione separata per la soglia di confidenza. La soglia è derivata dal preset, in accordo con la Configuration di Axe e l'estensione browser Axe DevTools.
• Lo standard di accessibilità, le migliori pratiche e le necessità di revisione sono ancora applicabili. I risultati avanzati sono filtrati dalle stesse impostazioni di Configuration di Axe dei risultati standard.