Come catturare le query di
grounding di Google AI Mode
Quando Google AI Mode decide che una domanda ha bisogno del web in tempo reale, scrive le proprie ricerche su Google, le esegue e cita una manciata di domini. Non tutti i prompt attivano una ricerca. Quando uno lo fa, le ricerche le dicono per quali query le sue pagine devono comparire. Ecco come vederle, con il codice e con Moose.
Gemini ha usato 6 query di grounding di Google per questo prompt.
miglior software paghe per un'azienda di 20 persone
- miglior software paghe per piccole imprese 2026
- prezzo software paghe 20 dipendenti al mese
- migliori fornitori paghe piccole imprese recensioni
- software paghe con gestione benefit per piccole imprese
- miglior software paghe per startup prezzi ufficiali
- confronto software paghe piccole imprese funzionalità
- forbes.com
- nerdwallet.com
- g2.com
- capterra.com
- businessnewsdaily.com
- pcmag.com
- techrepublic.com
- usnews.com
- softwareadvice.com
Che cos'è una query di grounding?
Una query di grounding è una ricerca su Google che il modello scrive per sé prima di risponderle. Legge il suo prompt, valuta se cercare renderebbe la risposta migliore e, in caso affermativo, scrive una o più ricerche proprie e le esegue. Non cerca mai la frase che ha digitato lei.
Quando cerca, tornano due cose ed entrambe si possono recuperare: le query che ha scritto e i domini che ha citato. Una le dice che cosa è stato cercato, l'altra chi è stato citato. Quando non cerca, vale la pena saperlo comunque: il modello ha risposto con quello che già sapeva.
Come catturare le query di grounding con il codice
Questo non è un problema di scraping. Una risposta con grounding torna come un elenco di passaggi, e uno di essi, google_search_call, contiene le query esatte che il modello ha eseguito. Una trentina di righe le danno una cattura. Il lavoro sta nell'eseguirla per molti prompt nel tempo.
# grounding.py · the queries Google wrote for itself import os, json from google import genai PROMPT = "miglior software paghe per un'azienda di 20 persone" client = genai.Client(api_key=os.environ["GEMINI_API_KEY"]) interaction = client.interactions.create( model="gemini-3.6-flash", input=PROMPT, # search is opt-in here. the model still decides # on its own whether this prompt needs it. tools=[{"type": "google_search"}], ) queries, sources = [], [] for step in interaction.steps: if step.type == "google_search_call": queries += step.arguments["queries"] if step.type == "model_output": for block in step.content: # citations hang off spans of the answer text for a in (block.annotations or []): if a.type == "url_citation": sources.append(a.title) print(json.dumps({ "prompt": PROMPT, "queries": queries, # empty means it never searched "sources": sorted(set(sources)), }, indent=2))
// grounding.mjs · same call, node import { GoogleGenAI } from '@google/genai'; const PROMPT = 'miglior software paghe per un'azienda di 20 persone'; const client = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY }); const interaction = await client.interactions.create({ model: 'gemini-3.6-flash', input: PROMPT, // search is opt-in here. the model still decides // on its own whether this prompt needs it. tools: [{ type: 'google_search' }], }); const queries = []; const sources = []; for (const step of interaction.steps) { if (step.type === 'google_search_call') queries.push(...step.arguments.queries); if (step.type === 'model_output') for (const block of step.content) // citations hang off spans of the answer text for (const a of block.annotations ?? []) if (a.type === 'url_citation') sources.push(a.title); } console.log(JSON.stringify({ prompt: PROMPT, queries, // empty means it never searched sources: [...new Set(sources)].sort(), }, null, 2));
Una cattura è un prompt in un momento. La versione utile sono cinquanta prompt pianificati, deduplicati e confrontati con il mese scorso.
È il modello a decidere se il prompt ha bisogno del web. Quando decide di no, non c'è alcun passaggio di ricerca e niente le spiega perché. Deve intercettare il caso vuoto e decidere se è da riprovare o è un risultato vero.
Le fonti arrivano come annotazioni agganciate a intervalli di caratteri della risposta, non come un elenco. Per arrivare ai nove domini bisogna scorrere ogni annotazione e deduplicare.
Sui modelli Gemini 3 ogni ricerca eseguita dal modello viene fatturata a parte, quindi un prompt che fa grounding sei volte costa sei ricerche.
Le query significano qualcosa solo accanto alla cattura precedente, quindi finisce per mantenere un database oltre a uno script.
Con Moose lo chiede in chat
Stessa chiamata, stesso campo, senza l'impiantistica. Moose conserva ogni esecuzione, così vede che cosa è cambiato dal mese scorso.
Scriva «cattura le query di grounding di AI Mode», oppure usi il chip di avvio rapido nel campo di scrittura. Nessuna chiave da incollare.
Una domanda che il suo acquirente scriverebbe davvero. Moose la esegue con grounding ed estrae dalla risposta le query e i domini citati.
Query e fonti finiscono nella sua libreria, esportabili e confrontabili con ogni cattura precedente dello stesso prompt.
Come per la cattura delle query derivate. L'esecuzione deve andare direttamente a Google con il search grounding attivo, e l'accesso instradato tramite OpenRouter elimina i metadati di grounding prima che arrivino a lei. Sui piani BYOK tutto il resto di Moose continua a funzionare, compresa la verifica istantanea di visibilità su cinque motori di ricerca AI. Questa singola funzione no.
Che cosa fare con le query
Quelle ricerche decidono quali pagine vengono recuperate e lette, quindi contano più della formulazione esatta scritta dal suo acquirente.
Dimensione aziendale, prezzo, integrazione, settore: la specificazione che compare nelle query di grounding è quella da cui Google pensa che dipenda la risposta. Costruisca la pagina intorno a quelle.
Stesso prompt, stessi nove siti, settimana dopo settimana. Se lei non è tra loro, quella è la distanza. Se lo è, tenga quella pagina aggiornata.
Le query cambiano man mano che cambiano l'indice e il modello. Una query che compare per diverse settimane di fila è un tema che merita una pagina.
Query derivate e grounding, fianco a fianco
Entrambi i motori scompongono la sua domanda prima di cercare. Che cosa espongono, quante ricerche eseguono e come ci si arriva sono tre cose diverse.
Le domande che ci fanno davvero
Sono letteralmente le query che esegue AI Mode?
Le query vengono dai metadati di grounding di Gemini, cioè dallo stesso meccanismo di search grounding su cui è costruito AI Mode, attraverso l'API pubblica. In pratica gli insiemi di query somigliano a quello che produce AI Mode, ma non è una registrazione di google.com/aimode in sé, quindi lo consideri un'approssimazione vicina.
Perché mi sono tornate solo due query?
Perché il modello ha deciso che due bastavano. Le domande strette, locali o molto battute fanno grounding con una o due ricerche. Le domande ampie di confronto ne tirano spesso sei o più. Un prompt che fa molto grounding è uno in cui la risposta è ancora contesa.
Le query cambiano se rieseguo lo stesso prompt?
Sì, ai margini. Le ricerche centrali sono stabili, la coda lunga si muove, e i domini citati si muovono più in fretta delle query. Esegua lo stesso prompt in modo pianificato e guardi che cosa entra e che cosa esce.
Perché non c'è un elenco pulito delle fonti citate?
Perché Google non ne restituisce uno. Le citazioni tornano attaccate a porzioni del testo della risposta, ciascuna con un URL e un titolo che di solito è solo il dominio. Moose scorre ogni annotazione, deduplica e le mostra i domini.
Dovrei scrivere una pagina per ogni query di grounding?
Di solito no. Sei query attorno a una sola domanda d'acquisto sono servite meglio da una pagina forte che le copra tutte e sei. L'insieme di query le dice che cosa deve esserci sulla pagina: il prezzo, la specificazione sulla dimensione, il confronto, il taglio delle recensioni indipendenti.
Altre cose da chiedere a Moose
Tutti i casi d'usoLa stessa domanda per l'altro motore. Dodici ricerche dietro un prompt, e come vederle.
Una domanda, cinque motori, circa un minuto. Gratis su ogni piano.
Un indice semantico di ogni pagina, costruito e conservato sul suo computer. Gli chieda che cosa copre.
I primi 10 risultati, le domande correlate, l'AI Overview e le sue fonti, tutto citato nel brief.
Quando la quota scende, Moose trova la pagina, prepara la correzione e aspetta la sua approvazione.
L'elenco completo e che cosa fa Moose passo per passo in ciascuno.
Veda le ricerche dietro
la risposta.
Scarichi Hi, Moose, apra una chat e lo chieda. La cattura del grounding richiede il piano gestito. L'app è gratis da installare e le verifiche di visibilità sono gratis da eseguire.