Um agente respondendo a uma pergunta sobre API pode precisar de um guia de autenticação e uma referência de endpoint. Carregar um site inteiro também traz material não relacionado a essa tarefa.
A proposta llms.txt oferece aos publicadores um local para descrever seu conteúdo e vincular páginas Markdown úteis.
O que vai no arquivo?
O arquivo contém o nome do projeto e pode incluir um resumo, orientações e links agrupados para informações adicionais.
A proposta usa Markdown para que pessoas e programas possam processar o mesmo arquivo. Suas listas de links apontam para conteúdo que o agente pode buscar quando necessário.
Um índice de documentação pode agrupar autenticação, envio de mensagens e eventos de entrega sob títulos separados. Descrições curtas ajudam o agente a distinguir esses destinos antes de baixá-los.
A proposta também permite índices abaixo da raiz do site. Um índice dentro de um caminho de documentação cobre o conteúdo abaixo desse caminho.
É a mesma coisa que robots.txt ou um sitemap?
Esses arquivos têm finalidades diferentes: orientação de acesso, descoberta de URLs e uma rota curada para o conteúdo.
| Arquivo | Finalidade |
|---|---|
robots.txt | Fornece regras de rastreamento para clientes automatizados |
| Sitemap | Lista URLs para mecanismos de busca descobrirem |
llms.txt | Descreve conteúdo e vincula detalhes úteis para agentes |
A comparação da proposta com padrões existentes descreve o llms.txt como complementar aos outros arquivos. Publicá-lo não concede acesso a conteúdo protegido.
Ele também não expõe uma ação executável. Um agente precisa de uma API separada ou de uma conexão MCP para realizar operações no espaço de trabalho.
Publicá-lo prova que os agentes o utilizam?
Publicar um índice legível estabelece disponibilidade. Evidência de uso requer observar um cliente recuperar e utilizar esse conteúdo.
A auditoria Lighthouse do Chrome verifica erros de servidor ao recuperar o arquivo. Um arquivo ausente recebe um resultado não aplicável porque o arquivo é opcional. Passar nessa verificação não mede a qualidade das respostas do agente.
Para sua própria avaliação, registre a tarefa e os documentos que o cliente buscou. Verifique se o agente chegou à resposta correta ou concluiu a ação pretendida. Compare execuções equivalentes ao avaliar se o índice ajudou.
Uma solicitação em um log de acesso comprova uma busca. Ela não comprova, por si só, que o cliente usou o conteúdo em sua resposta. Uma citação estabelece uma observação diferente. Mantenha esses resultados separados ao relatar conclusões.
Qual documentação da Bird devo fornecer a um agente?
Você pode fornecer o índice llms.txt da Bird quando um agente precisa descobrir a documentação e buscar páginas relevantes.
O guia de documentação legível por máquina descreve o índice, páginas Markdown individuais e o corpus completo. O índice fornece links; páginas individuais permitem que o cliente obtenha uma resposta focada.
llms-full.txt concatena a documentação com URLs de origem. Esse formato maior atende a um fluxo de trabalho que precisa explicitamente do corpus, sujeito aos limites de contexto do cliente.
Para executar uma tarefa de mensagens após recuperar as instruções, conecte o servidor MCP da Bird. A documentação fornece informações; a conexão autenticada fornece acesso a operações no espaço de trabalho.