Responder un correo

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

Las anotaciones ya indican que no es una operación de solo lectura (readOnlyHint=false). La descripción añade que el envío es 'inmediatamente', un detalle útil pero menor. No contradice las anotaciones ni revela efectos adicionales relevantes.

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?

Una sola oración que comunica la función y la opción clave. Sin redundancias ni información superflua, logra máxima claridad en mínimo espacio.

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 una herramienta simple con 3 parámetros, sin esquema de salida y con anotaciones básicas, la descripción cubre los aspectos esenciales: la acción, el destinatario inmediato y la opción replyAll. Es suficiente para entender el comportamiento y usarla correctamente.

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?

El esquema documenta body e itemId, pero replyAll carece de descripción en el schema. La descripción compensa explicando que replyAll=true corresponde a 'Responder a todos', añadiendo significado a un parámetro que de otro modo sería ambiguo.

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?

La descripción usa un verbo específico ('Responde') y un recurso concreto ('correo existente por ItemId'), diferenciándose claramente de herramientas similares como ews_send_message (enviar nuevo) o ews_forward_message (reenviar). Señala la acción principal y el mecanismo de identificación.

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?

Proporciona un contexto claro: se usa para responder a un correo existente. Aunque no menciona explícitamente cuándo no usarla o alternativas, la referencia a 'existente' delimita el caso de uso y la distingue de crear un mensaje nuevo.

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