actualizar_datos

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

No hay anotaciones, por lo que la descripción asume la carga de transparencia. Aporta un rasgo relevante: la idempotencia por hash, que sugiere que es seguro reintentar. Sin embargo, no explica efectos colaterales de la sincronización, dependencia de red ni qué implica exactamente force_refresh sobre los datos locales.

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 con información esencial: verbo, objeto y propiedad clave (idempotencia). Es directa, sin relleno y con el detalle más relevante entre paréntesis.

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 un output-schema presente y parámetros bien cubiertos, la descripción es suficiente para ejecutar la llamada, pero no para entender cuándo conviene usarla respecto a sus hermanas ni qué implica 'sincronizar' a nivel de datos. Un agente podría invocarla sin saber que debe comprobar antes estado_datos o que puede forzar el refresco.

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 100%, así que los parámetros ya están documentados en el input-schema. La descripción no añade semántica adicional a dataset ni a force_refresh; la referencia al hash se relaciona vagamente con force_refresh pero no explica su uso.

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?

Describe una acción específica ('Descarga y sincroniza') sobre un recurso concreto ('los listados del SAT') y añade un matiz ('idempotente por hash') que delimita su comportamiento. No nombra ni contrasta explícitamente con las herramientas hermanas, pero su alcance queda claro frente a estado_datos o verificar_rfc.

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 invocar esta herramienta frente a las alternativas, por ejemplo comprobar antes estado_datos o usar verificar_rfc según el caso. Tampoco hay prerequisitos, exclusiones ni contexto de uso; solo se infiere que sirve para actualizar los datos.

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