Utilizzare i suggerimenti di Ricerca Google

Per utilizzare grounding con la Ricerca Google, devi attivare i suggerimenti per la Ricerca Google, che aiutano gli utenti a trovare i risultati di ricerca corrispondenti a una risposta con grounding.

In particolare, devi visualizzare le query di ricerca incluse nei metadati della risposta basata su dati. La risposta include:

  • content: risposta generata tramite LLM
  • webSearchQueries: le query da utilizzare per i suggerimenti di Ricerca Google

Ad esempio, nel seguente snippet di codice, Gemini risponde a un prompt basato sulla ricerca che chiede informazioni su un tipo di pianta tropicale.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

Puoi utilizzare questa uscita e visualizzarla utilizzando i suggerimenti della Ricerca Google.

Requisiti per i suggerimenti della Ricerca Google

Azione consigliata:

  • Mostrare il Suggerimento di ricerca esattamente come fornito senza alcuna modifica nel rispetto dei Requisiti di visualizzazione.
  • Indirizzare gli utenti direttamente alla pagina dei risultati della Ricerca Google (SRP) quando interagiscono con il Suggerimento di ricerca.

Azione sconsigliata:

  • Includi eventuali schermate intermedie o passaggi aggiuntivi tra il tocco dell'utente e la visualizzazione della SRP.
  • Mostrare altri risultati di ricerca o suggerimenti accanto al Suggerimento di ricerca o alla risposta LLM fondata associata.

Requisiti di visualizzazione

  • Mostrare il Suggerimento di ricerca esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il suggerimento di ricerca viene visualizzato come specificato nei seguenti mock, anche per la modalità chiara e scura: Visualizzazione simulata del suggerimento di ricerca

  • Ogni volta che viene mostrata una risposta basata su fatti, il corrispondente suggerimento della Ricerca Google deve rimanere visibile.

  • Branding: devi seguire rigorosamente le linee guida di Google relative all'utilizzo degli elementi distintivi del brand Google da parte di terze parti.

  • I suggerimenti della Ricerca Google devono avere almeno la larghezza completa della risposta basata su fatti.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a una pagina dei risultati della Ricerca Google (SRP) per il termine di ricerca visualizzato nel chip. L'SRP può aprirsi all'interno del browser in-app o in un'app browser separata. È importante non ridurre a icona, rimuovere o ostacolare in alcun modo il display dell'SRP. Il seguente modello animato illustra l'interazione tocco per SRP.

utente che accede alla pagina dei risultati di ricerca

Codice per implementare un suggerimento della Ricerca Google

Quando utilizzi l'API per basare una risposta alla ricerca, la risposta del modello fornisce stili HTML e CSS conformi nel campo renderedContent che implementi per visualizzare i suggerimenti di ricerca nella tua applicazione. Per un esempio di risposta dell'API, consulta la sezione sulla risposta in Utilizzo della Ricerca Google.

Passaggi successivi