Demandez une requête à l'agent

Une bonne demande comporte quatre parties

Vous pouvez lire SQL maintenant afin de pouvoir commencer à le déléguer. Une demande vague produit une requête plausible basée sur des suppositions. Un document bien formé identifie les quatre choses qu'un agent inventerait autrement :

• La question, en langage clair.
• Le grain que vous voulez récupérer : un rang par quoi ?
• Les filtres non négociables : quelles lignes doivent être entrées ou sorties. - La définition de toute statistique que vous nommez : quelle colonne correspond aux "revenus" ?

Comparez les deux. « Montrer les revenus par catégorie » laisse les quatre éléments ouverts, l'agent sélectionne donc une colonne de revenus, une plage de dates et un grain pour vous. "Revenu total de la ligne en quantity * net_price, par catégorie de produits, pour les commandes passées en 2024, une ligne par catégorie" ne laisse rien deviner. La deuxième requête produit une requête que vous pouvez vérifier. Le premier en produit un que vous devez procéder à une ingénierie inverse.

Lisez toujours le SQL avant son exécution : consultez le SQL, lisez-le, puis exécutez-le. Le fichier AGENTS.md à la racine du projet indique déjà à l'agent de montrer son SQL avant de s'exécuter et de poser une question de clarification lorsque la requête est ambiguë, le réflexe est donc intégré à la configuration - il vous suffit de l'utiliser.

Ce cours est construit autour d'une question, la question sur la colonne vertébrale :

« Quelles catégories de produits ont connu une croissance entre 2023 et 2024, et quels clients ont généré cette croissance ? »

Les années sont volontairement nommées. Cet ensemble de données diminue en 2025, de par sa conception, donc une question sur l'année la plus récente renvoie un résultat vide ou négatif qui ressemble à une configuration cassée. La comparaison entre 2023 et 2024 est l’histoire de croissance que contiennent réellement les données. La question comporte deux moitiés. Cette leçon et les trois suivantes travaillent sur la moitié de la catégorie ; le client revient à moitié dans la pierre angulaire, une fois que vous pouvez auditer la jointure dont il a besoin.

Votre tâche

Posez à votre agent la question de la colonne vertébrale. Faites-lui prendre les décisions avant d'écrire du code SQL : ce que signifie « croissance », s'il faut le mesurer en termes de chiffre d'affaires ou de nombre de commandes, quelle colonne de chiffre d'affaires utiliser, combien de clients comptent comme « à l'origine de cette croissance » et quel grain il reviendra. Répondez à chacun, puis demandez-lui d'écrire la requête. Lisez le SQL avant de l'exécuter. Enregistrez le résultat dans queries/agent_v1.sql.

Vous n'auditez pas encore la logique - vérifiez simplement que votre demande était suffisamment spécifique pour produire une requête que vous pouvez lire. Une fois enregistré et exécuté, confirmez la forme :

• Le résultat comporte une ligne par catégorie de produit : huit lignes, ou neuf si l'agent a conservé les lignes de commande dont l'identifiant de produit n'a pas de correspondance dans products comme son propre compartiment.
• Si l'agent a mesuré les revenus comme quantity * net_price, le total de 2024 sur un résultat de neuf lignes se rapproche de 338 209,56, le chiffre d'affaires correct de la ligne 2024. Un résultat sur huit lignes totalise plutôt 336 812,67 – 1 396,89 court. Cet écart est réel, il ne dépend pas de votre configuration, et trouver où il est allé est exactement le genre de question que la prochaine leçon vous apprend à poser.

Vérifiez votre compréhension

• Quelles sont les quatre parties d'une demande bien formée ?
• Pourquoi lire le SQL avant de l'exécuter ?
• Combien de lignes un résultat « revenus par catégorie » doit-il contenir, et que signifie une tranche supplémentaire ?

Faites-le avec votre agent

Dites next lesson et votre agent vous apprend cela, vous pose ces questions, puis définit la tâche ci-dessus. Faites-le à la main, puis dites review my work - il vérifie votre travail par rapport à une rubrique et vous indique ce qu'il faut corriger ou marque la leçon terminée.