consultar_terminais_atm

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Como não há annotations, a descrição carrega a responsabilidade de indicar comportamento. Ela comunica que é uma operação de leitura/consulta e que os dados são agregados por trimestre, mas não descreve o formato do retorno, limites além do default de top, ou quaisquer restrições operacionais.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

A descrição é uma frase única, sem palavras desnecessárias, com o recurso principal e a dimensão temporal claramente front-loaded. O parêntese explicativo (ATM/caixas eletrônicos) agrega clareza sem inflar o texto.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Para um tool simples de consulta, com todos os parâmetros documentados no schema, a descrição é suficiente para identificar o propósito. No entanto, não há output schema e a descrição não detalha quais estatísticas são retornadas, o que deixa uma lacuna perceptível para o agente saber exatamente o que esperar.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

A cobertura do schema é 100%, então os parâmetros já estão bem documentados. A descrição apenas ecoa 'por trimestre', que corresponde ao parâmetro obrigatório trimestre, sem adicionar significado novo sobre top, filtro ou formato exato de trimestre além do que o schema já informa.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

A descrição usa o verbo 'Consulta' e identifica um recurso específico ('terminais de autoatendimento (ATM/caixas eletrônicos)') com granularidade temporal ('por trimestre'), o que a distingue dos irmãos como consultar_taxas_intercambio e consultar_estabelecimentos_credenciados pelo assunto. Falta, porém, uma comparação explícita com outros tools ou a natureza exata das estatísticas retornadas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

O caso de uso é implícito: o agente deve inferir que esta ferramenta é adequada quando a consulta envolve estatísticas de ATMs por trimestre. Não há orientação explícita sobre quando usar uma alternativa nem sobre exclusões ou pré-requisitos.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.