← Blog

Escreva o seu primeiro llms.txt: guia prático

2026-07-19 · Blog · llms-txthow-toai-readability

Um ficheiro llms.txt é um mapa Markdown conciso do conteúdo útil de um site, publicado na raiz. É uma convenção emergente e voluntária, não uma norma oficial da Web. Algumas ferramentas de IA podem ler o ficheiro quando recebem o seu URL, mas publicá-lo não garante descoberta, ingestão, citação, recomendação ou qualquer comportamento específico do assistente.

O que é llms.txt?

O ficheiro oferece um resumo selecionado do site: o que a organização faz e onde estão as páginas importantes. É normalmente publicado em https://example.com/llms.txt.

Ao contrário do robots.txt, não define permissões para rastreadores. Ao contrário de um sitemap, não precisa de listar todos os URLs. A sua finalidade prática é oferecer um guia curto, legível por pessoas e máquinas, para páginas de origem selecionadas.

Passo 1 — Dê um nome e resuma o site

Comece com um título H1 seguido de um resumo factual numa linha:

# Acme Scheduling
> Online appointment scheduling for clinics, salons, and studios.

Use o nome real da organização ou do produto. Evite slogans, superlativos não comprovados e promessas. O leitor deve compreender a categoria e o público sem ter de adivinhar.

Passo 2 — Acrescente um breve contexto

Em duas a quatro frases, explique:

• a quem se destina o serviço;
• o que ajuda essas pessoas a fazer;
• qual é o âmbito geográfico ou do produto; e
• qualquer limitação importante que o leitor deva conhecer.

Escreva informações que continuem corretas quando citadas fora de contexto. Se um facto mudar frequentemente, como preço ou disponibilidade, ligue à fonte mantida em vez de duplicar detalhes que podem ficar desatualizados.

Passo 3 — Selecione as páginas essenciais

Agrupe os links importantes sob títulos H2 claros e acrescente uma descrição curta e factual a cada um:

## Product and support
- [Getting started](https://acme.com/docs/start): Set up a first calendar.
- [Pricing](https://acme.com/pricing): Current plans, limits, and billing terms.
- [Help center](https://acme.com/help): Setup and troubleshooting articles.

## Optional
- [Blog](https://acme.com/blog): Product updates and scheduling guides.

Prefira páginas de origem canónicas em vez de todos os URLs de campanha. Se usar uma secção Optional, reserve-a para material útil, mas não essencial.

Passo 4 — Publique com cuidado

Guarde o ficheiro como texto simples UTF-8 e disponibilize-o em /llms.txt. Confirme:

• que o URL público devolve o ficheiro pretendido sem início de sessão;
• que todas as páginas ligadas carregam e usam o URL canónico preferido;
• que o resumo corresponde à oferta atual;
• que não existem endpoints privados, credenciais, dados de clientes ou material não publicado; e
• que a autorização normal continua a aplicar-se a qualquer ação protegida.

Um ficheiro llms.txt é documentação pública. Nunca deve ser utilizado para conceder acesso ou transmitir segredos.

Passo 5 — Teste o comportamento observável

Abra diretamente o URL público e depois entregue-o aos assistentes relevantes para o seu público. Peça a cada um que resuma a empresa e identifique as páginas de origem utilizadas. Registe assistente, modelo, data, instrução, resposta e limitações.

Uma resposta útil mostra que o ficheiro foi legível nesse teste. Não prova que o assistente irá descobri-lo automaticamente, usá-lo noutra sessão, citá-lo ou recomendar a empresa.

Passo 6 — Mantenha o ficheiro

Reveja llms.txt quando mudarem páginas principais, posicionamento, preços, políticas ou disponibilidade. Remova links inativos e declarações contraditórias. Atribua um responsável e uma data de revisão para evitar uma segunda versão desatualizada do site.

O que llms.txt não pode fazer

O ficheiro pode organizar informações descritivas da fonte. Por si só, não pode:

• autorizar um assistente ou utilizador;
• garantir que um sistema de IA o obtém ou nele confia;
• realizar uma inscrição, reserva, compra, configuração ou alteração de conta;
• substituir uma API, interface, controlo de segurança ou termos de serviço; ou
• garantir classificação SEO, citação por IA, recomendação, tráfego ou conversão.

O assistente pode utilizar as páginas ligadas ou outras fontes e aplica as suas próprias políticas e salvaguardas.

Uma possível camada para passos suportados

Depois de encontrar e avaliar um serviço, o cliente pode pedir ao assistente ajuda com um próximo passo suportado. O modelo de camada operacional da Share with My Agent publica para esse momento contexto de primeira fonte, orientações de consentimento e descrições dos passos suportados.

Este modelo complementa llms.txt; não é uma norma oficial nem torna uma página “totalmente pronta para agentes”. O utilizador mantém o controlo, as regras de autorização do serviço continuam a aplicar-se e o assistente decide o que pode apoiar em segurança.

Execute a análise gratuita para rever o que um assistente pode atualmente aprender com a sua página. Depois pode publicar gratuitamente um URL estruturado, sem método de pagamento. Para mais páginas ou sites de clientes, entre na lista de espera.

Perguntas frequentes

Onde deve ser publicado llms.txt?

A convenção proposta utiliza a raiz do site: https://example.com/llms.txt. Confirme que a resposta é texto simples legível publicamente e que os links usam os URLs de produção pretendidos.

llms.txt afeta a classificação no Google?

Não o trate como sinal de classificação nem prometa uma vantagem de SEO. Meça a sua utilização separadamente do desempenho da pesquisa orgânica.

Continuo a precisar do conteúdo normal do site?

Sim. llms.txt é um guia para páginas de origem mantidas, não um substituto. Páginas exatas de produto, apoio, preços, políticas e contacto continuam a ser o conteúdo autorizado.

Devo publicar llms.txt e uma camada operacional?

Respondem a necessidades diferentes. llms.txt pode resumir e ligar conteúdo descritivo. Uma camada operacional pode descrever expectativas de consentimento e passos suportados. Publique apenas informações exatas, teste o comportamento observado e não presuma utilização universal.

Continue a ler

https://swma.link/3c8d06d7