Regras Avançadas

Regras Avançadas são um conjunto de testes automatizados de acessibilidade que utilizam capturas de tela, visão computacional e grandes modelos de linguagem para detectar problemas que o padrão axe-core não consegue — como cabeçalhos que apenas parecem ser cabeçalhos, imagens informativas com texto alternativo não útil, e contraste de texto sobre gradientes ou imagens.

A ferramenta analyze pode executar Regras Avançadas ao lado do conjunto de regras padrão do axe-core. Quando isso ocorre, os resultados avançados são mesclados na mesma matriz de resultados que seu agente já consome, de modo que não é necessário alterar seus prompts ou fluxo de trabalho.

As Regras Avançadas são regidas pela Configuração do Axe da sua organização e — onde o administrador permite — podem ser substituídas por servidor ou por varredura.

Valores predefinidos aceitos

Regras Avançadas que utilizam IA relatam uma pontuação de confiança em vez de um resultado definitivo de aprovação ou reprovação, e uma predefinição define o limite a partir do qual um achado é relatado. Para saber o que cada predefinição significa e como escolher entre elas, consulte Controles de Confiança — os limites são idênticos em todos os produtos que executam as Regras Avançadas.

Sempre que o Axe MCP Server aceita uma predefinição — o argumento da ferramenta advancedRules ou a variável de ambiente AXE_ADVANCED_RULES — estes são os valores que reconhece:

Os valores não diferenciam maiúsculas de minúsculas e os espaços em volta são ignorados, então " Balanced " e "BALANCED" ambos se resolvem para balanced. Não há alias em percentual para disabled.

Escolhendo uma predefinição

Há três maneiras de definir a predefinição. Quando mais de uma está presente, a de maior precedência prevalece:

1. O argumento da ferramenta advancedRules — por varredura
2. A variável de ambiente AXE_ADVANCED_RULES — por servidor
3. Padrão de Configuração do Axe da sua organização — por organização

Independente da fonte utilizada, o valor resolvido é relatado na bloco advancedRules da resposta, para que seu agente possa sempre ver qual predefinição realmente executou.

Padrão da organização

O padrão da sua organização vem da configuração Regras Avançadas Padrão em Configuração do Axe, que um administrador gerencia no Portal de Contas do Axe. Essa página documenta as opções disponíveis e a caixa de seleção “Permitir que os usuários alterem” que decide se as duas substituições abaixo são permitidas.

Duas coisas específicas para o Axe MCP Server:

• O servidor lê a Configuração do Axe em cada chamada de cada analyze, então uma alteração feita pelo seu administrador entra em vigor na sua próxima varredura — não é necessário reiniciar o servidor ou o cliente.
• Se a configuração estiver bloqueada, a variável de ambiente e o argumento da ferramenta são silenciosamente ignorados e a resposta informa "source": "org_policy_locked", para que você possa saber que uma substituição foi descartada em vez de aplicada.

variável de ambiente AXE_ADVANCED_RULES

Configure AXE_ADVANCED_RULES na configuração do seu servidor MCP para escolher uma predefinição para cada varredura que o servidor executar. Este é o local correto para uma escolha em toda a equipe ou projeto que não precisa ser repetida em cada prompt.

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

Consulte o Referência de Configuração para obter detalhes, e o guia de configuração do cliente para saber onde o bloco env está no seu cliente.

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

argumento da ferramenta advancedRules

Passe advancedRules para uma única chamada de analyze para substituir a predefinição apenas para aquela varredura. Instrua seu agente de IA em linguagem natural — o agente traduz sua intenção para a chamada da ferramenta:

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

O agente chama a ferramenta analyze com um payload semelhante a:

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

Um valor inválido aqui é um erro de validação de esquema por chamada que nomeia os valores aceitos; isso não afeta o servidor ou chamadas subsequentes.

Use o argumento tool quando quiser uma desvio pontual — por exemplo thorough em uma página que você está auditando ativamente, ou disabled em uma página grande onde você só deseja resultados rápidos e padrão:

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

O bloco de resposta advancedRules

Cada resposta analyze inclui um bloco advancedRules relatando o predefinido que realmente foi executado e de onde ele veio:

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

value é sempre um dos quatro predefinidos. source explica como esse valor foi alcançado:

Comportamento de falha fechada

O Servidor Axe MCP nunca adivinha um predefinido. Se a Configuração Axe estiver acessível, mas a configuração de Regras Avançadas estiver ausente, ou tiver um valor que esta versão do servidor não reconhece, o escaneamento reporta "value": "disabled", "source": "unavailable" e executa apenas o padrão axe-core, não costuma não recorrer a um predefinido codificado em hard. Isso evita que uma discrepância de versão entre o seu servidor e o Portal de Contas Axe aplique silenciosamente um limite que ninguém escolheu.

