validar_chave_nfe

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

Não há annotations fornecidas, então a descrição assume o peso. Ela declara explicitamente que não consulta APIs, o que esclarece o comportamento. Não há efeitos colaterais indicados. Seria mais transparente se mencionasse que retorna um booleano ou resultado, mas o essencial está presente.

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?

Duas frases curtas e diretas, sem redundância ou jargão desnecessário. Toda informação é relevante e estruturalmente organizada: primeiro o que faz, depois o que não faz, depois o que extrai.

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 descrição cobre o propósito, limitações e informações extraídas. Não detalha o formato de saída (ex.: retorna booleano? objeto?), mas como não há schema de saída fornecido, a descrição é suficientemente completa para o contexto. Poderia ser levemente mais específico sobre o resultado, mas não é um gap crítico.

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 único parâmetro `chave_acesso` é descrito no schema com detalhes (44 dígitos, aceita espaços). A descrição da ferramenta adiciona significado ao explicar o que a chave permite extrair (UF, data, CNPJ, número), enriquecendo a compreensão do parâmetro.

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 especifica claramente a ação (validar formato e dígito verificador), o alvo (chave de acesso de NFe) e o escopo (sem consulta a APIs, apenas cálculo matemático e extração de informações). Distingue-se de outras validações como validar_cpf e validar_assinatura_nfe.

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?

A descrição é explícita sobre quando usar (para validar chave) e sobre o que não faz (não consulta APIs). Não menciona alternativas diretamente, mas a informação de que não consulta APIs evita uso indevido. Poderia ser mais explícito sobre comparado a outras ferramentas.

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