contar_licitaciones

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

No hay anotaciones, por lo que la descripción debe cargar con la transparencia. 'Cantidad de licitaciones' comunica que es una operación de conteo y no una mutación, y el vínculo con resumen_licitaciones declara el comportamiento de filtrado. No se mencionan autenticación, límites ni si el conteo es exacto, pero para una herramienta de conteo la conducta básica queda clara.

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?

Es una sola oración sin palabras de relleno que comunica la operación y el contexto de filtros de forma compacta. La información esencial está al frente y no hay contenido redundante.

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 cinco parámetros sin descripción, no hay anotaciones y la descripción se limita a diferir a resumen_licitaciones en lugar de explicar los filtros o su formato. Aunque existe un esquema de salida, el agente no tiene suficiente información autónoma para invocarla correctamente sin consultar la herramienta hermana.

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%, así que la descripción debería compensar explicando los cinco parámetros, pero solo dice que son los mismos filtros que resumen_licitaciones sin definirlos. Los nombres 'desde', 'hasta', 'categoria', 'comprador' y 'modalidad' son sugerentes, pero la descripción no aporta significado adicional sobre formatos o valores válidos.

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 identifica claramente el resultaddo (una cantidad) y el recursso (licitaciones), y al remitir a los 'mismos filtros de resumen_licitaciones' ayuda a diferenciarlo de las herramientas que devuelven registros individuales o listas. No llega a 5 porque asume que el agente ya conoce qué filtros usa resumen_licitaciones.

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 frasse 'según los mismos filtros de resumen_licitaciones' implica que esta herramienta es el equivalente de conteo de resumen_licitaciones, lo que da un contexto de uso. Sin embargo, no explica explícitamente cuándo elegirla frente a buscar_procesos u otras alternativas ni qué filtros compartidos aplican.

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