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

As anotações já declaram readOnlyHint=true, idempotentHint=true e destructiveHint=false, então o agente sabe que é uma leitura segura. A descrição não adiciona detalhes comportamentais além disso, como formato de retorno ou se há correspondência parcial; com anotações presentes, o valor adicional é mínimo mas não contraditório.

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?

Uma única frase que contém verbo, objeto e complemento, sem redundância ou palavras supérfluas. É direta e de fácil leitura.

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?

A ferramenta é simples (um parâmetro string, sem output schema) e as anotações cobrem a segurança da operação. A descrição é suficiente para entender a função principal, embora não indique o que exatamente é retornado (ex.: lista de correspondências, detalhes da sanção), o que poderia ser útil mas não é obrigatório dado o nível de complexidade.

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 é 0%, então a descrição precisa compensar. Ela indica que o parâmetro 'query' é usado para buscar 'por nome/termo', dando semântica à string que o schema não fornece. Ainda assim, seria útil especificar formato ou limitações do termo, mas para um único parâmetro simples é suficiente.

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 verbo específico 'Busca' e identifica claramente o recurso: 'listas de sanções do OFAC (EUA) por nome/termo'. Isso diferencia de ferramentas irmãs como consultas_sancoes_onu, ao especificar a jurisdição (EUA).

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?

Não há orientação explícita sobre quando usar em vez de alternativas nem exclusões. O contexto é implícito: o nome OFAC (EUA) sugere uso para sanções americanas, mas não há menção a ferramentas alternativas como consultas_sancoes_onu ou critérios de escolha.

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