IBM Cloud Docs
Google-Konfiguration der angepassten Sucherweiterung

Google-Konfiguration der angepassten Sucherweiterung

Sie können auf die Google-Suche über eine Erweiterung Ihres Assistenten zugreifen, der die Google Programmable Search Engine verwendet. Es handelt sich um eine konfigurierbare Suche, die Sie basierend auf Ihrem Anwendungsfall anpassen können.

So richten Sie die Erweiterung für die Google-Suche ein:

Suchmaschinen-ID und API-Schlüssel abrufen

Erstellen Sie eine Google Programmable Search Engine. Rufen Sie dann die Suchmaschinen-ID und einen API-Schlüssel ab. Ausführliche Anweisungen finden Sie unter Create Programmable Search Engine in der Dokumentation zu Google Programmable Search Engine.

OpenAPI-Spezifikation herunterladen

Laden Sie die Spezifikationsdatei OpenAPI herunter: google-custom-search-openapi.json. Sie verwenden diese Datei, um Ihrem Assistenten die Erweiterung hinzuzufügen.

Die OpenAPI-Spezifikation definiert die folgenden Methoden:

  • GET /customsearch/v1: Suche nach Inhalten im gesamten Web.
  • GET /customsearch/v1/siterestrict: Suche nach Inhalten für eine bestimmte Gruppe von Websites.

Weitere Informationen zu den Endpunkten finden Sie unter Custom Search oder Custom Search Site Restricted.

Die Endpunkte haben dieselben Argumente und Antworten, jedoch mit Unterschieden:

  • Custom Search Site Restricted ist auf die Suche von maximal 10 Websites beschränkt, von denen jede eine unbegrenzte Anzahl von Seiten haben kann.
  • Angepasste Suche kann eine beliebige Anzahl von Websites unterstützen, die von Googleindexiert werden, verfügt jedoch über ein tägliches Abfragelimit.

Für einen typischen Assistenten, der sich auf ein bestimmtes Thema konzentriert, ist es in der Regel nur erforderlich, eine einzelne Website oder einige Websites zu durchsuchen. Custom Search Site Restricted ist eine bessere Anpassung, da es keinen Grenzwert für die Anzahl der Abfragen gibt, die pro Tag ausgeführt werden können. Assistenten, die mehr als 10 Websites durchsuchen müssen, müssen stattdessen Angepasste Suche verwenden.

Erweiterung erstellen und hinzufügen

  1. Klicken Sie in Ihrem Assistenten auf der Seite Integrationen auf Angepasste Erweiterung erstellen und verwenden Sie die Spezifikationsdatei OpenAPI, um eine angepasste Erweiterung zu erstellen. Allgemeine Anweisungen zum Erstellen einer angepassten Erweiterung finden Sie unter Angepasste Erweiterung erstellen.

  2. Nachdem Sie die angepasste Sucherweiterung Google erstellt haben und sie auf Ihrer Seite Integrationen erscheint, klicken Sie auf Hinzufügen, um sie zu Ihrem Assistenten hinzuzufügen. Verwenden Sie Ihren programmierbaren API-Schlüssel für die Google-Suchmaschine für die Authentifizierung. Allgemeine Anweisungen zum Hinzufügen einer angepassten Erweiterung finden Sie unter Erweiterung zum Assistenten hinzufügen.

Fügen Sie die Aktionsvorlage für das Google-Starter-Kit für die angepasste Suche hinzu

  1. Öffnen Sie die Seite Aktionen.

  2. Wenn Sie keine Aktionen haben, wählen Sie Neue Aktion erstellen aus. Wenn Sie bereits über einige Aktionen verfügen, wählen Sie Neue Aktion aus.

  3. Wählen Sie unter Aktion erstellen die Option Schnelleinstieg mit Vorlagen.

    Schnelleinstieg mit Vorlagen ist nur in englischsprachigen Assistenten verfügbar.

  4. Fügen Sie unter Schnelleinstieg mit Vorlagen das Starter-Kit für die angepasste Suche Google hinzu.

Systemaktionen bearbeiten

  1. Klicken Sie auf Durch Assistenten festlegen und öffnen Sie die Aktion Keine Übereinstimmungen.

  2. Löschen Sie die beiden Standardschritte.

  3. Fügen Sie einen Schritt hinzu. Setzen Sie Und dann auf Zu einer Unteraktion wechseln und wählen Sie die Aktion Google-Suche aus.

  4. Wenn Sie Ihre Kunden nicht mit einem Live-Agenten verbinden, können Sie die Aktion Fallback auf dieselbe Weise bearbeiten wie Keine Übereinstimmungen.

Angepasste Google-Sucherweiterung verwenden

Setzen Sie eine Abfrage an Ihren Assistenten ab. Wenn keine Aktion dieser Abfrage entspricht, wird Google verwendet, um Suchergebnisse zu erzeugen.

Größe der Suchergebnisse begrenzen

Für watsonx Assistant gilt ein Grenzwert von 100 KB für die Größe von Informationen, die in Kontextvariablen gespeichert werden, einschließlich Suchergebnissen. Wenn die Ergebnisse Ihrer Erweiterung diesen Grenzwert überschreiten, kann die Aktion ohne sichtbare Warnungen oder Fehler fehlschlagen. In der Regel tritt eine lange Verzögerung auf und es gibt keine Antwort. Dieser Fehler tritt selten bei der angepassten Google-Sucherweiterung auf, aber er kann auftreten, wenn Sie eine Site mit großen Mengen von Metadaten durchsuchen, die von der angepassten Google-Suche zurückgegeben werden. Wenn Sie denken, dass dies ein Problem sein könnte, versuchen Sie, die Abfrage in einem API-Testtool wie curl, Insomnia oder Postman auszuführen. Überprüfen Sie, wie viele Datenbytes Sie als Suchergebnisse erhalten. Wenn die Summe bei oder nahe 100 KB liegt, können Sie das Problem möglicherweise umgehen, indem Sie num_of_results reduzieren und weniger Ergebnisse für jede Abfrage erhalten oder indem Sie Sites oder Seiten mit großen Metadatenvolumen ausschließen.

Weitere Informationen finden Sie unter Größe der Suchergebnisse begrenzen in einem Starter-Kit für IBM Watson® Discovery.