Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Erweiterte automatische Vervollständigung konfigurieren

Auf dieser Seite wird die erweiterte Funktion zur automatischen Vervollständigung von Agent Search beschrieben.

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

Machen Sie sich vor dem Lesen dieser Seite mit der grundlegenden Autovervollständigung von Agent Search vertraut. 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 Apps für die zusammengeführte Suche verwendet werden. Das sind benutzerdefinierte Such-Apps, 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, Zugriffssteuerungslisten) bezeichnet. Die erweiterte Vervollständigung schlägt nur Suchanfragen vor, die sich auf Dokumente beziehen, auf die der Suchende Zugriff hat. Informationen zur Zugriffssteuerung finden Sie unter Zugriffssteuerung für Datenquellen verwenden.

Sprachoptimierung:Die erweiterte automatische Vervollständigung kann so eingestellt werden, dass Vorschläge in einer oder mehreren Sprachen optimiert werden. Wenn die Browsersprache beispielsweise Niederländisch ist, könnten Vorschläge für die automatische Vervollständigung in dieser Sprache bevorzugt werden. Weitere Informationen finden Sie unter Anfrage zur automatischen Vervollständigung mit Sprach-Boost senden.

Letzte Anfragen:Mit der erweiterten automatischen Vervollständigung können Nutzer anstelle von regulären Vorschlägen für die automatische Vervollständigung ihre letzten Anfragen abrufen, die mit den eingegebenen Buchstaben beginnen. Weitere Informationen finden Sie unter Autocomplete-Anfrage senden und letzte Anfragen zurückgeben.

Hinweis

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

Überprüfen Sie die Einstellungen für die automatische Vervollständigung für Ihre App und bearbeiten Sie sie gegebenenfalls. Weitere Informationen finden Sie unter Einstellungen für die automatische Vervollständigung aktualisieren.
Bei kleineren Datenspeichern sollten Sie Automatische Vervollständigung aktivieren auf Jetzt festlegen. Wir empfehlen dies, da kleine Datenspeicher möglicherweise nicht genügend Daten enthalten, um genaue Vorschläge zu liefern.
Wenn Ihre Datenspeicher personenidentifizierbare Informationen (PII) enthalten oder Sie das Modell für Anfragevorschläge für Suchverlauf oder Nutzerereignisse verwenden, lesen Sie den Abschnitt Schutz vor Lecks personenidentifizierbarer Informationen und richten Sie die erforderlichen Maßnahmen zum Schutz vor Datenverlust (Data Loss Prevention, DLP) ein, um Lecks von personenidentifizierbaren Informationen zu verhindern.
Wenn Sie Vorschläge für letzte Suchanfragen (RECENT_SEARCH) verwenden möchten, müssen Sie Suchnutzerereignisse erfassen. Bei der Suche mit der Methode SearchService.Search wird der Index für die letzten Suchanfragen nicht automatisch mit Daten gefüllt. Wenn Sie die letzten Anfragen zurückgeben möchten, müssen Sie Nutzerereignisse für die Suche mit der Methode userEvents.write aufzeichnen. Weitere Informationen finden Sie unter Vorbereitung für aktuelle Anfragen.

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:

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 KI-Anwendungen 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.

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 ID Ihres Projekts in Google Cloud .
APP_ID: Die ID der Agent Search App.
QUERY_STRING: Die Typeahead-Eingabe, mit der Vorschläge abgerufen werden.

Anfrage für automatische Vervollständigung mit Sprach-Boost senden

Sie können automatische Vervollständigungsvorschläge nach Sprachcode priorisieren oder unterdrücken, um beispielsweise die Wahrscheinlichkeit zu erhöhen oder zu verringern, dass automatische Vervollständigungsvorschläge in bestimmten Sprachen angezeigt werden.

Der Optimierungswert muss zwischen -1 und 1 liegen. Wenn Sie eine negative Zahl festlegen, werden Vorschläge für die automatische Vervollständigung in dieser Sprache „vergraben“. Eine positive Zahl hingegen erhöht die Sichtbarkeit der Sprache.

Verwenden Sie zweibuchstabige Sprachtags, die von BCP 47 definiert werden, z. B. en, fr, hi und zh.

