Comércio agêntico
llms.txt
llms.txt é uma convenção que coloca um arquivo markdown na raiz de um site que resume o que o site é e qual URL responde a qual pergunta, para que os assistentes não precisem rastrear tudo.
Se os principais assistentes o consomem ainda é genuinamente incerto. O que está resolvido é a adoção: verificamos 58 marcas DTC bem conhecidas e 73% das acessíveis já publicam um — mas 70% delas não o escreveram, porque a Shopify gera um arquivo de modelo automaticamente. Publicar um é, portanto, um requisito básico em vez de uma vantagem.
Isso move a questão útil de ter um para se o padrão te descreve. Um arquivo gerado de 4.3KB descreve uma loja genérica; ele não sabe quais produtos importam, quais perguntas seus compradores fazem, ou o que te separa das vinte e duas outras marcas que publicam um documento quase idêntico.
A única regra que decide se vale a pena: gere-o, não o escreva manualmente. Um índice mantido manualmente deteriora-se em duas implantações, e um índice desatualizado é pior do que nenhum porque aponta com confiança para páginas que foram movidas.
Agora há evidências para essa regra além da desatualização. Entre as lojas que encontramos aceitando um checkout de agente, várias publicam um arquivo escrito manualmente que nunca nomeia os endpoints que sua própria loja responde — então o arquivo que uma equipe cuidadosa escreveu esconde uma capacidade que o gerado anuncia. Leia o que está nesse caminho antes de substituí-lo.
Como o arquivo se parece
A proposta descreve um documento markdown em vez de uma nova sintaxe para aprender. Ele começa com um cabeçalho de nível um contendo o nome do site ou projeto, seguido por uma breve citação em bloco dizendo o que o site é — o único parágrafo que um leitor sem outro contexto precisa. Prosa comum pode segui-lo.
Abaixo disso vêm seções de nível dois, cada uma contendo uma lista de links com uma breve nota para cada um: o que a página é, e quando é a página certa. Uma seção convencionalmente reservada para material opcional marca links que podem ser ignorados quando um contexto mais curto é necessário, que é a única priorização que o próprio formato carrega.
Uma convenção complementar coloca um arquivo expandido em um caminho separado, contendo o próprio conteúdo em vez de um índice de links. Os dois servem a necessidades diferentes: um orienta um leitor que nunca viu o site, o outro fornece texto sem a interface de navegação ao redor.
O formato é deliberadamente comum. Tudo o que é importante sobre a convenção é editorial — quais páginas você nomeia e como as descreve — porque não há mais nada nele para errar.
Onde ele se encaixa entre os arquivos voltados para máquinas
A confusão que custa algo às equipes não é sobre o formato, é sobre o que o arquivo governa. Colocá-lo ao lado das outras superfícies que uma loja publica para máquinas torna o limite óbvio.
A última linha é todo o argumento. Três deles têm consumidores documentados e consequências definidas; o quarto não tem nenhum, o que é simultaneamente o argumento para publicar um e o argumento contra gastar um projeto nele.
| Superfície | O que ele declara | Consumidores documentados | O que dá errado se estiver errado |
|---|---|---|---|
| robots.txt | Quais crawlers podem buscar quais caminhos | Todo crawler principal documenta que o respeita | Um 'disallow' descuidado te remove completamente dos motores de resposta |
| sitemap.xml | Quais URLs existem e quando foram alteradas | Motores de busca documentam a leitura dele | Descoberta lenta ou perdida de páginas novas e alteradas |
| schema.org JSON-LD | Quais são os fatos nesta página | Motores de busca documentam o uso dele para resultados ricos | Um preço ou disponibilidade desatualizados produzem respostas erradas com confiança |
| llms.txt | O que o site é e qual URL responde o quê | Nenhum fornecedor de assistente documentou o consumo dele | Muito pouco — o que também é o argumento honesto contra o esforço |
O que ele não pode fazer
Três capacidades são regularmente atribuídas a este arquivo que ele não possui, e cada uma tem um lugar correto diferente. Entendê-las errado é como uma equipe passa a acreditar que estabeleceu uma política quando escreveu um resumo.
- Ele não concede nem retém nada. Não há sintaxe de diretiva e nenhuma semântica de permissão, portanto, ele não pode bloquear um crawler. A permissão é robots.txt para crawlers que o respeitam, e uma regra de borda para aqueles que não o fazem.
- Ele não substitui dados estruturados. Um índice de URLs não diz nada sobre o preço ou a disponibilidade na página para a qual aponta. Os fatos pertencem à marcação na própria página, gerados da mesma fonte da qual a página é renderizada.
- Não é um sitemap. Um sitemap enumera cada URL para completude; este arquivo seleciona alguns e os explica. Reproduzir o sitemap aqui descarta a única coisa que o formato oferece, que é o julgamento editorial sobre o que importa.
O que verificar no seu próprio domínio
A maioria das lojas já serve um sem que ninguém tenha decidido, porque várias plataformas o geram. Isso torna a auditoria do arquivo que você tem mais útil do que escrever um novo, e a auditoria são quatro comandos em vez de um projeto.
- O content-type. Uma rota que retorna HTML silenciosamente parece correta em um navegador e é inútil para uma máquina — e uma página 'catch-all' que responde 200 nesse caminho é contada como um adotante por qualquer pesquisa que verifique códigos de status em vez de conteúdo.
- Se ele nomeia algo que você realmente expõe. Um arquivo gerado às vezes lista endpoints de máquina que uma substituição escrita manualmente descarta silenciosamente, então leia o que está lá antes de sobrescrevê-lo.
- Se ele é gerado. Um índice mantido manualmente deteriora-se em duas implantações, e um índice desatualizado é pior do que nenhum porque aponta com confiança para páginas que foram movidas.
- Se algo o solicita. Pesquise no log de acesso pelo caminho. Um arquivo que nada busca não é uma emergência, mas é a única evidência direta disponível sobre esta questão e custa um comando para obter.
Perguntas frequentes
- O que é llms.txt?
- Um arquivo markdown na raiz de um site que resume o que o site é e qual URL responde a qual pergunta, para que um sistema de IA possa se orientar sem rastrear tudo. É uma proposta da comunidade em vez de um padrão publicado por qualquer fornecedor de busca ou assistente, e não concede permissões de qualquer tipo.
- O que vai em um arquivo llms.txt?
- Um cabeçalho com o nome do site, uma breve citação em bloco declarando o que o site vende e a quem ele serve, depois seções de links com uma descrição de uma linha cada — categorias, e as páginas que respondem a perguntas reais de pré-compra, como dimensionamento, envio e devoluções. Aponte para o índice do sitemap para a lista completa de URLs em vez de reproduzi-lo.
- Onde fica o arquivo llms.txt?
- Na raiz do domínio que os clientes realmente digitam, servido como markdown ou texto simples. Verifique o content-type após a implantação: uma rota que retorna HTML silenciosamente é renderizada bem em um navegador e é inútil para uma máquina, e é a maneira mais comum de este arquivo ser silenciosamente quebrado.
- Os assistentes de IA realmente leem llms.txt?
- Nenhum fornecedor de assistente documentou o seu consumo, e o Google declarou publicamente que os seus sistemas não o fazem. Alguns logs de rastreadores mostram o caminho sendo solicitado, mas uma busca não é o mesmo que um modelo usando o conteúdo. Trate o arquivo como barato e não comprovado, em vez de como uma técnica com um resultado esperado.
- llms.txt é o mesmo que robots.txt?
- Não. robots.txt declara quais rastreadores podem buscar quais caminhos e é respeitado voluntariamente por rastreadores bem-comportados. llms.txt oferece um resumo e não concede nada. Remover robots.txt muda o que os rastreadores podem fazer; remover llms.txt muda apenas o que lhes é entregue como um atalho.
- O que é llms-full.txt?
- Uma convenção complementar: em vez de um índice de links, um único arquivo contendo o conteúdo expandido em si, para que um sistema possa ler o material sem buscar muitas páginas e remover a navegação de cada uma. É muito maior por design e atende a uma necessidade diferente do arquivo de índice.
Em detalhe: llms.txt realmente funciona?