treeflow_update_entity

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

No hay anotaciones disponibles, así que la descripción es la única fuente de transparencia. Indica que la operación es de actualización, pero no aclara si es parcial o total, si reemplaza los valores existentes, si valida el entity_id, ni qué efectos colaterales puede tener. Para una herramienta mutadora, esto 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?

La descripción es una sola frase directa y sin relleno, con la acción principal al inicio. Comunica el propósito esencial de forma eficiente y no incluye información redundante con el esquema.

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 actualización con 6 parámetros, sin anotaciones ni esquema de salida, la descripción es demasiado breve. Faltan detalles sobre el comportamiento esperado, el resultado de la operación, el efecto sobre datos existentes y posibles errores. Un agente necesitaría inferir demasiado 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?

La cobertura del esquema es del 83%, por lo que el esquema ya documenta la mayoría de los parámetros. La descripción añade algo de semántica al listar 'valores, tipo, sinónimos o patrón regex', pero no profundiza en cómo se combinan ni en el significado exacto de las claves dentro del arreglo values. Se mantiene en el nivel base.

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 utiliza un verbo específico ('Actualiza') y un recurso claramente identificado ('entidad existente'), y enumera los aspectos modificables: valores, tipo, sinónimos o patrón regex. Se distingue bien de herramientas hermanas como create_entity o delete_entity, aunque omite mencionar el campo 'name' que sí aparece en el esquema.

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 descripción no indica cuándo usar esta herramienta frente a alternativas como crear o eliminar entidades, ni menciona prerequisitos. Solo se infiere que debe usarse para actualizar una entidad ya existente, pero no hay orientación explícita sobre condiciones, excepciones o casos de uso.

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