Usare i suggerimenti della Ricerca Google

Quando utilizzi Grounding con la Ricerca Google e ricevi i suggerimenti di ricerca di Google nella risposta, devi visualizzare i suggerimenti di ricerca in produzione e nelle tue app.

Per ulteriori informazioni su Grounding con la Ricerca Google, consulta Grounding con la Ricerca Google.

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

  • "content": risposta generata dall'LLM.
  • "webSearchQuery": 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 Google 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 visualizzare questo output e visualizzarlo utilizzando i Suggerimenti di Ricerca Google.

Requisiti per i suggerimenti della Ricerca Google

Da fare:

  • Mostrare il suggerimento di ricerca esattamente come fornito senza alcuna modifica nel rispetto dei requisiti di visualizzazione riportati di seguito.
  • Indirizza gli utenti direttamente alla pagina dei risultati di ricerca di Google (SRP) quando interagire con il suggerimento di ricerca.

Azione sconsigliata:

  • Includi eventuali schermate interstitial o passaggi aggiuntivi tra la toccare e visualizzare l'SRP
  • Visualizza altri risultati di ricerca o suggerimenti insieme ai suggerimenti di ricerca o una risposta LLM basata su grounding associata.

Requisiti del display

  • Visualizza il suggerimento di ricerca esattamente come fornito e non apportare alcuna modifica a colori, caratteri o aspetto. Assicurati che il suggerimento per la ricerca venga visualizzato come specificato nei seguenti simulazioni, anche per la modalità Luce e Buio:
  • Ogni volta che viene mostrata una risposta basata su fatti, il relativo suggerimento della Ricerca Google deve rimanere visibile.
  • Branding: devi rispettare rigorosamente le linee guida di Google relative all'utilizzo degli elementi distintivi del brand Google da parte di terze parti.
  • I suggerimenti di Ricerca Google devono occupare almeno l'intera larghezza della risposta con grounding.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a un risultato della Ricerca Google. pagina (SRP) per il termine di ricerca visualizzato nel chip. La pagina di risultati di ricerca può aprirsi nel browser in-app o in un'app browser separata. È importante non ridurre a icona, rimuovere o ostruire in alcun modo la visualizzazione della pagina di risultati di ricerca. I seguenti elementi animati il modello illustra l'interazione tocco per SRP.

esempio di app/desktop

Codice per implementare un suggerimento nella 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 dell'API risposta, consultare la sezione sulla risposta in Utilizzo della Ricerca Google.

Passaggi successivi