b24_tasks_list

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 de comportamiento. Solo dice 'lista tareas con filtros' y no revela comportamiento importante como paginación, orden por defecto, necesidad de webhook_url, efecto de all_pages o formato de respuesta. No contradice nada, pero es insuficiente.

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 oración corta y directa, sin relleno, y coloca la acción principal al inicio. Sin embargo, 'etc.' es impreciso y la descripción podría aprovechar mejor el espacio para incluir información útil sin perder concisión.

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?

Con 7 parámetros opcionales, sin output schema y sin anotaciones, la descripción resulta demasiado escueta para guiar una invocación correcta. El agente debe depender casi por completo del schema para entender paginación, orden, selección de campos y autenticación.

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 de descripciones del schema es del 57%, y la descripción de la herramienta no añade semántica real a los parámetros. Aporta 'vencimiento' como filtro conceptual, pero no explica limit, start, all_pages ni webhook_url más allá de lo ya presente en el schema.

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 un verbo y recurso específicos: 'Lista tareas' con filtros por responsable, grupo, estado y vencimiento. Es clara, pero no diferencia explícitamente de b24_tasks_get ni menciona otras alternativas, y 'etc.' deja el alcance ligeramente abierto.

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 indica cuándo usar esta herramienta frente a b24_tasks_get, b24_tasks_create u otras herramientas de tareas. Tampoco se mencionan exclusiones, prerequisitos o casos en los que convendría usar otra herramienta.

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