Protocolos para agentes de IA
llms-full.txt: a documentação da API inteira num arquivo para IA
As APIs de CNPJ e de leilões publicam o llms-full.txt, que junta o llms.txt e todos os guias num texto só. Cada guia continua com a sua versão .llm.txt ao lado.
· jsonW 1.3.11
O protocolo
A proposta do llms.txt põe na raiz do site um arquivo em Markdown com o que uma IA precisa saber e os links para o resto. O llms-full.txt é a variante longa: o mesmo índice com o texto de cada página dentro, para quem quer ler tudo num pedido só.
O perfil jsonW
No catálogo, a coluna fonte_llms diz onde estão os guias de cada API. Para o CNPJ ela aponta a pasta da porta da API, e o gerador junta o llms.txt e o .llm.txt de cada guia, em ordem de nome, num arquivo só; cada guia começa com uma linha Fonte: com o endereço dele. Para o CNPJ ele tem 41.080 bytes. O começo:
# Wortic CNPJ: consulta de empresas brasileiras
## Para agentes de IA
- Fonte: dados abertos do CNPJ, Receita Federal.
- Limite sem chave: 60 consultas por minuto por IP.
- O CPF de sócio pessoa física nunca sai: vem só a máscara.
Ida e volta
Os guias continuam publicados um por um, cada página com o seu .llm.txt ao lado. O llms-full é só a junção dos mesmos arquivos, gerada de novo a cada publicação, e por isso o texto longo e as páginas não contam histórias diferentes. A prova conta as linhas Fonte:: o arquivo do CNPJ precisa ter pelo menos 10 guias, e o dos leilões, os 5 que a API tem.
Onde mais
A newsroom do jsonw.org segue a mesma ideia: cada post tem a versão em texto para IA no mesmo endereço, com .llm.txt no fim, e a lista inteira está em posts.llm.txt.
O que ainda não faz
O llms.txt é uma proposta da comunidade, não um padrão. Buscadores e assistentes leem o arquivo cada um do seu jeito, e nenhum promete usá-lo.