Importar Catalogo de vendedores a SIIGO

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

Las anotaciones declarar destructiveHint=true, pero la descripción añade que el resultado se deja en la carpeta TEMP de la empresa correspondiente, lo cual es información útil. Sin embargo, no detalla efectos secundarios como si sobrescribe datos, manejo de errores o si es irreversible. La descripción no contradice las anotaciones.

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 breve y directa: dos oraciones que comunican el propósito y un detalle conductual. No contiene palabras de relleno ni repeticiones innecesarias. La información esencial está al frente, comenzando con la acción principal.

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?

Dadas las anotaciones que indican una operación destructiva y el schema completo de 8 parámetros, la descripción proporciona lo esencial. Sin embargo, hay algunos huecos: no se menciona el posible formato de error, ni se indica qué ocurre con datos existentes al importar. Aun así, la complejidad moderada de la herramienta hace que la descripción sea suficiente para seleccionarla y usarla 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?

El schema cubre el 100% de los parámetros con descripciones, por lo que la descripción no necesita añadir detalles de parámetros. No se agrega información semántica adicional más allá del schema. La línea de base 3 es apropiada.

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 establece claramente que importa un catálogo de vendedores a SIIGO desde un archivo .xlsx, mencionando la función PUSHVEN. Esto lo distingue de otros tools 'push' (como pushmov o pushext) al especificar el recurso (vendedores) y el destino (SIIGO). El verbo 'Importar' es concreto y el alcance está bien definido.

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 menciona explícitamente cuándo usar esta herramienta en lugar de otras, ni proporciona alternativas o exclusiones. El contexto 'vendedores' y la función PUSHVEN permiten inferir su uso, pero no se da guía explícita sobre selección entre herramientas similares. La referencia a siigo_list_companies en el schema es sobre parámetros, no sobre cuándo usar la herramienta.

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