Product Ads

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

Las anotaciones ya declaran readOnlyHint=true y destructiveHint=false, así que la barra es más baja. La descripción agrega qué campos reporta, pero no aclara el nivel de agregación, el comportamiento del período de días ni prerequisitos de conexión. Es una transparencia básica y útil, sin contradicción con 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?

Dos oraciones sin relleno: la primera presenta el recurso y las métricas clave, la segunda da la instrucción de uso. No repite información del esquema ni incluye contenido sobrante.

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 read-only con dos parámetros simples y sin output schema, la descripción es casi suficiente: indica las métricas devueltas y el tipo de pregunta que resuelve. Podría mencionar prerequisitos de conexión o cómo filtran los parámetros, pero esos son detalles menores dado el esquema simple.

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 esquema ya documenta 'cuenta' como ID de MercadoLibre y 'dias' tiene tipo, rango y default. La descripción no explica explícitamente que 'dias' controla el período analizado ni que los resultados dependen de 'cuenta', pero el nombre y el esquema cubren la mayor parte. Es adecuado con un vacío menor.

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?

Identifica un recurso específico (campañas de publicidad de MercadoLibre) y las métricas que devuelve: inversión, impresiones, clics, ACOS y ventas atribuidas. No usa un verbo explícito, pero la frase de uso deja claro que el propósito es responder sobre pauta publicitaria. Se distingue de hermanos como ml_metricas o ml_publicaciones por el foco en 'publicidad', aunque no nombre una alternativa.

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?

Da un disparador claro y accionable: usar cuando pregunten si conviene la pauta o cuánto están gastando en ads. Es contexto suficiente para elegir la herramienta sin abrir el esquema. No menciona exclusiones ni alternativas específicas, por lo que no llega a 5.

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