Falta llms.txt numa auditoria de IA: o que significa o aviso
Verifique o URL exato, a resposta HTTP e o objetivo da auditoria antes de tratar a ausência de llms.txt como um problema de pesquisa com IA.
Imagine que uma auditoria de IA apresenta um cartão vermelho para o seu site: «Falta llms.txt». Antes de adicionar um ficheiro para eliminar o aviso, abra o resultado e identifique o URL e a verificação que o produziram. A ausência de um índice opcional, uma página de erro HTML devolvida como sucesso e uma falha do servidor exigem decisões diferentes. Nenhuma dessas observações, por si só, lhe diz se uma resposta de IA irá citar o seu site.
Saiba o que a verificação mede
Guarde o nome e a versão da ferramenta, a data, o aviso exato e o URL testado. Leia a documentação dessa verificação. Quando verificámos as fontes, em 9 de novembro de 2026, a documentação llms.txt do Lighthouse indicava que um erro do servidor é assinalado e que um ficheiro ausente com resposta 404 é classificado como Não aplicável. Descrevia o ficheiro como opcional. Outra ferramenta pode apenas indicar se encontrou um ficheiro. A etiqueta vermelha não altera o que esse pedido realmente devolveu.
Para os Resumos com IA e o Modo IA do Google, o Google indica que não é necessário um novo ficheiro de texto para IA. Isto responde a uma questão de elegibilidade na Pesquisa Google. Não determina como todos os outros assistentes tratam um índice. Separe o critério da auditoria do requisito da plataforma ao decidir o que corrigir.
Leia a resposta por trás do resultado
Abra o URL exato que a auditoria verificou. Para inspecionar o pedido no Chrome, abra o painel Rede, volte a carregar o URL e selecione o respetivo pedido. Veja o método do pedido, o URL final após os redirecionamentos, o estado, os cabeçalhos e o corpo em «Response». Um pedido HEAD ou um cabeçalho Content-Type, por si só, não mostra o que um GET devolveu.
Considere um site de documentação fictício, docs.example. O seu /llms.txt devolve 404, mas /docs/llms.txt devolve um índice em Markdown. A proposta llms.txt atual permite ficheiros na raiz ou num subcaminho, abrangendo páginas abaixo desse caminho. Uma auditoria limitada à raiz não inspecionou o índice da documentação. Trata-se de uma diferença de âmbito, não de uma prova de que é preciso duplicar o ficheiro na raiz. Verifique onde o cliente que vai usar o ficheiro o procura antes de mudar a localização.
Suponha agora que /llms.txt devolve HTTP 200, mas o corpo é uma página HTML de «Página não encontrada» com o aspeto do site. Uma verificação baseada apenas no estado pode considerar isso um sucesso. Registe o resultado real: o URL devolveu uma página de erro HTML, não o índice Markdown pretendido. Peça a quem gere o encaminhamento que investigue essa resposta. Se receber antes uma página inicial, uma página de início de sessão ou um desafio de acesso, registe esse resultado; o cabeçalho text/html, por si só, não permite distingui-los.
Se o pedido devolver 500, registe um erro do servidor. Isso não demonstra que o ficheiro está em falta. Se devolver Markdown legível, inspecione também o conteúdo e as ligações. A proposta exige um título de projeto ou site, mas um título, por si só, não mostra que o índice descreve o site atual ou aponta para páginas úteis.
Decida a quem se destina o ficheiro
Um índice de documentação atualizado pode dar a uma pessoa ou a um agente um caminho curto até ao material relevante. A OpenAI publica um para a sua documentação de programação. Isto mostra que existe um índice publicado. Não estabelece um requisito para outros sites nem mostra que o ChatGPT Search vai buscar os respetivos ficheiros.
Se tiver um cliente ou fluxo de trabalho de documentação específico que vá usar o ficheiro, identifique as páginas que deve encontrar. Mantenha o resumo correto, siga as ligações e confirme que os destinos estão atualizados e legíveis. Inclua o índice no processo de atualização quando essas páginas mudarem de localização. Um site pequeno também pode ter esse caso de uso.
Se o objetivo for apenas permitir que as funcionalidades de IA do Google encontrem uma página que já é útil, o aviso de ficheiro em falta não estabeleceu um novo requisito. Verifique os problemas reais de acesso e conteúdo da página com o guia de bases de conteúdo e técnicas. Adicionar um índice não demonstra que a página ligada está acessível ou que as suas afirmações são claras.
Conclua a correção com provas observáveis
No site fictício, suponha que corrige uma ligação em /docs/llms.txt que apontava para um guia de configuração eliminado. Reabra o índice, siga a ligação corrigida e confirme que o guia esperado carrega. Repita a auditoria original com a mesma versão da ferramenta, registe a hora e confirme que está a ver o resultado da nova execução. Se continuar a verificar apenas /llms.txt, o resultado pode manter-se mesmo que a ligação da documentação esteja corrigida.
Mantenha um registo preciso da conclusão: «O índice de documentação liga ao guia de configuração atual; a verificação do ficheiro na raiz continua a apresentar o seu próprio resultado». Um pedido registado mais tarde mostra apenas o que esse registo contém, não que um modelo usou o conteúdo. Uma citação exige observar uma resposta. O efeito desta alteração nas citações, visitas ou conversões continua por verificar enquanto não houver provas desses resultados.