pbi_document_report_layout

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

No hay anotaciones, por lo que la descripción debe revelar el comportamiento. Solo indica que genera documentación, pero no aclara si es una operación de solo lectura, si modifica archivos, si requiere permisos especiales, o el formato exacto de salida más allá de Markdown. La información es mínima y no añade contexto sobre efectos secundarios o limitaciones.

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 oración clara y directa, sin información redundante. El término 'Markdown' aparece al inicio, lo que facilita una lectura rápida y la identificación del formato de salida.

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 sin parámetros, la descripción cubre el propósito y el formato de salida de manera suficiente. Sin embargo, al existir múltiples herramientas de documentación entre los hermanos, carece de contexto sobre su diferencia específica (por ejemplo, que se enfoca en el layout y no en el modelo). El esquema de salida existe pero no se detalla, aunque para una operación simple la información es adecuada.

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 no tiene parámetros, por lo que la descripción no necesita explicar parámetros. El baseline para 0 parámetros es 4; la descripción añade el alcance (páginas y visuales) que orienta al agente sobre el ámbito de documentación, compensando la ausencia de estructura.

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 utiliza un verbo específico 'Genera documentacion Markdown' y especifica el recurso 'layout del informe (paginas y visuales)', lo que la distingue claramente de herramientas como pbi_document_model o pbi_list_visuals. El alcance es preciso y delimita el tipo de documentación generada.

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 se proporciona ninguna indicación sobre cuándo usar esta herramienta frente a alternativas como pbi_generate_technical_documentation, pbi_document_model o pbi_list_report_pages/pbi_list_visuals. Tampoco se mencionan exclusiones, prerrequisitos o contexto de uso.

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