Code Sandbox
Eseguire calcoli programmatici sui dati di Google Search Console — somme, medie, raggruppamenti e scomposizioni filtrate senza numeri allucinati.
Perché Esiste
I modelli di linguaggio creano numeri falsi. Chiedete a un chatbot “qual'è il numero totale di clic?” e produrrà una cifra plausibile che potrebbe essere completamente sbagliata. Code Sandbox risolve questo — quando l'agente ha bisogno di un risultato numerico, chiama lo strumento code_sandbox per eseguire un vero calcolo sui dati di Google Search Console sincronizzati e restituire la risposta esatta.
Ogni numero che l'agente riporta dai vostri dati di Google Search Console proviene da Code Sandbox, non dal modello di linguaggio. L'LLM gestisce il ragionamento e la strategia; la sandbox gestisce l'aritmetica.
Operazioni Disponibili
Sei operazioni vengono eseguite sui dati sincronizzati di Google Search Console per il progetto corrente:
| Operazione | Che cosa fa | Caso d'uso |
|---|---|---|
| sum | Somma i valori per un campo numerico | Clic totali in un set di parole chiave |
| avg | Media aritmetica di un campo numerico | Posizione media per parole chiave filtrate |
| min | Valore più piccolo nel campo | Posizione di ranking migliore in un set |
| max | Valore più grande nel campo | Numero di impressioni massimo per una singola parola chiave |
| count | Numero di righe corrispondenti | Parole chiave che corrispondono a una condizione di filtro |
| group | Segmenta per un campo, restituisce somma/media/conteggio per gruppo (primi 20) | Clic suddivisi per URL di pagina |
Campi e Filtri
Le operazioni vengono eseguite su questi campi: clicks, impressions, ctr (decimale, ad es. 0,05 = 5%), position, query e page. Delimitate qualsiasi operazione a un sottoinsieme utilizzando filtri — un filtro combina un campo, un operatore e un valore, e più filtri possono essere applicati insieme.
| Operatore | Significato | Esempio |
|---|---|---|
| eq | Corrispondenza esatta | page eq /blog/seo-guide |
| gt / lt | Maggiore / minore di | position gt 10 |
| gte / lte | Maggiore / minore di o uguale a | clicks gte 100 |
| contains | Contiene stringa (campi query/page) | query contains seo |
Non avete bisogno di conoscere la sintassi dei filtri. Descrivete quello che volete in linguaggio naturale e l'agente lo traduce nell'operazione, nei campi e nei filtri corretti.
Raggruppamento
L'operazione group segmenta i vostri dati per un campo e restituisce somma, media e conteggio per segmento (primi 20). Raggruppate per pagina per vedere quali URL generano più traffico, oppure per query per trovare cluster di parole chiave.
“Raggruppa le mie parole chiave per pagina e mostra quale pagina riceve più impressioni”
Esegue un'operazione di gruppo sul campo della pagina, restituendo impressioni totali, CTR medio e conteggio delle parole chiave per URL.
Prompt di Esempio
“Qual è il numero totale di clic su tutte le parole chiave questo mese? Mi serve il numero esatto”
Attiva un'operazione di somma sul campo dei clic senza filtro — restituisce il totale preciso.
“Calcola la posizione media per le parole chiave contenenti 'seo' rispetto a tutte le altre parole chiave”
Esegue due operazioni di media con filtri contains opposti e presenta un confronto affiancato.
“Quante parole chiave hanno un CTR inferiore all'1% ma più di 500 impressioni?”
Un'operazione di conteggio con due filtri: ctr lte 0,01 e impressions gte 500.
Suggerimenti
- Chiedete numeri esatti — dire “numero esatto” segnala all'agente di utilizzare Code Sandbox piuttosto che fare una stima.
- Segmentate per intervalli di posizione — il raggruppamento per 1-3, 4-10, 11-20 offre un quadro istantaneo della distribuzione del vostro ranking.
- Combinate filtri con raggruppamento — ad es. “raggruppa per pagina ma solo per parole chiave brand” isola il traffico brand per URL.
- Abbinati a GSC Query — dopo aver estratto le parole chiave con
gsc_query, chiedete follow-up aggregati. L'agente esegue i calcoli della sandbox sullo stesso contesto dati.
Provi questi prompt
Argomenti correlati
© 2026 Agentic SEO. Tutti i diritti riservati.