Strumento di Ricerca Google

Lo strumento della Ricerca Google consente all'agente di basare le sue risposte su informazioni aggiornate del web, ancorando di fatto la conversazione a dati del mondo reale. Questo strumento è ideale per gli scenari che richiedono conoscenze del mondo, eventi attuali o un'ampia gamma di argomenti.

Configurazione

Configura le seguenti impostazioni durante la creazione dello strumento:

  • Nome: Il nome visualizzato per l'istanza dello strumento (ad esempio: search_web).
  • Descrizione: Una breve descrizione dello scopo dello strumento. Gli agenti di ragionamento utilizzano questa descrizione per decidere quando richiamare lo strumento.
  • Domini esclusi: Un elenco di domini da escludere dai risultati di ricerca (massimo 2000). Ad esempio: "www.example.com" o "example.com"
  • Domini preferiti: Un elenco di domini a cui limitare i risultati di ricerca (massimo 20). Ad esempio: "www.example.com" o "example.com"
  • URL per il contesto: URL specifici da recuperare per il contesto di base (max. 20). Il modello utilizza direttamente i contenuti di queste pagine. Ad esempio: "example.com/page/path"
  • Modalità: Personalizza il modo in cui l'agente elabora e riepiloga i risultati di ricerca per diverse modalità:
    • Prompt testuale: istruzioni per l'elaborazione dei risultati di ricerca nelle conversazioni di testo.
    • Prompt vocale: istruzioni per l'elaborazione dei risultati di ricerca nelle conversazioni vocali (ad esempio, mantenere le risposte concise e naturali per la voce ed evitare di recitare URL non elaborati).

Priorità delle impostazioni

Le impostazioni di dominio e URL vengono applicate nel seguente ordine:

  1. Domini esclusi: precedenza più alta. I domini vengono esclusi anche se sono elencati in URL per il contesto o Domini preferiti.
  2. URL per il contesto: i contenuti vengono recuperati a meno che il dominio non sia escluso.
  3. Domini preferiti: precedenza più bassa.

URL contesto di runtime

Oltre agli URL per il contesto forniti nella configurazione dello strumento, puoi istruire l'agente a inserire dinamicamente gli URL in fase di runtime.

Ad esempio, puoi aggiungere quanto segue nelle istruzioni per l'agente: none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

Citazioni e citazioni in linea

Quando un agente basa la sua risposta utilizzando lo strumento della Ricerca Google, la risposta di runtime include i metadati di citazione in SessionOutput.citations per risalire alle fonti web delle affermazioni generate.

I metadati delle citazioni contengono due componenti principali:

  • Brani citati (cited_chunks): L'elenco dei documenti di origine utilizzati per il grounding, inclusi l'origine uri, la pagina title, lo snippet text e l'indicatore requires_attribution.
  • Citazioni in linea (inline_citations): Offset precisi dell'intervallo di byte (start_index e end_index) nel testo della risposta che mappano direttamente cited_chunk_indices. Puoi utilizzare le citazioni in linea nella tua applicazione client per visualizzare badge interattivi in apice, note a piè di pagina o link in linea ancorati a specifiche affermazioni nella risposta dell'agente.

Requisiti di attribuzione

Le citazioni restituite dalla base web potrebbero richiedere l'attribuzione alla fonte originale:

  • Controlla il campo requires_attribution in ogni CitedChunk.
  • Se requires_attribution è true, l'applicazione client deve mostrare l'attribuzione dell'origine e il link all'URI di origine per gli utenti finali.