Eva Material

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

Sin anotaciones, la descripción aporta un rasgo conductual: no descarga el material. Sin embargo, no informa si requiere autenticación previa, qué devuelve exactamente ni si la operación es de solo lectura, por lo que la carga informativa queda cubierta solo parcialmente.

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?

La descripción es una frase breve y sin redundancias, con la distinción clave ('sin descargar') claramente integrada. No hay palabras de relleno y la información esencial está presente.

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?

Es una herramienta simple con un solo parámetro y esquema de salida disponible, por lo que la descripción es suficiente para una invocación básica. Faltan detalles sobre el formato esperado del parámetro y los prerrequisitos de autenticación, lo que impide una completitud total.

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 define un único parámetro 'curso' con 0% de cobertura en la descripción. El texto asocia ese parámetro al curso cuyos materiales se obtienen, lo cual añade algo de significado, pero no especifica si se trata de un ID, nombre o slug.

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 claramente el recurso: materiales de un curso, compuestos por archivos y páginas. El matiz 'sin descargar' lo distingue de la herramienta hermana eva_descargar_material, aunque carece de un verbo explícito como 'listar' u 'obtener'.

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?

El texto deja implícito que esta herramienta se usa para consultar materiales sin descargarlos, diferenciándose del flujo de descarga. No menciona explícitamente a eva_descargar_material ni define cuándo no usarla, pero el contexto es suficientemente claro.

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