upload_file

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

No hay anotaciones, por lo que la descripción asume la carga. Aporta comportamientos clave: el archivo va a borradores y no se envía directamente, y devuelve un itemid para el paso siguiente. No detalla permisos ni manejo de errores, pero lo esencial está cubierto.

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 directa y bien estructurada: primero la acción, luego el resultado y finalmente la relación con otra herramienta. No hay relleno ni información redundante.

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?

La herramienta es simple: un parámetro, sin output schema. La descripción cubre la entrada, el efecto y la salida con el itemid, además de su integración con submit_assignment. Faltan detalles menores como errores o permisos, pero no bloquean la selección ni invocación correcta.

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 schema solo define 'path' como string y la cobertura es 0%. La descripción compensa parcialmente al indicar que es un archivo local, pero no especifica formato de ruta, rutas relativas/absolutas ni extensiones permitidas. Añade significado útil aunque limitado.

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 ('Sube') y un recurso concreto ('archivo local al área de borradores'), y además aclara el output (itemid) y su uso posterior en submit_assignment. Esto la diferencia claramente de herramientas hermanas como download_file.

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 que el itemid devuelto se usa en submit_assignment(files_itemid=...), lo que sitúa la herramienta en un flujo concreto. No menciona explícitamente cuándo no usarla ni nombra alternativas como download_file, 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.