Sandbox de code
Exécutez des calculs programmatiques sur vos données GSC — sommes, moyennes, regroupements et analyses filtrées sans aucun chiffre hallucindé.
Raison d'être
Les LLM inventent des chiffres. Posez à un chatbot « combien de clics au total ? » et il produira un chiffre plausible qui peut être complètement faux. La Sandbox de code résout ce problème — quand l'agent a besoin d'un résultat numérique, il appelle l'outil code_sandbox pour exécuter un vrai calcul sur vos données GSC synchronisées et retourner la réponse exacte.
Chaque chiffre que l'agent rapporte de vos données GSC provient de la Sandbox de code, pas du modèle de langage. Le LLM gère le raisonnement et la stratégie ; le sandbox gère l'arithmétique.
Opérations disponibles
Six opérations s'exécutent sur vos données GSC synchronisées pour le projet actuel :
| Opération | Ce qu'elle fait | Cas d'usage |
|---|---|---|
| sum | Additionne les valeurs d'un champ numérique | Clics totaux pour un ensemble de mots-clés |
| avg | Moyenne arithmétique d'un champ numérique | Position moyenne pour les mots-clés filtrés |
| min | Plus petite valeur du champ | Meilleure position de classement dans un ensemble |
| max | Plus grande valeur du champ | Nombre d'impressions le plus élevé pour un mot-clé |
| count | Nombre de lignes correspondantes | Mots-clés correspondant à une condition de filtre |
| group | Segmente par un champ, retourne somme/moyenne/nombre par groupe (top 20) | Clics ventilés par URL de page |
Champs et filtres
Les opérations s'exécutent sur ces champs : clicks, impressions, ctr (décimal, ex. 0,05 = 5%), position, query et page. Limitez n'importe quelle opération à un sous-ensemble en utilisant des filtres — un filtre combine un champ, un opérateur et une valeur, et plusieurs filtres peuvent être appliqués ensemble.
| Opérateur | Signification | Exemple |
|---|---|---|
| eq | Correspondance exacte | page eq /blog/seo-guide |
| gt / lt | Supérieur / inférieur à | position gt 10 |
| gte / lte | Supérieur / inférieur ou égal | clicks gte 100 |
| contains | Contient (champs query/page) | query contains seo |
Vous n'avez pas besoin de connaître la syntaxe des filtres. Décrivez ce que vous voulez en français courant et l'agent le traduit dans la bonne opération, les bons champs et filtres.
Regroupement
L'opération group segmente vos données par un champ et retourne la somme, la moyenne et le nombre par segment (top 20). Regroupez par page pour voir quelles URL génèrent le plus de trafic, ou par query pour trouver des clusters de mots-clés.
“Grouper mes mots-clés par page et afficher la page qui obtient le plus d'impressions”
Exécute une opération de regroupement sur le champ page, retournant les impressions totales, le CTR moyen et le nombre de mots-clés par URL.
Exemples de questions
“Quel est mon nombre total de clics pour tous les mots-clés ce mois-ci ? J'ai besoin du nombre exact”
Déclenche une opération sum sur le champ clicks sans filtre — retourne le total précis.
“Calculer la position moyenne pour les mots-clés contenant « seo » par rapport à tous les autres mots-clés”
Exécute deux opérations avg avec des filtres contains opposés et présente une comparaison côte à côte.
“Combien de mots-clés ont un CTR inférieur à 1 % mais plus de 500 impressions ?”
Une opération count avec deux filtres : ctr lte 0.01 et impressions gte 500.
Conseils
- Demandez des nombres exacts — dire « nombre exact » signale à l'agent d'utiliser la Sandbox de code plutôt que d'estimer.
- Segmentez par plages de positions — regrouper par 1-3, 4-10, 11-20 donne une image instantanée de votre distribution de classements.
- Combinez les filtres avec le regroupement — par ex. « grouper par page mais uniquement pour les mots-clés de marque » isole le trafic de marque par URL.
- Associez avec GSC Query — après avoir extrait les mots-clés avec
gsc_query, posez des questions d'agrégation. L'agent exécute les calculs du sandbox sur le même contexte de données.
Essayez ces prompts
Sur le même sujet
© 2026 Agentic SEO. Tous droits réservés.