Todo site já tem um robots.txt pra dizer a buscadores o que rastrear, e um sitemap.xml pra ajudar a indexação. O AGENTS.md é a versão desse mesmo princípio pra um público novo: agentes de IA que navegam a web em nome de uma pessoa — pra pesquisar, comparar, preencher formulário ou, cada vez mais, tomar uma ação.
Quando alguém pede pro ChatGPT ou pro Claude "acha um freelancer que resolve X" ou "abre contato com essa empresa pra mim", o agente vai até o site. Se lá ele só encontra uma página bonita com texto solto, ele tem que adivinhar como agir. Se encontra um AGENTS.md, ele lê instruções estruturadas — e consegue agir de verdade.
O que entra num AGENTS.md
Não existe um padrão único e fechado ainda, mas o formato que vem se consolidando é simples: um arquivo markdown na raiz do domínio (seusite.com/agents.md), em texto simples, com:
- Quem é você ou sua empresa, em uma ou duas frases
- O que você/ela faz — serviços, produtos, especialidades
- Um jeito estruturado de agir: normalmente um endpoint HTTP que aceita POST com um JSON simples
- O formato exato desse JSON (campos, tipos, quais são obrigatórios)
- Prazo de resposta e um canal alternativo (e-mail, WhatsApp)
O ponto central: um agente de IA não vai preencher um formulário visual em HTML de forma confiável. Mas consegue montar um JSON perfeitamente e mandar um POST. É por isso que o AGENTS.md aponta pra uma API, não pra uma página.
O endpoint precisa existir de verdade
Aqui é onde a maioria para: escrever o arquivo é fácil, mas de nada adianta documentar um endpoint que devolve 404. O endpoint por trás do AGENTS.md precisa:
- Aceitar exatamente o formato de JSON documentado
- Validar os campos obrigatórios e devolver um erro claro se faltar algo
- Fazer alguma coisa real com o dado — nesse caso mais simples, mandar um e-mail pra você; em casos mais avançados, criar um registro num CRM, abrir um ticket, iniciar um fluxo de qualificação
- Responder rápido e com JSON, não com uma página HTML
Publicidade
Vale a pena mesmo?
Ainda é cedo — a maioria dos sites não tem nada disso, e a maioria dos agentes de IA ainda prefere pedir pro humano preencher um formulário. Mas o custo de publicar um AGENTS.md é baixo (um arquivo de texto e, se quiser ir além, um endpoint simples) e o público que ele atinge só cresce: cada vez mais gente delega pesquisa e contato inicial pra um agente. Ser encontrável por esse canal hoje é uma vantagem barata, não uma aposta cara.
Se você quer ver um exemplo funcionando de verdade — não só o arquivo, mas o endpoint atendendo POST de verdade — dá uma olhada no nosso próprio agents.md.