buscar_fisiologia

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

No hay anotaciones, por lo que la descripción debe asumir la carga. Menciona el paso de reranking y el valor por defecto de top_k, lo que da cierta transparencia sobre el proceso. No declara explícitamente que sea una operación de solo lectura, aunque el verbo 'buscar' lo sugiere. Falta información sobre límites o formato de respuesta.

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?

El texto es breve y directo, con la finalidad al inicio y la lista de parámetros al final. No hay redundancia ni información innecesaria; cada oración aporta contenido 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?

Para una herramienta de búsqueda con solo dos parámetros y un esquema de salida presente, la descripción cubre todos los aspectos necesarios: propósito, contexto de uso, y semántica de parámetros. No se echa en falta información sobre el formato de retorno porque el esquema de salida lo cubre.

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 esquema es 0%, por lo que la descripción compensa completamente. Explica 'query' como consulta en lenguaje natural sobre fisiología, y 'top_k' como número de fragmentos tras el reranking con su default. Añade valor más allá del esquema, incluyendo contexto de uso.

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 indica claramente el recurso ('libros de fisiología médica') y el propósito ('entender función normal, mecanismos fisiológicos, homeostasis y regulación'). Se distingue de los hermanos al especificar el dominio fisiológico, lo que permite seleccionarlo correctamente entre las otras búsquedas.

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?

La frase 'Úsalo para entender función normal...' establece un contexto de uso claro. Sin embargo, no menciona explícitamente cuándo no usarlo ni nombra las alternativas (buscar_patologia, etc.), por lo que la orientación es implícita más que directa.

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