Pídele una consulta al agente

Una buena solicitud tiene cuatro partes

Ya puedes leer SQL, así que puedes empezar a delegarlo. Una solicitud vaga produce una consulta plausible basada en suposiciones. Una bien formulada fija las cuatro cosas que, de otro modo, inventaría el agente:

• La pregunta, en lenguaje sencillo.
• El grano que quieres recibir: ¿una fila por qué?
• Los filtros que no son negociables: qué filas deben incluirse o excluirse.
• La definición de cada métrica que nombres: ¿qué columna es «revenue»?

Compáralas. «Muéstrame los ingresos por categoría» deja abiertas las cuatro decisiones, así que el agente elige por ti una columna de ingresos, un rango de fechas y un grano. «Ingresos totales de línea como quantity * net_price, por categoría de producto, para pedidos realizados en 2024, una fila por categoría» no deja nada que adivinar. La segunda solicitud produce una consulta que puedes comprobar. La primera produce una que debes reconstruir.

Lee siempre el SQL antes de ejecutarlo: mira el SQL, léelo y luego ejecútalo. El archivo AGENTS.md en la raíz del proyecto ya indica al agente que muestre el SQL antes de ejecutarlo y que haga una pregunta aclaratoria cuando la solicitud sea ambigua, así que el reflejo ya está incorporado - solo tienes que usarlo.

Este curso gira en torno a una pregunta, la pregunta central:

"Which product categories grew from 2023 to 2024, and which customers drove that growth?"

Los años se indican intencionadamente. Este conjunto de datos disminuye en 2025 por diseño, así que una pregunta sobre el año más reciente devuelve un resultado vacío o negativo que parece un problema de configuración. Comparar 2023 con 2024 es la historia de crecimiento que realmente contienen los datos. La pregunta tiene dos partes. Esta lección y las tres siguientes trabajan la parte de categorías; la parte de clientes vuelve en el proyecto final, cuando puedas auditar la unión que necesita.

Tu tarea

Hazle a tu agente la pregunta central. Pídele que exponga las decisiones antes de escribir SQL: qué significa «creció», si se medirá por ingresos o por número de pedidos, qué columna de ingresos usará, cuántos clientes cuentan como los que «impulsaron ese crecimiento» y qué grano devolverá. Responde cada una y luego haz que escriba la consulta. Lee el SQL antes de ejecutarlo. Guarda el resultado en queries/agent_v1.sql.

Todavía no audites la lógica - solo comprueba que tu solicitud fue suficientemente específica para producir una consulta legible. Cuando la guardes y ejecutes, confirma la forma:

• El resultado tiene una fila por categoría de producto: ocho filas, o nueve si el agente conservó las líneas cuyo id de producto no tiene coincidencia en products como un grupo propio.
• Si el agente midió los ingresos como quantity * net_price, el total de 2024 en un resultado de nueve filas coincide con 338,209.56, los ingresos correctos de líneas de 2024. Un resultado de ocho filas suma 336,812.67 - faltan 1,396.89. Esa diferencia es real, no un problema de configuración, y descubrir dónde acabó es exactamente el tipo de pregunta que aprenderás a hacer en la siguiente lección.

Comprueba tu comprensión

• ¿Cuáles son las cuatro partes de una solicitud bien formulada?
• ¿Por qué hay que leer el SQL antes de ejecutarlo?
• ¿Cuántas filas debe tener un resultado de «ingresos por categoría» y qué significa un grupo adicional?

Hazlo con tu agente

Di next lesson y tu agente te enseñará esto, te hará estas preguntas y después asignará la tarea anterior. Hazla a mano y luego di review my work - comparará tu trabajo con una rúbrica y te dirá qué corregir o marcará la lección como terminada.