Erweiterte automatische Vervollständigung konfigurieren

Auf dieser Seite wird die erweiterte Funktion zur automatischen Vervollständigung von Gemini Enterprise beschrieben.

Wie bei der einfachen automatischen Vervollständigung werden auch bei der erweiterten automatischen Vervollständigung Anfragevorschläge auf Grundlage der ersten Zeichen generiert, die für die Anfrage eingegeben wurden.

Bevor Sie diese Seite lesen, sollten Sie sich mit der grundlegenden automatischen Vervollständigung von Gemini Enterprise vertraut machen. Weitere Informationen finden Sie unter Automatische Vervollständigung konfigurieren.

Wichtige Funktionen der erweiterten automatischen Vervollständigung

Die wichtigsten Funktionen der erweiterten automatischen Vervollständigung, die sie von der einfachen automatischen Vervollständigung unterscheiden, sind:

  • Zusammengeführte Suche: Die erweiterte automatische Vervollständigung kann mit Anwendungen verwendet werden, die mit mehr als einem Datenspeicher verbunden sind.

  • Zugriffssteuerung: Die erweiterte automatische Vervollständigung berücksichtigt die Zugriffssteuerung. (Zugriffssteuerungen werden auch als ACLs, Access Control Lists, bezeichnet.) Bei der erweiterten automatischen Vervollständigung werden nur Suchanfragen vorgeschlagen, die sich auf Dokumente beziehen, auf die der Suchende Zugriff hat. Informationen zur Zugriffssteuerung finden Sie unter Identität und Berechtigungen.

  • Sprachoptimierung: Die erweiterte automatische Vervollständigung kann so eingestellt werden, dass Vorschläge in einer oder mehreren Sprachen bevorzugt werden. Wenn die Browsersprache beispielsweise Niederländisch ist, können automatisch vervollständigte Vorschläge in dieser Sprache bevorzugt werden. Weitere Informationen finden Sie unter Anfrage zur automatischen Vervollständigung mit Sprachoptimierung senden.

Hinweis

Bevor Sie die erweiterte automatische Vervollständigung verwenden, müssen Sie Folgendes tun:

  • Überprüfen Sie die Einstellungen für die automatische Vervollständigung für Ihre Anwendung und bearbeiten Sie sie optional. Weitere Informationen finden Sie unter Einstellungen für die automatische Vervollständigung aktualisieren.

  • Legen Sie für kleinere Datenspeicher Automatische Vervollständigung aktivieren auf Jetzt fest. Wir empfehlen dies, da kleine Datenspeicher möglicherweise nicht genügend Daten enthalten, um genaue Vorschläge zu liefern.

  • Wenn Ihre Datenspeicher personenidentifizierbare Informationen enthalten oder Sie das Modell für Verlauf in der Google Suche oder Nutzerereignisse verwenden, lesen Sie den Abschnitt Schutz vor Lecks personenidentifizierbarer Informationen und richten Sie Schutzmaßnahmen zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) ein, die möglicherweise erforderlich sind, um Lecks personenidentifizierbarer Informationen zu verhindern.

  • Wenn Sie aktuelle Suchvorschläge (RECENT_SEARCH) verwenden möchten, müssen Sie Suchnutzerereignisse aufzeichnen. Gemini Enterprise füllt den Index der letzten Suchanfragen nicht automatisch, wenn Suchanfragen mit der Methode SearchService.Search ausgeführt werden. Wenn Sie die letzten Suchanfragen zurückgeben möchten, müssen Sie Suchnutzerereignisse mit der Methode userEvents.write aufzeichnen. Weitere Informationen finden Sie unter Vorbereitung für aktuelle Abfragen.

Anfragen für automatische Vervollständigung senden

Im Folgenden wird gezeigt, wie Sie erweiterte Anfragen zur automatischen Vervollständigung mit der Methode completionConfig.completeQuery senden.

REST

So senden Sie eine Anfrage für automatische Vervollständigung über die API:

  1. App-ID suchen. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

      Gehen Sie zu Apps

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Rufen Sie die Methode completionConfig.completeQuery auf.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.

    • APP_ID: die ID der App.

    • QUERY_STRING: Die typeahead-Eingabe, mit der Vorschläge abgerufen werden

Anfrage für automatische Vervollständigung mit Sprachoptimierung senden

Sie können automatisch vervollständigte Vorschläge nach Sprachcode priorisieren oder depriorisieren, d. h. automatisch vervollständigte Vorschläge in bestimmten Sprachen mehr oder weniger wahrscheinlich machen.

Der Optimierungswert muss zwischen -1 und 1 liegen. Wenn Sie eine negative Zahl festlegen, werden automatisch vervollständigte Vorschläge in dieser Sprache „vergraben“. Eine positive Zahl hebt die Sprache hervor.

