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

As anotações já declaram readOnlyHint=true e idempotentHint=true, e a descrição não contradiz isso. Além das anotações, a descrição revela o comportamento central: a regra do coeficiente (60% + 2% por ano acima de 20H/15M) e a aplicação de piso e teto. Faltam detalhes sobre formato de retorno e casos extremos, mas a segurança da operação já está coberta pelas anotações.

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 única frase densa e bem estruturada, começando pelo nome completo e depois condensando fórmula, limiares e limites sem palavras desnecessárias. Cada trecho contribui para o entendimento do cálculo.

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?

Apesar de cobrir bem a fórmula e os parâmetros, a descrição omite informações práticas: não há output schema, não declara o formato do valor retornado, unidades ou arredondamento, nem se teto_inss e salario_minimo têm valores padrão quando omitidos. A distinção entre obrigatórios e opcionais só aparece no schema, não na descrição.

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?

Com 0% de cobertura descritiva no schema, a descrição precisa dar significado aos parâmetros, e ela faz isso: media_salarios corresponde a 'média dos salários de contribuição'; tempo_contribuicao_anos e sexo estão codificados na regra '20H/15M'; salario_minimo e teto_inss correspondem a 'piso' e 'teto'. Todos os cinco parâmetros são explicados semanticamente pela fórmula.

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 abre com 'RMI — Renda Mensal Inicial' e declara exatamente o que a ferramenta calcula: média dos salários de contribuição vezes coeficiente, com piso e teto. Isso identifica claramente o recurso e o distingue das calculadoras irmãs como calculo_pensao ou calculo_tempo_contribuicao.

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 esta ferramenta em vez das alternativas, nem exclusões mencionadas. A fórmula sugere que o uso é para cálculo de RMI pós-reforma EC 103/2019, mas isso fica implícito, sem comparar com outras calculadoras do INSS.

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