IPC de Argentina (INDEC)

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

Las anotaciones ya declaran readOnlyHint, idempotentHint y destructiveHint=false, por lo que la carga es menor. La descripción añade contexto valioso no cubierto por las anotaciones: la base del índice y que el valor retornado es el índice, no la variación porcentual, evitando un mal uso frecuente.

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?

Dos oraciones sin relleno; la identidad y base del índice van primero y la aclaración sobre el valor devuelto al final. Cada frase aporta información esencial.

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 anotaciones de solo lectura, esquema de salida presente y solo dos parámetros, la descripción cubre lo esencial: qué es, el formato de fechas y qué devuelve. Falta mencionar la disponibilidad temporal de los datos (inicio en dic-2016) y el comportamiento ante fechas inválidas o fuera de rango.

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 descripción del esquema es 0%, por lo que la descripción debe compensar. Lo hace al especificar el formato AAAA-MM para los dos meses ('desde' y 'hasta'), que es la información crítica que falta en el esquema. No aclara si el rango es inclusivo ni el orden requerido.

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 nombra un recurso específico (IPC nacional de Argentina) con su base (dic-2016=100) y aclara el resultado ('Devuelve el índice, no la inflación'). Esto lo distingue implícitamente de hermanas como ipca_brasil, pero no las menciona ni diferencia explícitamente.

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?

Se indica el contexto de uso (rango entre dos meses AAAA-MM) y una advertencia semántica útil (devuelve índice, no inflación), lo que implica que la inflación debe calcularse. Sin embargo, no hay instrucciones explícitas de cuándo usarlo frente a alternativas ni condiciones de exclusión.

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