Verwenden Sie zweistellige Sprach-Tags, die von BCP 47 definiert wurden, z. B. en, fr, hi und zh.

REST

So senden Sie eine Anfrage für automatische Vervollständigung, die einen Wert für die Sprachoptimierung enthält:

  1. App-ID suchen. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

      Gehen Sie zu Apps

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Rufen Sie die Methode completionConfig.completeQuery auf.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "boostSpec": {
         "conditionBoostSpecs": [{
           "condition": "(langCode: ANY(LANG_CODE))",
           "boost": BOOST_VALUE
         }]
      }
    }'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.

    • APP_ID: die ID der App.

    • QUERY_STRING: Die typeahead-Eingabe, mit der Vorschläge abgerufen werden

    • LANG_CODE: der aus zwei Buchstaben bestehende Code für eine oder mehrere Sprachen, in maskierten Anführungszeichen. Beispiel: \"fr\", \"es\", um den Optimierungswert auf Spanisch und Französisch anzuwenden.

    • BOOST_VALUE: eine Gleitkommazahl zwischen -1 und 1. Wenn der Wert negativ ist, werden automatische Vorschläge in der Sprache herabgestuft (sie werden weiter unten in der Liste der Vorschläge angezeigt). Wenn der Wert positiv ist, werden die Vorschläge hochgestuft (sie werden weiter oben in der Liste angezeigt).

Anfrage für automatische Vervollständigung senden und Rich-Vorschläge zurückgeben

Die Rich-Autovervollständigung gibt Inhalte (Dokumente) zurück, deren Titel Wörter enthalten, die mit der Abfrage beginnen.

Zusätzlich zum Titel des Dokuments gibt die Anfrage zur automatischen Vervollständigung die source_type und entity_type sowie, falls verfügbar, die Schlüsselattribute uri, create_time und update_time zurück. Auf dem Tab Schema der Datenspeicherseite können Sie die Zuordnungen von Schlüsselattributen ansehen und bearbeiten.

Wie bei allen erweiterten automatisch vervollständigten Vorschlägen werden ACLs für alle vorgeschlagenen Dokumente berücksichtigt.

Beispiel

Ein Mitarbeiter sucht auf der Intranet-Website seines Unternehmens nach technischen Informationen zu Zugriffsberechtigungen.

Der Mitarbeiter beginnt mit der Eingabe von tec und die folgenden Dokumente werden möglicherweise zurückgegeben: Data technicians handbook, Access technology guide und Techniques for troubleshooting access issues.

Mit Rich-Vorschlägen können Sie für jedes dieser vorgeschlagenen Dokumente die folgenden Informationen zum Dokument anzeigen:

  • den Dokumenttitel (title) und einen Link zum Dokument (uri)

  • wann sie zuletzt aktualisiert wurde (update_time)

  • die Quelle (source_type), z. B. ob das Dokument in Confluence Cloud oder Slack gefunden wurde.

Wenn die Mitarbeiter wissen, wann ein Dokument zuletzt aktualisiert wurde und woher es stammt, können sie entscheiden, welches Dokument sie sich zuerst ansehen sollten.

Beschränkungen

Die Rich-Autocomplete-Funktion gilt nur für Drittanbieter-Connectors und nur für bestimmte Entitätsdatenspeicher für diese Drittanbieter-Connectors. In der folgenden Tabelle sehen Sie, welche Entitäten für welche Connectors unterstützt werden.

Drittanbieter-Connector Unterstützte Entitäten
Hinweise für Box Datei
Confluence Cloud Seite Gruppenbereich
Dropbox Datei
Jira Cloud Problem Gruppenbereich
OneDrive Datei
Salesforce Konto Lead Chance
ServiceNow Vorfall Wissen
SharePoint Online Anhang Ereignis Datei Seite
Slack Nachricht

Prozedur

So senden Sie eine Anfrage für automatische Vervollständigung, die einen Rich-Vorschlag zurückgibt:

REST

  1. App-ID suchen. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

      Gehen Sie zu Apps

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Rufen Sie die Methode completionConfig.completeQuery auf.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["CONTENT"]
    }'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.

    • APP_ID: die ID der App.

    • QUERY_STRING: Die typeahead-Eingabe, mit der Vorschläge abgerufen werden

Anfrage für automatische Vervollständigung senden und aktuelle Abfragen zurückgeben

Gibt als Vorschläge eine Liste der letzten Suchanfragen des Nutzers zurück, die mit dem Präfix der Suchanfrage in der Anfrage übereinstimmen.

Die übereinstimmenden Suchvorschläge werden vom neuesten zum ältesten aufgelistet. Wenn Sie die letzte Suche verwenden möchten, muss die Pseudo-ID des Nutzers angegeben werden.

