Listar emails

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

As annotations já informam readOnlyHint=true e destructiveHint=false, e a descrição reforça com 'Ação somente leitura' e 'Nada é alterado'. Ela adiciona contexto útil além das annotations: retorna apenas resumo curto, não o corpo completo, e funciona igual no Outlook local e Microsoft 365. Sem contradição com as annotations.

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?

Texto compacto em três frases, com a informação central no início: ação, escopo, limitação importante, alternativa e garantia de não alteração. Cada frase agrega valor e não há enrolação.

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 operação de leitura simples, sem parâmetros obrigatórios, a descrição é suficiente para invocar a tool corretamente: especifica pasta padrão, inclusão da Lixeira, saída resumida e segurança. Não detalha a forma exata do retorno nem o limite padrão, mas o núcleo da chamada está claro.

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 60% dos parâmetros; a descrição acrescenta contexto sobre pasta (incluindo Lixeira e padrão Caixa de Entrada) e sobre a noção de 'recentes', mas não explica diretamente 'limite' ou 'somente_nao_lidos'. Os nomes dos parâmetros são relativamente autoevidentes, então é adequado, mas não completo.

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 define claramente a ação ('lista os emails mais recentes de uma pasta'), o escopo (pasta, incluindo Lixeira, padrão Caixa de Entrada) e o que não faz ('não retorna o corpo completo'). Também diferencia de um sibling ao indicar outlook_ler_email para leitura do conteúdo completo.

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 diz claramente quando usar a ferramenta — listar resumos de emails recentes — e indica explicitamente a alternativa para o caso de se precisar do conteúdo completo ('use outlook_ler_email para ler uma mensagem específica por inteiro'). Isso funciona como uma condição de quando não usar esta tool.

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