Como criar o agents.txt do seu negócio digital em 15 minutos

O agents.txt é um arquivo de texto que fica em /.well-known/agents.txt e lista, para agentes de IA, o que o seu site oferece. A proposta está num rascunho publicado na IETF. Este guia mostra como escrever o seu.

Passo 1: liste o que um agente poderia usar

Pense em ações, não em páginas. Para um infoprodutor, por exemplo: ver a oferta, assistir à aula grátis, entrar na lista de espera, falar com o suporte. Cada uma vira uma capacidade.

Passo 2: o cabeçalho do arquivo

Spec-Version: 1.0
Site-Name: Curso Exemplo
Site-URL: https://seusite.com.br/
Site-Description: Curso online de fotografia para iniciantes.
Site-Contact: contato@seusite.com.br

Passo 3: uma capacidade por bloco

Cada bloco começa com Capability: e um nome curto, e as linhas de baixo têm dois espaços no começo:

Capability: aula-gratis
  Endpoint: https://seusite.com.br/aula-gratis
  Protocol: HTTP
  Auth: none
  Description: Aula grátis de 20 minutos, sem cadastro.

Capability: lista-de-espera
  Endpoint: https://seusite.com.br/lista
  Protocol: HTTP
  Auth: none
  Description: Formulário para entrar na lista da próxima turma.

Se o seu negócio tem uma API, a capacidade aponta a rota dela e o documento OpenAPI numa linha OpenAPI:. Veja um arquivo real, o da API aberta de CNPJ da Wortic: cnpj.wortic.com/.well-known/agents.txt.

Passo 4: publique e confira

Crie a pasta .well-known na raiz do site, se ela ainda não existir, e salve o arquivo como agents.txt, em UTF-8. Abra o endereço no navegador: o texto deve aparecer puro. Depois, abra cada Endpoint que você declarou e confirme que nenhum dá erro 404.

O que esperar

O agents.txt ainda é a proposta de um autor, sem grupo de trabalho formado na IETF, e nenhum agente é obrigado a lê-lo. Mantenha o arquivo curto e verdadeiro: um endereço quebrado ali é pior que nenhum.

Fonte: AGENTS.TXT: Capability Declarations for Web Agents (IETF Datatracker).