pbi_duplicate_visual

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

La descripción añade información valiosa más allá de las anotaciones neutrales: revela que solo se regenera el identificador (que debe ser único), que la copia se desplaza con offset_x/offset_y para no superponerse, y que target_page permite copiar a otra página. Esto cubre efectos clave de la operación, aunque no detalla permisos ni reversibilidad.

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 consta de tres oraciones breves y directas, con la información principal al inicio. No hay relleno ni repetición de lo que ya está en el schema; cada oración aporta un dato relevante.

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 tiene 7 parámetros y es mutadora, pero la descripción cubre el comportamiento central y la existencia de output schema evita explicar retornos. No obstante, la falta de explicación para request_id y matices de new_title deja lagunas para una invocación correcta. En general es útil pero no completa.

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?

La cobertura del schema es 0%, por lo que la descripción debe compensar. Explica offset_x, offset_y y target_page con su propósito. Sin embargo, no aclara request_id, y el papel de new_title solo se infiere por el nombre. De los 7 parámetros, 3 reciben descripción semántica explícita, dejando vacíos para los demás.

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 comienza con 'Duplica un visual conservando campos, formato y filtros', que es un verbo específico con recurso y alcance claro. Distingue de herramientas hermanas como pbi_create_visual o pbi_copy_visual_format al especificar qué se conserva y qué se regenera.

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 uso se implica claramente: duplicar un visual manteniendo propiedades. Sin embargo, no se mencionan cuándo no usar esta herramienta ni alternativas explícitas (por ejemplo, pbi_copy_visual_format o pbi_duplicate_page). Falta orientación contextual sobre escenarios o exclusiones.

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