listar_votacoes_pec

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

Sem anotações, a descrição deveria declarar que é uma operação de leitura e sem efeitos colaterais. O nome 'lista' sugere, e a descrição menciona apenas o retorno de IDs, sem detalhar permissões, paginação ou limitaçõ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?

Duas frases objetivas, sem redundância; a informação essencial (que lista votações e retorna IDs) está no início, e o parágrafo adicional dá contexto útil sem alongar.

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, mas a falta de explicação dos parâmetros (especialmente 'max_itens') é uma lacuna. O output schema cobre o retorno, mas o agente não saberá o significado exato do ID de entrada nem como controlar quantidade de resultados.

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 no schema, a descrição não compensa: não explica que o parâmetro 'id' se refere ao ID da PEC nem o efeito de 'max_itens' (padrão 100). Apenas o retorno de ID é mencionado, não os parâmetros de entrada.

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?

Descreve acção específica — listar votações de uma PEC — e identifica o propósito dos IDs retornados, diferenciando-o dos siblings de detalhe e de listagem de votos.

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?

Indica o contexto (votações de uma PEC) e explica que os IDs são usados por três ferramentas a jusante, mas não menciona explicitamente quando não usar ou alternativas. Possui contexto claro, sem exclusões.

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