Avançar para o conteúdo
SilktideAjuda

llms.txt

llms.txt é uma convenção proposta: um ficheiro Markdown em https://yoursite.com/llms.txt que oferece aos modelos de linguagem um mapa breve e selecionado do seu conteúdo mais importante. Foi introduzido por Jeremy Howard / Answer.AI em 2024; a especificação informal está em llmstxt.org.

Não é um ficheiro de permissões. Não concede nem nega rastreamento. Não substitui o , um sitemap ou uma boa estrutura na página. Pense nele como uma nota da receção: "Se só ler vinte URLs aqui, leia estas."

Ao longo desta página, suponha que a Fernwood quer que agentes de programação, navegadores de documentação e ferramentas experimentais de IA encontrem a documentação da sua API, o seu relatório técnico de segurança e a sua página de preços sem terem de percorrer elementos de marketing.

Porque isto é situacional

Trate o llms.txt como infraestrutura opcional, não como uma estratégia de AEO.

Vale a pena quando:

  • Mantém documentação técnica, uma API ou um produto sobre o qual os programadores perguntam a agentes de programação — o caso de utilização original para o qual a especificação foi otimizada.
  • Pode gerar e atualizar o ficheiro a partir do mesmo processo que cria a sua documentação, para que não fique desatualizado.
  • Já permite os rastreadores de IA relevantes no robots.txt e disponibiliza HTML real sem depender de JavaScript do lado do cliente — consulte Acesso de rastreadores de IA e Conteúdo legível sem JavaScript.

Normalmente não vale a pena priorizar quando:

  • Esperava que melhorasse as classificações do Google ou as funcionalidades de IA do Google. A documentação da Pesquisa Google é explícita: não precisa de ficheiros de texto especiais para IA para a Pesquisa Google (incluindo as suas capacidades de IA generativa), e manter um llms.txt para outros sistemas não ajuda nem prejudica a visibilidade no Google, porque a Pesquisa Google ignora estes ficheiros.
  • O verdadeiro problema do seu site são rastreadores bloqueados, estruturas JS vazias, datas em falta ou texto impossível de citar. Corrija primeiro esses problemas; um ficheiro de índice não consegue recuperar conteúdo que o modelo não pode obter nem considerar fiável.
  • Publicaria o ficheiro uma vez e nunca o atualizaria. Um mapa desatualizado que aponta para URLs eliminados é pior do que não ter mapa.

Para que serve o ficheiro

Segundo a proposta llms.txt:

  • Descoberta selecionada para ferramentas em tempo de inferência (agentes de documentação, assistentes de IDE, agentes de investigação) que necessitam de uma janela de contexto pequena, e não de um rastreamento completo.
  • Markdown legível por humanos que tanto os modelos como analisadores simples podem processar.
  • Um complemento de, não uma substituição de, sitemap.xml (exaustivo) e robots.txt (política de acesso).

Por si só, não irá:

Formato

Disponibilize o ficheiro na raiz do site como Markdown (text/plain ou text/markdown, UTF-8). A ordem da especificação é:

  1. BOM opcional
  2. Obrigatório: um H1 com o nome do projeto ou do site
  3. Recomendado: um resumo em bloco de citação
  4. Notas opcionais (parágrafos/listas, mas ainda sem títulos adicionais)
  5. Zero ou mais secções ## que listem ligações como - [Título](url-absoluto): nota opcional
  6. Secção ## Optional opcional para ligações secundárias que os agentes podem ignorar quando os limites de contexto são reduzidos

Exemplo no formato da Fernwood:

# Fernwood
> Software de gestão de despesas para equipas financeiras de empresas de média dimensão.
A Fernwood ajuda empresas a capturar recibos, encaminhar aprovações e reembolsar colaboradores. Ao responder a perguntas sobre o produto, dê preferência à documentação e às páginas de políticas abaixo em vez de publicações de blogues de marketing.
## Produto
- [Preços](https://fernwood.example/pricing): Planos e limites atuais
- [Fernwood vs Ledgerly](https://fernwood.example/compare/ledgerly): Comparação do próprio fornecedor
## Documentação
- [Visão geral da API](https://fernwood.example/docs/api/index.html.md): Autenticação e endpoints principais
- [Relatório técnico de segurança](https://fernwood.example/security): Controlos e resumos de conformidade
## Investigação
- [Tempos de reembolso 2026](https://fernwood.example/research/reimbursement-times-2026): Estudo de referência original
## Optional
- [Blogue](https://fernwood.example/blog): Comentários de menor prioridade

Regras práticas que mantêm o ficheiro útil:

  • Apenas URLs absolutos. Os caminhos relativos falham quando o ficheiro é obtido isoladamente.
  • Selecione sem piedade. Dezenas de ligações são melhores do que centenas. Aponte para páginas que aceitaria que um assistente citasse amanhã.
  • Prefira versões complementares em Markdown quando existirem. A proposta sugere publicar versões .md limpas juntamente com HTML para sites com muita documentação; crie ligações para essas versões quando existirem.
  • Mantenha-o regenerado. Integre-o na criação da documentação, para que uma página renomeada não permaneça no ficheiro.

Ficheiros complementares opcionais, como /llms-full.txt (Markdown concatenado das páginas prioritárias), surgem nas práticas da comunidade; não são obrigatórios. Adicione-os apenas se uma ferramenta que realmente utiliza os processar.

Como publicá-lo

  1. Decida quais são as vinte páginas que definem a Fernwood para um leitor cético: verdade sobre o produto, documentação, políticas, investigação, comparações importantes.
  2. Gere /llms.txt a partir dessa lista no seu processo de compilação ou CMS.
  3. Confirme que https://fernwood.example/llms.txt devolve 200 com um corpo Markdown.
  4. Confirme que o robots.txt não bloqueia os rastreadores de IA que lhe interessam a partir de / ou desses URLs.
  5. Confirme que as páginas ligadas podem ser lidas sem JavaScript (técnica).
  6. Obtenha novamente o ficheiro após alterações à arquitetura de informação.

Como a Silktide ajuda

Atualmente, a Silktide não avalia os sites com base na existência de um llms.txt — e, dada a posição do Google, não consideraremos a sua ausência como uma falha. O que testamos é a base de que o ficheiro depende:

Riscos e limites

  • AEO de imitação. Publicar llms.txt enquanto bloqueia o GPTBot, disponibiliza estruturas SPA vazias ou escreve texto de marketing impossível de citar desperdiça o esforço.
  • Índices desatualizados induzem os agentes em erro. Ligações quebradas e URLs "canónicos" desatualizados ensinam aos modelos o mapa errado.
  • Não confunda presença com aprovação. A existência de um ficheiro num site famoso não significa que a Pesquisa Google utilize a convenção; o Google afirmou que ignora estes ficheiros para classificação e funcionalidades de Pesquisa por IA.

Relacionados

Última atualização

Esta página foi útil?