Se a Configuração Axe não puder ser obtida de forma alguma (falha de rede, credenciais inválidas), a chamada analyze falha completamente, em vez de escanear com configurações desconhecidas. Esse é um comportamento existente para todas configurações, não específico para Regras Avançadas — veja Erros de autenticação.

Quando Regras Avançadas não rodam

Um valor efetivo de disabled significa que as Regras Avançadas não foram realmente carregadas no escaneamento: nenhuma captura de tela é feita para elas, nada é enviado para a Deque para avaliação, e nenhum crédito de IA é consumido. Seus resultados padrão axe-core são retornados exatamente como seriam de outra forma.

Se você solicitou um predefinido que não pôde ser honrado porque as Regras Avançadas não estão disponíveis para o seu servidor, o array messages da resposta informa isso:

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

Nenhuma mensagem é emitida quando você não solicitou nada — um padrão organizacional disabled é uma escolha deliberada, não um problema para relatar.

Degradação parcial

As Regras Avançadas nunca falham em um escaneamento. Se as regras forem carregadas, mas sua avaliação no lado do servidor enfrentar problemas, analyze retorna seus resultados padrão axe-core mais uma mensagem descrevendo o que foi perdido:

Disponibilidade

O Servidor Axe MCP está incluído no pacote Axe DevTools para Web, e as Regras Avançadas vêm com ele. Se você tem acesso ao Servidor Axe MCP, você tem as Regras Avançadas — não há uma compra separada para Regras Avançadas a ser feita.

Uma coisa ainda pode deixá-las indisponíveis: as Regras Avançadas são avaliadas no lado do servidor, então sua implantação deve estar conectada à infraestrutura de IA da Deque. Implantações em nuvem privada e locais precisam dos serviços ML e LLM — veja o Guia de Disponibilidade de Recursos de IA. Clientes SaaS são conectados diretamente.

Se os escaneamentos reportarem "source": "unavailable" e você esperar que as Regras Avançadas estejam disponíveis, entre em contato com seu Gerente de Sucesso do Cliente. A disponibilidade é resolvida quando o servidor é iniciado, então reinicie o servidor MCP (ou seu cliente MCP) após uma alteração de assinatura em vez de esperar que o próximo escaneamento identifique a alteração.

O que é enviado para a Deque

As Regras Avançadas são o único caso em que analyze envia dados da página para os servidores da Deque. Quando um predefinido ativo é resolvido, o escaneamento:

1. Captura uma captura de tela da página inteira no navegador e a envia para o ponto de captura de tela da Deque.
2. Envia a carga de avaliação do gravador — a estrutura da página, os estilos computados e a geometria que as regras avançadas precisam — para o endpoint de regras avançadas da Deque, onde os modelos ML e LLM a avaliam.
3. Mescla os resultados retornados nos seus resultados.

O escaneamento padrão axe-core não é afetado: com Regras Avançadas disabled, a ferramenta analyze não envia nada para a Deque além de solicitações de autenticação e configuração.

Créditos de IA

Regras Avançadas que usam modelos de linguagem de grande escala consomem Créditos de IA da alocação mensal da sua organização. Organizações com uma assinatura dedicada para Regras Avançadas não são cobradas por créditos.

Quando o saldo de crédito se esgota, as regras avançadas impulsionadas por IA são ignoradas e as demais regras avançadas ainda são executadas — a verificação não falha. Veja Créditos de IA para monitoramento e compra.

Tempo de verificação

Regras Avançadas adicionam tempo significativo a uma verificação — tipicamente 15 a 20 segundos, além da captura de tela e upload. Se suas verificações começarem a expirar após ativar Regras Avançadas, aumente BROWSER_TIMEOUT_MS (veja o Referência de Configuração) ou use disabled para iteração e um predefinido ativo para uma verificação final.

Confiabilidade

Como algumas regras avançadas utilizam IA, os resultados podem variar ligeiramente entre execuções na mesma página. Um achado relatado com 75% de confiança pode marcar 65% na próxima verificação, o que pode mudar se atende ao seu limiar. Os resultados também podem variar entre máquinas e ambientes, já que sistema operacional, GPU e características de exibição afetam o renderização.

Considere uma diferença entre execuções em achados avançados como uma variação esperada em vez de uma regressão. Veja Limitações e Considerações para uma visão completa.

Relação com outras configurações

• Regras experimentais são independentes. advancedRules: "disabled" não desativa regras experimentais do axe-core, e habilitar regras experimentais não ignora seu predefinido de Regras Avançadas. As duas configurações se combinam.
• Não há uma opção de limiar de confiança separada. O limiar é derivado do predefinido, correspondendo à Configuração Axe e à Extensão do Navegador Axe DevTools.
• Padrão de acessibilidade, melhores práticas e necessidade de revisão ainda se aplicam. Os achados avançados são filtrados pelas mesmas configurações de Configuração Axe que os achados padrão.