Utilizzare i suggerimenti della Ricerca Google

Quando utilizzi il grounding con la Ricerca Google e ricevi suggerimenti di ricerca nella risposta, devi visualizzarli in produzione e nelle tue applicazioni.

Per ulteriori informazioni sul grounding con la Ricerca Google, consulta Grounding con la Ricerca Google.

In particolare, devi mostrare 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.

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 questo output e visualizzarlo utilizzando i suggerimenti di ricerca.

Requisiti per i suggerimenti di ricerca

Di seguito sono riportati i requisiti per i suggerimenti:

Requisito Descrizione
Azioni consigliate
  • Nel rispetto dei requisiti di visualizzazione, il suggerimento di ricerca viene visualizzato esattamente come fornito senza alcuna modifica.
  • Quando interagisci con il suggerimento di ricerca, viene visualizzata direttamente la pagina dei risultati di ricerca (SERP).
Azioni sconsigliate
  • Includi eventuali schermate 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

Di seguito sono riportati i requisiti per la visualizzazione:

  • Mostrare il suggerimento di ricerca esattamente come fornito e non apportare modifiche a colori, caratteri o aspetto. Assicurati che il suggerimento di ricerca venga visualizzato come specificato nei seguenti simulati, ad esempio la modalità chiara e scura:

  • Ogni volta che viene mostrata una risposta basata su fatti, il corrispondente suggerimento di ricerca deve rimanere visibile.
  • Per il branding, devi seguire rigorosamente le linee guida di Google per l'utilizzo da parte di terze parti degli elementi distintivi del brand Google, disponibili nel Welcome to our Brand Resource Centre.
  • Quando utilizzi il grounding con la Ricerca, vengono visualizzati i chip di suggerimenti di ricerca. Il campo che contiene i chip di suggerimento deve avere la stessa larghezza della risposta fondata dell'LLM.

Comportamento al tocco

Quando un utente tocca il chip, viene indirizzato direttamente a una pagina dei risultati di ricerca (RSD) per il termine di ricerca visualizzato nel chip. L'SRP può aprirsi nel browser in-app o in un'applicazione browser distinta. È importante non ridurre a icona, rimuovere o ostacolare in alcun modo la visualizzazione della scheda RP. Il seguente mockup animato illustra l'interazione con il tocco per aprire la scheda di ricerca.

Esempio di app/computer

Codice per implementare un suggerimento di ricerca

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 visualizzare un esempio di risposta dell'API, consulta la sezione relativa alla risposta in Grounding with Search.

Passaggi successivi