pbi_search_model

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

Sin anotaciones, la descripción asume la responsabilidad de informar el comportamiento. Aporta detalles útiles como la insensibilidad a mayúsculas, la inclusión del DAX en la búsqueda y la distinción por nombre/expresión. No obstante, no menciona si hay efectos secundarios, permisos requeridos o limitaciones de paginación, aunque por ser una búsqueda se infiere que es de solo lectura.

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 breve y bien estructurada. La primera línea da el propósito y luego los parámetros en formato de lista, con cada elemento claro y sin información redundante. Toda frase aporta valor.

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?

Existe output schema que cubre la estructura de retorno. La descripción cubre el propósito y dos de cuatro parámetros. Para una herramienta de búsqueda, la falta de explicación sobre 'limit' y 'source' es una brecha significativa, pero el resto es suficiente para un caso típico.

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 tiene 4 parámetros y la cobertura del esquema es 0%. La descripción explica 'term' y 'kinds', pero omite 'limit' y 'source'. Estos dos parámetros quedan sin ninguna guía de uso más allá de sus valores por defecto, lo que deja lagunas sobre cómo controlar el número de resultados o qué significa 'live'.

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 especifica claramente la acción (buscar), el recurso (objetos del modelo) y el alcance (por nombre y en el DAX de las medidas). Esto la distingue de herramientas hermanas como list_tables o get_object, que listan todo o recuperan por identificador.

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?

Se entiende cuándo usar la herramienta: para buscar objetos por nombre o por texto en expresiones DAX. El filtro por tipos y la indicación de coincidencia en medidas aportan contexto de uso. Sin embargo, no se mencionan alternativas explícitas ni casos en los que no debería usarse.

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