Pular para o conteúdo

5 Regras de Nomeação HTML para Facilitar a Tomada de Decisão de Agentes de IA via UI

5 Regras de Nomeação HTML para Facilitar a Tomada de Decisão de Agentes de IA via UI

Quando um agente de IA (como o MultiOn ou um agente de navegador baseado em GPT-4o) acessa seu site, ele foca na estrutura do código, não nos pixels. Enquanto um usuário humano identifica um botão 'Comprar' pela cor e posição em milissegundos, para um agente de IA, <button id="btn-382"> não significa nada. Se o agente precisar analisar toda a árvore DOM e os textos ao redor para entender a função desse botão, o custo operacional (uso de tokens) aumenta e o risco de ações incorretas (alucinações) cresce.

Otimizar a navegação de agentes de IA não é apenas uma questão de SEO, mas de sobrevivência na era da 'Agentic Web'. LLMs (Grandes Modelos de Linguagem) precisam deduzir a função de um elemento HTML a partir de seu nome. Neste guia, examinaremos 5 regras técnicas de nomenclatura que garantirão que os agentes operem em seu site sem se perderem.

1. Aplique o Padrão Ação-Objeto (Action-Object)

Agentes de IA tentam entender o que os elementos de uma página 'fazem'. Em vez de IDs gerados aleatoriamente (ofuscados), você deve usar uma estrutura que identifique a ação e o objeto afetado. Por exemplo, para um botão de carrinho, usar id="add-to-cart-button" em vez de id="cart-1" permite que o agente associe instantaneamente a ação 'add' (adicionar) ao objeto 'cart' (carrinho).

Esta regra não vale apenas para botões, mas também para campos de formulário. Usar name="search-query" em vez de name="q" em uma caixa de busca deixa claro o que o agente deve inserir ali. LLMs seguem o contexto semântico; por isso, combinações de verbos e substantivos encurtam os passos de 'raciocínio' (reasoning) dos agentes.

2. Incorpore o Contexto Hierárquico no ID

Pode haver mais de um botão 'Enviar' em uma página: um para inscrição em newsletter, outro para formulário de contato. Ao escanear o DOM, o agente de IA pode confundir esses dois botões. A nomenclatura hierárquica informa ao agente de qual seção o elemento faz parte. A diferença entre id="footer-newsletter-submit" e id="contact-form-submit" impede que o agente preencha o formulário errado.

Tecnicamente, refletir a hierarquia que usamos nos seletores CSS nos atributos ID e Name evita que o agente se perca na 'profundidade da árvore DOM'. O agente pode entender onde está apenas pelo nome do elemento, sem precisar verificar os nós pais (parent). Isso afeta diretamente a velocidade de navegação.

3. Evite Abreviações e Use Palavras Completas

Desenvolvedores costumam usar abreviações como btn-sub, nav-lnk ou usr-pref para reduzir o tamanho do arquivo ou escrever código rapidamente. No entanto, para LLMs, a palavra 'sub' pode significar 'subscribe', 'submit', 'substitute' ou 'subject'. Para a eficiência da navegação de agentes de IA, a ambiguidade é o maior inimigo.

Usar palavras completas (id="navigation-link-home") garante que o agente encontre o resultado mais próximo do significado correto durante o processo de 'embedding' (vetorização). Lembre-se, os agentes leem seu código como um documento de texto. Quanto mais 'legível' (human-readable) for seu código, mais 'processável' (machine-processable) ele será para a inteligência artificial.

4. Garanta Compatibilidade com Schema.org e Atributos Name Padrão

Modelos de IA foram treinados com uma grande parte da internet. Dentro desses dados de treinamento, padrões de dados estruturados como Schema.org e padrões HTML amplamente utilizados são predominantes. Ao definir o atributo name em elementos de formulário, siga os padrões de preenchimento automático (autocomplete) dos navegadores e as propriedades do Schema.

  • Para o campo de nome completo: name="full-name" ou name="name"
  • Para e-mail: name="email"
  • Para telefone: name="telephone" ou name="phone"

Esses nomes padrão permitem que o agente deduza que 'este campo provavelmente espera um e-mail'. Usar nomes personalizados (custom) (ex: name="user_mail_address_field") faz com que o agente hesite e precise realizar análises adicionais.

5. Inclua Indicadores de Estado (State Indicators)

Agentes de IA gerenciam não apenas páginas estáticas, mas também interfaces dinâmicas. Eles precisam entender se um menu está aberto ou fechado, ou se um botão está desativado (disabled). Atributos de acessibilidade como aria-expanded são valiosos, mas refletir esse estado nos nomes de IDs ou classes fornece uma confirmação dupla ao agente.

Por exemplo, nomes como id="faq-item-1-active" para um elemento de menu sanfona ou id="submit-button-loading" para um estado de carregamento permitem que o agente desenvolva uma compreensão 'não visual' sobre o estado atual da página. Isso ajuda especialmente agentes que manipulam o DOM a planejar o próximo passo.

Lista de Verificação Técnica

  • Todos os elementos interativos (button, input, a) possuem um ID único e descritivo?
  • Os atributos ID e Name seguem a estrutura 'ação-objeto'?
  • Foram usadas palavras completas em vez de abreviações?
  • Os campos de formulário possuem atributos name que correspondem aos valores padrão de 'autocomplete'?
  • A seção onde o elemento está localizado (header, footer, sidebar) foi especificada na nomenclatura?

Exemplo de Cenário: Má Prática vs. Boa Prática

Os blocos de código abaixo representam uma área de filtragem em um site de e-commerce. Compare em qual deles o agente de IA consegue decidir mais rápido.

<!-- RUIM: O agente de IA precisa olhar para as div's superiores para entender o que este botão filtra -->
<div class="filter-box">
  <input type="checkbox" id="c1" name="cat" value="12">
  <label for="c1">Eletrônicos</label>
</div>

<!-- BOM: O agente de IA entende o que fazer apenas olhando para o input -->
<div class="category-filter-section">
  <input type="checkbox" id="category-checkbox-electronics" name="filter-category-electronics">
  <label for="category-checkbox-electronics">Eletrônicos</label>
</div>

Erros Comuns

  • Atribuição Aleatória de ID: IDs como _ngcontent-c12 gerados automaticamente por frameworks modernos (React, Vue) são 'ruído' para os agentes.
  • Nomes Excessivamente Longos: Criar IDs de 200 caracteres em nome da clareza pode sobrecarregar os limites de tokens.
  • Nomenclatura Apenas Visual: Em vez de id="red-button", deve-se usar id="cancel-order-button". A cor é uma informação secundária para a decisão funcional do agente.

Perguntas frequentes

Agentes de IA não leem apenas atributos aria-label?

Não, agentes de IA e LLMs analisam toda a árvore DOM (estrutura HTML). O aria-label é um sinal muito forte, mas os atributos id e name são os pontos de referência fundamentais para o agente selecionar o elemento e enviar dados de formulário.

Alterar nomes de ID afeta o SEO?

Não afeta diretamente o ranking do Google, mas é uma otimização crítica para 'AI Search' e 'Agentic Web'. Além disso, se você usa links âncora na página, precisará atualizar esses links também.

Como evitar IDs gerados automaticamente por frameworks?

Em bibliotecas como React ou Vue, você deve passar manualmente a prop 'id' para elementos de interação crítica (botões, formulários). IDs gerados automaticamente geralmente são dinâmicos, o que dificulta o reconhecimento desses elementos pelos agentes de IA em visitas futuras.

Escaneie seu site grátis