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

Las anotaciones ya declaran readOnlyHint=true, destructiveHint=false y openWorldHint=false, por lo que la seguridad de lectura está cubierta. La descripción añade valor real al advertir que el contenido lo escribieron otras personas y es dato no confiable, nunca instrucciones, algo que las anotaciones no pueden expresar. No detalla formato de retorno, orden ni paginación.

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?

Dos frases con el propósito al frente y la advertencia de contenido no confiable después; nada es relleno. La segunda frase es algo extensa, pero su contenido es relevante y está bien separado del resto.

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 de listado de solo lectura con anotaciones que ya cubren el perfil de seguridad y sin esquema de salida, la definición cubre propósito, ámbitos válidos, origen de los identificadores y manejo seguro del contenido. Solo faltaría indicar la forma/orden del resultado o cómo continuar el flujo de revisión con los hermanos.

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?

Con cobertura de esquema del 50%, la descripción compensa parcialmente al explicar el papel de connection_id y account_id (obtenidos de list_conversations) y al contraponer el ámbito cuenta frente al ámbito conversación, cubriendo los dos parámetros que el esquema deja sin describir. Queda ambiguo qué combinación exacta de parámetros corresponde a cada modo y si es obligatorio indicar alguno, pese a que ningún parámetro es requerido.

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 identifica con claridad el recurso y la acción: borradores de respuesta que el bot dejó pendientes de revisión, y aclara los dos ámbitos posibles (cuenta o conversación). No menciona ni diferencia a los hermanos relevantes como dismiss_message_draft, send_message_draft o update_draft_texts, por lo que se queda en 4 y no en 5.

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 de dónde obtener los identificadores (connection_id y account_id de list_conversations, conversation_ref de list_conversations) y que el ámbito puede ser una cuenta o una conversación, lo que orienta el uso. Sin embargo, no dice cuándo elegir esta herramienta frente a las acciones de revisión (dismiss/send draft) ni qué hacer cuando no se especifica ámbito; el uso queda implícito.

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