agents.txt: o arquivo que diz a um agente de IA o que o seu negócio oferece

Um agente de IA é diferente de um buscador. Ele não só mostra um link: ele age por alguém, como pesquisar cursos, comparar ofertas ou marcar uma conversa. Para agir bem, o agente precisa saber o que o site oferece sem ter de ler página por página. O agents.txt é uma proposta para isso.

O que é

É um arquivo de texto no endereço /.well-known/agents.txt, descrito num rascunho publicado na IETF (draft-car-agents-txt-wellknown). Ele traz o nome do site, uma descrição curta e uma lista de capacidades. Cada capacidade diz o endereço, o protocolo, se precisa de login e qual o limite de pedidos:

Capability: consultar-cnpj
  Endpoint: https://cnpj.wortic.com/cnpj/{cnpj}
  Protocol: REST
  Auth: none
  Rate-Limit: 60/minute

O exemplo acima é real, da API aberta de CNPJ da Wortic.

O que isso muda para quem vende infoproduto

Pense no que o seu negócio tem que um agente poderia usar: a página de vendas, uma aula gratuita, um diagnóstico, uma calculadora, um formulário de lista de espera. Hoje um agente precisa adivinhar onde está cada coisa. Com um agents.txt, você entrega o mapa: aqui está a oferta, aqui está a amostra grátis, aqui a pessoa entra na lista.

Quanto mais claro o mapa, menor a chance de o agente se perder ou de recomendar a oferta errada. E o arquivo serve também para dizer limites: quantos pedidos por minuto, o que exige login, o que não está disponível para agentes.

O limite

O agents.txt ainda é a proposta de um autor, sem grupo de trabalho formado na IETF. Nenhum agente é obrigado a ler o arquivo. Por enquanto, ele é um sinal de que o seu negócio está pronto para essa nova forma de descoberta.

Como a Wortic faz

A Wortic gera o agents.txt de cada site a partir de um catálogo único. Antes de publicar, a prova confere cada endereço declarado contra a documentação técnica da API, então o arquivo não aponta para uma rota que não existe.