agents.json: o roteiro que um agente segue para usar o seu sistema

Muito infoprodutor já tem mais que uma página de vendas: tem área de membros, comunidade, uma ferramenta própria, às vezes uma API. Quando um agente de IA quer usar esse sistema por alguém, ele precisa de um roteiro. O agents.json é uma proposta aberta para escrever esse roteiro.

O que é

É um arquivo em /.well-known/agents.json, proposto pela empresa Wildcard em código aberto. Ele se apoia no OpenAPI, a descrição técnica padrão de uma API, e acrescenta os fluxos: para cada objetivo, que operação chamar.

{
  "id": "consultarCnpj_fluxo",
  "title": "Consultar um CNPJ",
  "actions": [{
    "sourceId": "api",
    "operationId":
      "consultarCnpj"
  }]
}

O trecho é real, da API aberta de CNPJ da Wortic.

O que isso muda para quem vende infoproduto

Se você não tem API, este arquivo ainda não é para você, e tudo bem. Se tem, por exemplo, uma ferramenta de diagnóstico, um gerador de planilha ou um sistema que a turma usa, o agents.json transforma isso em algo que um agente consegue usar sem erro: o aluno pede ao assistente dele, e o assistente sabe exatamente que chamada fazer.

É um diferencial que pouca gente tem. A maioria dos produtos digitais ainda depende de a pessoa abrir o navegador e clicar. Um produto que agentes conseguem usar sai na frente quando o aluno começa a delegar tarefas.

O limite

O agents.json é uma proposta aberta, não um padrão, e cada agente decide se o lê. Ele também só faz sentido se houver uma API documentada por baixo: sem OpenAPI, não há onde os fluxos apontarem.

Como a Wortic faz

As três APIs abertas da Wortic, de CNPJ, de CEP e de leilões, publicam o arquivo. Antes de publicar, a prova confere que cada operação citada existe de fato na documentação da API.