Diese Seite wurde von der Cloud Translation API übersetzt.

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 bei der erweiterten automatischen Vervollständigung Vorschläge für Abfragen auf Grundlage der ersten eingegebenen Zeichen generiert.

Bevor Sie diese Seite lesen, sollten Sie sich mit der grundlegenden Vervollständigungsfunktion von Gemini Enterprise vertraut machen. Weitere Informationen

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 folgende:

Zusammengeführte Suche:Die erweiterte automatische Vervollständigung kann mit Apps 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. Die erweiterte automatische Vervollständigung schlägt nur Suchanfragen vor, 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 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 Autocomplete-Anfrage mit Sprach-Boost senden.

Verschiedene Arten von Vorschlägen:Mit der erweiterten automatischen Vervollständigung können Sie anstelle von regulären Vorschlägen für die automatische Vervollständigung von Suchanfragen verschiedene Arten von Vorschlägen angeben:
- Umfangreiche Vorschläge:Nutzer erhalten als Vorschläge zur automatischen Vervollständigung Informationen zu Dokumenten, deren Titel mit den eingegebenen Buchstaben beginnen. Weitere Informationen finden Sie unter Autocomplete-Anfrage senden und umfangreiche Vorschläge zurückgeben.
- Letzte Suchanfragen:Nutzer erhalten ihre letzten Suchanfragen, die mit den eingegebenen Buchstaben beginnen, als Vorschläge für die automatische Vervollständigung. Weitere Informationen finden Sie unter Autocomplete-Anfrage senden und letzte Anfragen zurückgeben.

Hinweise

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 hier.
Bei kleineren Datenspeichern können 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 Vorschläge für Suchverlauf oder Nutzerereignisse verwenden, lesen Sie den Abschnitt Vor PII-Lecks schützen und richten Sie DLP-Schutzmaßnahmen (Data Loss Prevention) ein, die möglicherweise erforderlich sind, um PII-Lecks zu verhindern.

Autocomplete-Anfragen senden

Im Folgenden wird gezeigt, wie Sie erweiterte Autocomplete-Anfragen mit der Methode completionConfig.completeQuery senden.

REST

So senden Sie eine Vervollständigungsanfrage ü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 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.

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, die zum Abrufen von Vorschlägen verwendet wird.

Anfrage zur automatischen Vervollständigung mit Sprachoptimierung senden

Sie können automatische Vervollständigungsvorschläge nach Sprachcode verstärken 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 fördert die Sprache.

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

REST

So senden Sie eine Vervollständigungsanfrage mit einem Sprach-Boost-Wert:

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.

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 Steigerungswert 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 angezeigt, wenn sie auf Französisch oder Spanisch sind, und niedriger, wenn sie auf Englisch sind.

Anfrage für die automatische Vervollständigung senden und umfangreiche Vorschläge zurückgeben

Bei der erweiterten Vervollständigung werden Inhalte (Dokumente) zurückgegeben, deren Titel Wörter enthalten, die mit der Anfrage beginnen.

Zusätzlich zum Titel des Dokuments werden in der Autocomplete-Anfrage die source_type und entity_type zurückgegeben sowie, falls verfügbar, die wichtigsten Eigenschaften: uri, create_time und update_time. Auf dem Tab Schema der Datenspeicherseite können Sie wichtige Attributzuordnungen ansehen und bearbeiten.

Wie bei allen erweiterten Vorschlägen zur automatischen Vervollständigung werden ACLs für alle vorgeschlagenen Dokumente berücksichtigt.

Beispiel

Ein Mitarbeiter sucht auf der Intranetseite seines Unternehmens nach technischen Informationen zu Zugriffsberechtigungen.

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

Bei umfangreichen Vorschlägen können Sie für jedes dieser vorgeschlagenen Dokumente die folgenden Informationen anzeigen lassen:

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 der Mitarbeiter weiß, wann ein Dokument zuletzt aktualisiert wurde und woher es stammt, kann er besser entscheiden, welches Dokument er sich zuerst ansehen sollte.

Beschränkungen

Die erweiterte automatische Vervollständigung ist nur für Drittanbieter-Connectors und nur für bestimmte Entitätsdatenspeicher für diese Drittanbieter-Connectors verfügbar. 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	Empfehlung
ServiceNow	Vorfall	Wissen
SharePoint Online	Anhang	Ereignis	Datei	Seite
Slack	Nachricht

Prozedur

So senden Sie eine Anfrage zur automatischen Vervollständigung, die einen umfassenden Vorschlag 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 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.

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.

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/1234/locations/global/collections/default_collection/engines/my_app/completionConfig:completeQuery" \
- d {
      "query": "C",
      "suggestionTypes": ["CONTENT"]
    }'

{
  "contentSuggestions": [{
    "suggestion": "critical crash in payment module",
    "document": {
      "name": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store/branches/0/documents/10000",
      "derivedStructData": {
        "title": "Critical Crash in Payment Module",
        "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
        "source_type": "jira",
        "entity_type": "issue"
      }
    },
    "dataStore": "projects/1234/locations/global/collections/default_collection/dataStores/my_data_store"
  }]
}

Senden Sie eine Autocomplete-Anfrage und geben Sie die letzten Anfragen zurück.

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

Die passenden Suchvorschläge werden von der neuesten zur ältesten aufgelistet. Um die Funktion „Letzte Suche“ zu verwenden, muss die Pseudo-ID des Nutzers angegeben werden.

Beispiel

Ein Mitarbeiter fragt die Intranetseite seines Unternehmens ab, 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 nun vac in das Suchfeld eingibt, werden die folgenden Vorschläge für die automatische Vervollständigung angezeigt:

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

Prozedur

So senden Sie eine Vervollständigungsanfrage, die die letzten Abfragen 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 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.

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 ihre Abfrageverläufe kombiniert. 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 eine Sperrliste für jeden Datenspeicher, der mit der App verbunden ist.

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

Importierte Liste mit Vorschlägen für die automatische Vervollständigung verwenden

Sie können eine eigene Liste mit Vorschlägen für die automatische Vervollständigung 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 Vorschlägen zur automatischen Vervollständigung 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

Hinweise

Autocomplete-Anfragen senden

REST

Anfrage zur automatischen Vervollständigung mit Sprachoptimierung senden

REST

Beispielbefehl

Anfrage für die automatische Vervollständigung senden und umfangreiche Vorschläge zurückgeben

Beispiel

Beschränkungen

Prozedur

REST

Beispielbefehl und -ergebnis

Senden Sie eine Autocomplete-Anfrage und geben Sie die letzten Anfragen zurück.

Beispiel

Prozedur

REST

Beispielbefehl und -ergebnis

Sperrliste für automatische Vervollständigung verwenden

Importierte Liste mit Vorschlägen für die automatische Vervollständigung verwenden

Erweiterte automatische Vervollständigung konfigurieren