Hinweis

Bevor Sie aktuelle Suchanfragen mit der automatischen Vervollständigung abrufen können, müssen Sie die Suchanfragen von Nutzern als Suchnutzerereignisse aufzeichnen. Rufen Sie dazu die Methode userEvents.write auf.

Wenn keine Suchnutzerereignisse geschrieben werden, geben Anfragen an completionConfig.completeQuery mit suggestionTypes: ["RECENT_SEARCH"] eine leere Liste von Vorschlägen ({}) zurück.

Wenn Sie ein Suchnutzerereignis aufzeichnen möchten, senden Sie eine POST-Anfrage an die Methode userEvents.write mit den folgenden Werten:

  • Legen Sie für eventType "search" fest.
  • userPseudoId: auf die eindeutige pseudonymisierte Kennung des Nutzers festgelegt
  • engine: Legen Sie den Ressourcennamen Ihrer Engine fest.
  • searchInfo.searchQuery: wird auf den vom Nutzer eingegebenen Suchanfragestring festgelegt.
curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/userEvents:write" \
  -d '{
        "eventType": "search",
        "userPseudoId": "USER_PSEUDO_ID",
        "engine": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
        "searchInfo": {
          "searchQuery": "SEARCH_QUERY"
        }
      }'

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID.
  • LOCATION: der Standort Ihrer Anwendung oder Ihres Datenspeichers (z. B. global oder us).
  • APP_ID: die ID der App.
  • USER_PSEUDO_ID: eine pseudonymisierte Kennung des Nutzers. Diese muss mit der userPseudoId übereinstimmen, die in nachfolgenden completionConfig.completeQuery-Anfragen übergeben wird.
  • SEARCH_QUERY: Der vom Nutzer gesuchte Abfragestring.

Weitere Informationen finden Sie unter Echtzeit-Nutzerereignisse mit der Methode userEvents.write aufzeichnen.

Beispiel

Ein Mitarbeiter fragt die Intranet-Website seines Unternehmens ab, um Informationen zum Thema Urlaub zu erhalten. Der Mitarbeiter hat die folgenden Abfragen ausgeführt, aufgelistet von der neuesten bis zur ältesten:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences und Can I take unpaid time off?.

Wenn der Mitarbeiter jetzt vac in das Suchfeld eingibt, werden die folgenden automatisch vervollständigten Vorschläge angezeigt:

  • Vacation blackout periods
  • How much vacation time do I have?
  • Vacation policy
  • Covering a vacant position during absences

Prozedur

So senden Sie eine Anfrage zur automatischen Vervollständigung, die die letzten Suchanfragen des Nutzers zurückgibt:

REST

  1. App-ID suchen. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.

    1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

      Gehen Sie zu Apps

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-ID der Spalte ID.

  2. Rufen Sie die Methode completionConfig.completeQuery auf.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID.

    • APP_ID: die ID der App.

    • QUERY_STRING: Die typeahead-Eingabe, mit der Vorschläge abgerufen werden

    • USER_PSEUDO_ID: eine pseudonymisierte Kennung des Nutzers. Sie können für dieses Feld ein HTTP-Cookie verwenden, mit dem ein Besucher auf einem einzelnen Gerät eindeutig identifiziert wird. Legen Sie dieses Feld nicht für mehrere Nutzer auf dieselbe Kennung fest. Dadurch würden die Abfrageverläufe zusammengeführt. Geben Sie in dieses Feld keine personenidentifizierbaren Informationen ein.

Sperrliste für automatische Vervollständigung verwenden

Mithilfe einer Sperrliste können Sie verhindern, dass bestimmte Begriffe als automatisch vervollständigte Vorschläge angezeigt werden

Die erweiterte automatische Vervollständigung erfolgt auf Anwendungsebene, Sperrlisten werden jedoch auf Datenspeicherebene verwaltet. Das ist wichtig, wenn Ihre Anwendung eine zusammengeführte Suchanwendung ist. Erstellen Sie für jeden mit der Anwendung verbundenen Datenspeicher eine Sperrliste.

Informationen zum Erstellen und Verwenden von Sperrlisten finden Sie unter Sperrliste für automatische Vervollständigung verwenden.

Importierte Liste mit automatisch vervollständigten Vorschlägen verwenden

Sie können eine eigene Liste mit automatisch vervollständigten Vorschlägen bereitstellen, anstatt Vorschläge zu verwenden, die aus einem Datenmodell für die automatische Vervollständigung generiert werden.

Informationen zum Importieren einer Liste finden Sie unter Importierte Liste mit automatisch vervollständigten Vorschlägen verwenden.