grafica

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

Sin annotations, la descripción aporta contexto conductual: estilo nativo con colores del tema, leyenda y ocupación por omisión del área de contenido, además de restricciones de datos por tipo. Sin embargo, no aclara efectos secundarios, permisos, si reemplaza objetos existentes ni qué devuelve.

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?

Está front-loaded y usa pocas frases, pero enumera los 17 tipos que ya aparecen en el enum del esquema, lo que añade redundancia y alarga la descripción. La estructura es funcional, aunque no es la más económica.

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 10 parámetros, sin annotations ni output schema, cubre el modelo de datos y los tipos de gráfica, pero deja sin explicar los parámetros de posición/tamaño y el comportamiento de inserción o retorno. Es suficiente para el núcleo, no completa para toda la complejidad.

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 bien los parámetros complejos: explica que en barras/línea/área cada serie trae un valor por categoría, que pastel usa una sola serie y una porción por categoría, y que dispersión usa valores_x compartidos sin categorías. No cubre la semántica de x, y, ancho y alto, pero el núcleo del modelo de datos queda claro.

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?

Describe una gráfica nativa de Keynote con colores del tema y leyenda, y detalla la forma de los datos por tipo de gráfica. Es claro qué recurso produce, pero no usa un verbo explícito ni diferencia esta herramienta de grafica_cientifica.

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?

No indica cuándo usar esta herramienta frente a grafica_cientifica, tabla u otras alternativas, ni menciona prerrequisitos. Solo describe la forma de los datos por tipo, lo que ayuda a invocarla pero no a elegirla.

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