Google Suche-Tool

Mit dem Google-Suchtool kann Ihr Agent seine Antworten auf aktuelle Informationen aus dem Web stützen und so die Unterhaltung auf realen Daten fundieren. Dieses Tool eignet sich ideal für Szenarien, die Wissen aus der ganzen Welt, aktuelle Ereignisse oder eine Vielzahl von Themen erfordern.

Konfiguration

Konfigurieren Sie beim Erstellen des Tools die folgenden Einstellungen:

  • Name: Der Anzeigename für die Tool-Instanz (z. B. search_web).
  • Beschreibung: Eine kurze Beschreibung des Zwecks des Tools. Reasoning Agents verwenden diese Beschreibung, um zu entscheiden, wann das Tool aufgerufen werden soll.
  • Ausgeschlossene Domains: Eine Liste von Domains, die aus den Suchergebnissen ausgeschlossen werden sollen (maximal 2.000). Beispiel: „www.beispiel.de“ oder „beispiel.de“
  • Bevorzugte Domains: Eine Liste von Domains, auf die Suchergebnisse beschränkt werden sollen (maximal 20). Beispiel: „www.beispiel.de“ oder „beispiel.de“
  • URLs für Kontext: Bestimmte URLs, die für den Kontext abgerufen werden sollen (maximal 20). Das Modell verwendet Inhalte von diesen Seiten direkt. Beispiel: „beispiel.de/seite/pfad“
  • Modalitäten: Sie können anpassen, wie der Agent Suchergebnisse für verschiedene Modalitäten verarbeitet und zusammenfasst:
    • Text-Prompt: Anleitung zum Verarbeiten von Suchergebnissen in Textunterhaltungen.
    • Sprachprompt: Anweisungen für die Verarbeitung von Suchergebnissen in Sprachunterhaltungen, z. B. Antworten kurz und natürlich für die Sprachausgabe zu halten und das Vorlesen von Roh-URLs zu vermeiden.

Priorität von Einstellungen

Domain- und URL-Einstellungen werden in der folgenden Reihenfolge angewendet:

  1. Ausgeschlossene Domains: Höchster Vorrang. Domains werden auch dann ausgeschlossen, wenn sie in URLs für Kontext oder Bevorzugte Domains aufgeführt sind.
  2. URLs für Kontext: Inhalte werden abgerufen, sofern die Domain nicht ausgeschlossen ist.
  3. Bevorzugte Domains: Niedrigste Priorität.

Laufzeitkontext-URLs

Zusätzlich zu den URLs für den Kontext, die in der Tool-Konfiguration angegeben sind, können Sie Ihren KI-Agenten anweisen, URLs dynamisch zur Laufzeit einzufügen.

Sie können beispielsweise Folgendes in die Anweisungen für Ihren Agenten einfügen: none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

Quellenangaben und Inline-Quellenangaben

Wenn ein Agent seine Antwort mit dem Google Suche-Tool fundiert, enthält die Laufzeitantwort Zitationsmetadaten in SessionOutput.citations, um generierte Aussagen auf Webquellen zurückzuführen.

Zitationsmetadaten bestehen aus zwei Hauptkomponenten:

  • Zitierte Blöcke (cited_chunks): Die Liste der Quelldokumente, die für die Fundierung verwendet wurden, einschließlich der Quelle uri, der Seite title, des Snippets text und des Indikators requires_attribution.
  • Inline-Zitationen (inline_citations): Genaue Bytebereich-Offsets (start_index und end_index) im Antworttext, die direkt cited_chunk_indices zugeordnet werden. Sie können Inline-Zitationen in Ihrer Clientanwendung verwenden, um interaktive hochgestellte Symbole, Fußnoten oder Inline-Links zu rendern, die an bestimmte Behauptungen in der Antwort des KI-Agenten angehängt sind.

Anforderungen an die Quellenangabe

Für Zitate, die auf Web-Grundlagen basieren, ist möglicherweise eine Quellenangabe erforderlich:

  • Prüfen Sie das Feld requires_attribution für jede CitedChunk.
  • Wenn requires_attribution den Wert true hat, muss in Ihrer Clientanwendung die Quellenangabe angezeigt und für Endnutzer ein Link zum Quell-URI bereitgestellt werden.