REST

So senden Sie eine Anfrage zur automatischen Vervollständigung, die einen Sprach-Boost-Wert enthält:

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 KI-Anwendungen 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.

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 ID Ihres Projekts in Google Cloud .
APP_ID: Die ID der Agent Search 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 automatisch vervollständigte 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 höher eingestuft (sie werden weiter oben in der Liste angezeigt).

Beispielbefehl

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery" \
-d '{
     "query": "hol",
     "boostSpec": {
        "conditionBoostSpecs": [{
          "condition": "(langCode: ANY(\"es\", \"fr\"))",
          "boost": 0.75 }, {
          "condition": "(langCode: ANY(\"en\"))",
          "boost": -1
        }]
      }
    }'

In diesem Beispiel werden die Vorschläge zur automatischen Vervollständigung für die Anfrage Co höher in der Liste der Vorschläge platziert, wenn sie auf Französisch oder Spanisch sind, und niedriger, wenn sie auf Englisch sind.

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

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

Die übereinstimmenden Suchvorschläge werden von der neuesten zur ältesten aufgelistet. Wenn Sie die Funktion „Letzte Suche“ verwenden möchten, muss die Pseudo-ID des Nutzers angegeben werden.

Hinweis

Bevor Sie aktuelle Anfragen mit Autocomplete abrufen können, müssen Sie Nutzersuchen als Suchnutzerereignisse aufzeichnen, indem Sie die Methode userEvents.write aufrufen.

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

Wenn Sie ein Nutzerereignis für die Suche 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: auf den Ressourcennamen Ihrer Engine festgelegt
searchInfo.searchQuery: 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 ID Ihres Projekts in Google Cloud .
LOCATION: Der Standort Ihrer App oder Ihres Datenspeichers (z. B. global oder us).
APP_ID: Die ID der Agent Search App.
USER_PSEUDO_ID: eine pseudonymisierte Kennung des Nutzers. Dieser Wert muss mit dem userPseudoId übereinstimmen, der 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 ruft die Intranetseite seines Unternehmens auf, um Informationen zum Thema Urlaub zu erhalten. Der Mitarbeiter hat die folgenden Anfragen gestellt, die von der neuesten bis zur ältesten aufgeführt sind:

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, sehen die Vorschläge zur automatischen Vervollständigung so aus:

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 Anfragen des Nutzers zurückgibt:

REST

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 KI-Anwendungen 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.

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 ID Ihres Projekts in Google Cloud .
APP_ID: Die ID der Agent Search 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. Dieses Feld darf nicht für mehrere Nutzer auf dieselbe Kennung festgelegt werden. Dadurch würden die Abfrageverläufe zusammengeführt. Geben Sie in diesem Feld keine personenidentifizierbaren Informationen an.

Beispielbefehl und -ergebnis

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

{
  "recentSearchSuggestions": [
    {
      "suggestion": "holiday readiness",
      "recentSearchTime": "2025-05-19T18:27:07.261698Z"
    },
    {
      "suggestion": "holiday freeze",
      "recentSearchTime": "2025-05-19T18:25:45.744021Z"
    },
    {
      "suggestion": "holiday",
      "recentSearchTime": "2025-05-19T18:20:08.916884Z"
    }
  ]
}

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 ist zwar auf App-Ebene verfügbar, die Sperrlisten jedoch auf Datenspeicherebene. Das ist wichtig, wenn Ihre App eine App für die zusammengeführte Suche ist. Erstellen Sie für jeden Datenspeicher, der mit der App verbunden ist, 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.

Erweiterte automatische Vervollständigung konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Wichtige Funktionen der erweiterten automatischen Vervollständigung

Hinweis

Anfragen für automatische Vervollständigung senden

REST

Anfrage für automatische Vervollständigung mit Sprach-Boost senden

REST

Beispielbefehl

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

Hinweis

Beispiel

Prozedur

REST

Beispielbefehl und -ergebnis

Sperrliste für automatische Vervollständigung verwenden

Importierte Liste mit automatisch vervollständigten Vorschlägen verwenden

Erweiterte automatische Vervollständigung konfigurieren