Consultar un indicador socioeconomico de INEGI

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

No hay anotaciones, así que la descripción carga con la responsabilidad. El verbo 'Consulta' sugiere una operación de solo lectura y se menciona la cobertura nacional/estatal, pero no se describen el formato de respuesta, el comportamiento ante códigos inválidos ni si devuelve el dato más reciente o la serie histórica. Es adecuada pero con vacíos.

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 comienza con el propósito principal, pero la segunda frase repite casi los mismos ejemplos de la primera y solo aporta 'inpc'. Podría condensarse en dos frases sin perder información. No es redundante en exceso, pero no es un modelo de concisión.

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 consulta sin anotaciones ni esquema de salida, cubre bien qué se puede consultar y cómo especificar indicador, estado y serie histórica. Sin embargo, no describe la estructura del resultado esperado ni el manejo de errores (por ejemplo, código inexistente), lo que deja cierta incertidumbre operativa.

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?

Aunque la cobertura del esquema es del 100% (baseline 3), la descripción añade valor real al enumerar nombres válidos adicionales ('inpc', 'confianza del consumidor', 'actividad industrial') y al explicar que se acepta cualquier código numérico del catálogo INEGI. Esto ayuda a construir correctamente el parámetro 'indicador' más allá de lo que ya dice el esquema.

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 específico ('Consulta'), identifica el recurso ('indicadores socioeconómicos oficiales de INEGI') y detalla ejemplos concretos como población, inflación y actividad industrial. Además, el ámbito nacional/estatal y la mención del catálogo INEGI la distinguen claramente de las herramientas hermanas DENUE, que son de directorios empresariales.

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?

Proporciona un contexto claro: usar para indicadores INEGI a nivel nacional o estatal, con indicadores conocidos por nombre o mediante código numérico. No excluye explícitamente otras herramientas ni menciona cuándo NO usarla, pero el dominio queda lo bastante definido para que un agente seleccione correctamente.

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