get_roadmap

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

No se proveen anotaciones, por lo que la descripción carga con toda la responsabilidad de transparencia. Solo repite el propósito sin detallar si hay efectos secundarios, requisitos de autenticación, formato de salida o limitaciones. No agrega contexto conductual más allá de lo evidente.

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 sola frase clara, directa y sin información redundante. La acción principal y los insumos clave están al frente, cumpliendo con los requisitos de concisión y estructura.

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 descripción es suficiente para entender la función básica, pero al no haber output schema ni anotaciones, carece de detalles sobre el formato o alcance de la ruta generada. Tampoco menciona el parámetro opcional 'budget', aunque esto está cubierto por el schema.

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 input schema tiene cobertura del 100% con descripciones y enums para todos los parámetros, por lo que la descripción no necesita compensar. Aunque la descripción menciona nivel, objetivo y tiempo, no aporta semántica adicional que no esté ya en el schema.

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 el verbo específico 'Genera' y el recurso 'ruta de aprendizaje personalizada de ciberseguridad', diferenciándola claramente de hermanas como get_cheatsheet o explain_attack. Además menciona los criterios de personalización (nivel, objetivos, tiempo), lo que deja clara su funció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?

La descripción implica que debe usarse cuando se desea una ruta de estudio personalizada, pero no ofrece alternativas explícitas ni condiciones de cuándo no usarla frente a get_cheatsheet o ask_professor. No hay guía de uso contextual.

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