enaho_documentacion_buscar

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

Las anotaciones ya declaran readOnlyHint=true e idempotentHint=true. La descripción añade contexto valioso: devuelve fragmentos y no documentos completos, y que es la única fuente que permite cambiar llaves de verificado de false a true. Esto va más allá de lo que las anotaciones proporcionan. No contradice las anotaciones; la referencia a 'pasar llaves' es sobre el flujo de trabajo, no una escritura directa.

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 pero contiene varias frases de valor. Está bien estructurada: empieza con la acción principal, luego justifica la utilidad, después da instrucciones de uso y finalmente describe el formato de respuesta. Cada oración aporta información útil, aunque podría condensarse sin pérdida.

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?

Dado que existe un output schema y anotaciones completas, la descripción no necesita explicar los valores de retorno. Cubre el propósito, cuándo usarla, el prerrequisito y el formato de retorno (fragmentos). No menciona posibles errores ni límites, pero eso no es esencial para un buscador con buena cobertura de esquema.

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 cubre 60% (termino, exacto, encuesta tienen descripciones; anio y limite no). La descripción de la herramienta no compensa la falta de documentación de anio y limite. Solo aporta contexto general sobre búsqueda de definiciones, que ayuda a entender termino, pero no proporciona semántica para los parámetros sin descripción en el esquema.

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 un verbo específico ('Responde dudas de definición') y nombra el recurso (documento y página). Además, aclara la diferencia con el índice de variables: 'El índice de variables da el nombre y la etiqueta; esto da lo que dice el diccionario y el manual'. Esto la distingue claramente de herramientas como enaho_buscar_variable.

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 indica explícitamente cuándo usar la herramienta: 'ANTES de dar por buena la interpretación de una variable rara, y siempre antes de curar el perfil de una encuesta'. También se menciona un prerrequisito ('requiere haber convertido antes con enaho_documentacion_convertir') y un comportamiento a evitar (nunca devuelve documentos enteros). No se nombran alternativas pero se contrasta con el índice de variables.

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