Reputación del vendedor

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

Las anotaciones ya declaran readOnlyHint=true, openWorldHint=true y destructiveHint=false, y la descripción no las contradice. La descripción añade que la herramienta entrega métricas concretas, pero no detalla comportamiento adicional como autenticación, vigencia de los datos o alcance por cuenta. Con la barra baja que otorgan las anotaciones, un 3 es adecuado.

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 de dos frases sin relleno: la primera enumera el contenido devuelto y la segunda establece el caso de uso. Cada oración aporta información necesaria y está bien priorizada.

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 simple de solo lectura, con un parámetro y sin esquema de salida, la definición es suficiente: el esquema documenta el parámetro, las anotaciones cubren la seguridad y la descripción lista los campos principales devueltos. Podría añadir una nota sobre el comportamiento sin cuenta o su relación con ml_metricas, pero no es crítico.

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 cubre el 100% del único parámetro 'cuenta' con su descripción ('ID de la cuenta de MercadoLibre'). La descripción de la herramienta no aporta semántica adicional sobre el parámetro. Por tanto, se aplica el baseline de 3 para esquemas con alta cobertura.

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?

El título y la descripción identifican el recurso (reputación del vendedor) y enumeran los datos devueltos: color, nivel MercadoLíder, porcentaje de reclamos, cancelaciones y demoras. No hay un verbo explícito tipo 'obtiene' o 'consulta', pero el contenido deja claro qué hace la herramienta. Se distingue razonablemente de hermanas como ml_reclamos o ml_metricas por su foco en el termómetro de reputación.

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 indica explícitamente cuándo usar la herramienta: 'cuando preguntan por el termómetro o por qué bajó la reputación'. Esto proporciona una condición de uso clara. No menciona alternativas ni exclusiones, pero para un caso de consulta de reputación es suficiente en la mayoría de los escenarios.

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