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

Sem anotações, a descrição assume o papel de disclosure. Ela explica o comportamento de retornar duas respostas, o uso das tabelas históricas e atuais, e que a diferença indica o impacto da defasagem. Contudo, não descreve o formato exato da saída (ex.: estrutura JSON) nem reforça limitações como a cobertura a partir de 2006-08-01, que está apenas no schema.

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 é estruturada de forma eficiente: começa com o propósito e as duas saídas, depois explica a diferença entre elas e termina listando os parâmetros. É um pouco densa devido à complexidade, mas cada frase contribui para o entendimento, sem desperdício.

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 uma ferramenta sem schema de saída, a descrição fornece contexto suficiente sobre o cálculo e a lógica envolvida, incluindo a comparação entre bruto e líquido. Faltam detalhes sobre o formato de resposta e possíveis erros, mas o nível é adequado para um agente decidir como convocar e processar o resultado.

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?

O schema cobre 100% dos parâmetros com descrições detalhadas, então a baseline é 3. A descrição lista os obrigatórios e opcionais e instrui a usar os nomes exatos, o que agrega um pouco de clareza operacional. Porém, não acrescenta significado semântico além do que já está no schema, como a forma de obter o percentual de inflação.

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 declara claramente que a ferramenta calcula o valor atual de um salário passado em duas respostas distintas: o bruto corrigido pelo IPCA e o bruto necessário para manter o mesmo poder de compra líquido, considerando as tabelas de INSS/IRRF de ambas as épocas. Isso a diferencia de ferramentas similares como calculate_inflation_adjustment ou calculate_real_salary, pois destaca a comparação do impacto da defasagem das tabelas.

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 contexto de uso é claro: para comparar o valor bruto corrigido e o necessário para manter o mesmo poder de compra líquido. No entanto, não há menção explícita a quando não usar essa ferramenta em favor de alternativas como calculate_real_salary ou calculate_raise_vs_inflation, deixando a decisão de seleção ambígua.

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