b24_crm_update

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

No hay anotaciones, así que la descripción debe revelar el comportamiento. Solo dice que actualiza campos, lo cual ya está en el nombre; no informa si el update es parcial, si requiere permisos especiales, qué pasa con campos no especificados ni el 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?

Una sola oración, sin relleno y con el verbo al frente. Es eficiente, aunque esa brevedad se logra a costa de omitir contexto operativo.

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 7 parámetros, sin anotaciones ni output schema, y la descripción es solo una frase. No explica cómo identificar el registro, cómo elegir entity vs entity_type_id, ni qué hacen params/webhooks; es insuficiente para invocarla correctamente.

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?

Con solo un 29% de cobertura de descripción en el schema, la descripción debía compensar, pero no añade significado a parámetros como entity, params, webhook_url, entity_type_id o personal_webhook. 'Campos' repite lo que ya dice el schema sin aportar detalle.

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 usa un verbo concreto ('Actualiza') y un recurso claro ('campos de un registro CRM existente'). El término 'existente' lo distingue de b24_crm_create, aunque no menciona explícitamente otras alternativas.

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 hay indicaciones sobre cuándo usar esta herramienta frente a b24_crm_create, b24_crm_get o b24_crm_delete. Solo se infiere por la palabra 'existente'; falta orientación sobre requisitos previos o casos en que no debe usarse.

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