# agents.txt: as capacidades de um site para agentes, geradas do jsonW Cada fluxo do catálogo jsonW vira um bloco Capability do /.well-known/agents.txt, com rota, protocolo, autenticação e limite, conferido contra o OpenAPI publicado. 14 de novembro de 2026 · jsonW 1.3.11 · https://jsonw.org/newsroom/agents-txt ## O protocolo O rascunho draft-car-agents-txt-wellknown define um arquivo de texto em /.well-known/agents.txt. Nele o site diz a um agente de IA o que oferece, por qual endereço, com qual protocolo e com qual limite, sem que o agente precise ler as páginas. ## O perfil jsonW Os fluxos ficam numa coluna de texto do catálogo, um por item, separados por ponto e vírgula: operationId|rota|título|descrição. A linha do CNPJ tem três: ``` fluxos:"consultarCnpj|/cnpj/{cnpj}|Consultar um CNPJ|A ficha pública...; listarSocios|/cnpj/{cnpj}/socios|Listar os sócios|...; buscarEmpresas|/empresas|Buscar empresas pelo nome|...", limite:"60 pedidos por minuto por IP sem chave",mcp:"https://cnpj.wortic.com/mcp"``` Cada fluxo vira um bloco Capability, e a coluna mcp vira mais um: ``` Capability: consultar-cnpj Endpoint: https://cnpj.wortic.com/cnpj/{cnpj} Protocol: REST Auth: none Rate-Limit: 60/minute OpenAPI: https://cnpj.wortic.com/openapi.json Capability: mcp Endpoint: https://cnpj.wortic.com/mcp Protocol: MCP Auth: none``` ## Ida e volta A prova lê o arquivo gerado, separa os blocos e confere cada Endpoint contra o OpenAPI que a API publica de fato: as 9 rotas declaradas nas três APIs abertas (CNPJ, CEP e leilões) existem no OpenAPI. Se uma rota sumir da API, a prova falha antes da publicação. ## A medida A linha do CNPJ no catálogo tem 824 bytes. Dela saem 4.620 bytes em seis arquivos para agentes: o agents.txt (1.373 bytes), o agents.json, o agent-permissions.json, o trecho do robots, o valor do Content-Usage e o llms.txt. ## O que ainda não faz O agents.txt é um rascunho individual, ainda sem grupo de trabalho na IETF. O formato pode mudar; quando mudar, muda um arquivo do gerador, e as 9 propriedades saem certas de novo. Fonte: https://datatracker.ietf.org/doc/draft-car-agents-txt-wellknown/