Historial de visitas

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

Las anotaciones ya declaran readOnlyHint=true, openWorldHint=true y destructiveHint=false, cubriendo el perfil de seguridad de la operación. La descripción añade contexto útil al especificar que se trata de una serie temporal por publicación, pero no detalla aspectos como el rango de fechas, la granularidad, la paginación o el formato de la respuesta.

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?

Es una sola frase sin relleno, con la idea principal al inicio y la finalidad al final. Resulta eficiente, aunque al ser tan escueta no estructura otros elementos útiles como formato de salida o criterios de filtrado, lo que impide la máxima puntuació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 lectura simple con un único parámetro opcional bien documentado en el schema, la descripción es adecuada. No obstante, al no existir output schema, deja sin aclarar la forma exacta de la serie devuelta y el período cubierto, y tampoco orienta sobre cuándo preferirla frente a otras herramientas analíticas hermanas.

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 schema cubre el 100% del único parámetro (cuenta, opcional, con descripción), por lo que la descripción no necesita compensar vacíos. La descripción no aporta información adicional sobre cómo usar 'cuenta', así que el baseline de 3 es adecuado.

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 identifica un recurso concreto (visitas por publicación) y una finalidad específica (detectar si el tráfico sube o baja), lo que la distingue de herramientas hermanas como ml_mensajes o ml_preguntas. Sin embargo, carece de un verbo explícito de acción como 'muestra' o 'devuelve', por lo que no alcanza la máxima claridad.

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?

El propósito comunicado, 'para ver si el tráfico sube o baja', sugiere implícitamente cuándo usar la herramienta: al analizar la evolución temporal de visitas de publicaciones. No se ofrecen condiciones explícitas de uso ni se excluyen alternativas como ml_rendimiento_publicaciones o ml_publicaciones, por lo que la orientación queda a cargo de la inferencia del agente.

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