Erweiterte automatische Vervollständigung konfigurieren

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

Wie bei der grundlegenden automatischen Vervollständigung werden auch bei der erweiterten automatischen Vervollständigung Vorschläge für Abfragen auf Grundlage der ersten Zeichen generiert, die für die Abfrage 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 grundlegenden 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. (Die Zugriffssteuerung wird auch als ACLs oder 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. Weitere Informationen zur Zugriffssteuerung finden Sie unter Identität und Berechtigungen.

  • Sprach-Boost:Die erweiterte automatische Vervollständigung kann so konfiguriert werden, dass Vorschläge in einer oder mehreren Sprachen höher eingestuft werden. Wenn die Browsersprache beispielsweise Deutsch ist, können Vorschläge für die automatische Vervollständigung in dieser Sprache höher eingestuft werden. Weitere Informationen finden Sie unter Anfrage für automatische Vervollständigung mit Sprach-Boost senden.

  • Verschiedene Arten von Vorschlägen:Bei der erweiterten automatischen Vervollständigung können Sie anstelle von regulären Vorschlägen für die automatische Vervollständigung verschiedene Arten von Vorschlägen angeben:

Hinweis

Bevor Sie die erweiterte automatische Vervollständigung verwenden, führen Sie folgende Schritte aus:

  • Prüfen und bearbeiten Sie optional die Einstellungen für die automatische Vervollständigung für Ihre App. Weitere Informationen finden Sie unter Einstellungen für die automatische Vervollständigung aktualisieren.

  • Setzen Sie für kleinere Datenspeicher Automatische Vervollständigung aktivieren auf Jetzt. 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 Suchvorschläge für den Suchverlauf oder Nutzerereignisse verwenden, lesen Sie den Abschnitt Schutz vor Lecks personenidentifizierbarer Informationen und richten Sie die erforderlichen Maßnahmen zur Verhinderung von Datenverlust (Data Loss Prevention, DLP) ein, um Lecks personenidentifizierbarer Informationen zu verhindern.

Anfragen für automatische Vervollständigung senden

Im Folgenden wird gezeigt, wie Sie Anfragen für die erweiterte automatische Vervollständigung mit der completionConfig.completeQuery Methode 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.

      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 completionConfig.completeQuery Methode 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 Sprach-Boost senden

Sie können Vorschläge für die automatische Vervollständigung nach Sprachcode höher oder niedriger einstufen, z. B. die Wahrscheinlichkeit erhöhen oder verringern, dass Vorschläge für die automatische Vervollständigung in bestimmten Sprachen angezeigt werden.

Der Boost-Wert muss zwischen -1 und 1 liegen. Wenn Sie eine negative Zahl festlegen, werden Vorschläge für die automatische Vervollständigung in dieser Sprache niedriger eingestuft. Eine positive Zahl stuft die Sprache höher ein.

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 Sprach-Boost-Wert 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.

      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 completionConfig.completeQuery Methode 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 zweistellige Code für eine oder mehrere Sprachen in Escape-Anführungszeichen. Beispiel: \"fr\", \"es\", um den Boost-Wert auf Spanisch und Französisch anzuwenden.

    • BOOST_VALUE: eine Gleitkommazahl zwischen -1 und 1. Wenn der Wert negativ ist, werden Vorschläge für die automatische Vervollständigung in der Sprache niedriger eingestuft (sie werden weiter unten in der Liste der Vorschläge angezeigt). Wenn der Wert positiv ist, werden Vorschläge höher eingestuft (sie werden weiter oben in der Liste angezeigt).

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

Die umfangreiche automatische Vervollständigung gibt Inhalte (Dokumente) zurück, deren Titel mit Wörtern beginnen, die mit der Abfrage beginnen.

Neben dem Titel des Dokuments gibt die Anfrage für die automatische Vervollständigung auch source_type und entity_type sowie, falls verfügbar, die wichtigsten Attribute zurück: uri, create_time und update_time. Sie können Zuordnungen von Schlüsselattributen auf dem Tab Schema der Datenspeicherseite ansehen und bearbeiten.

Wie bei allen erweiterten Vorschlägen für die automatische 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 gibt tec ein und die folgenden Dokumente werden möglicherweise 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:

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

  • wann es 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ß, wie lange es her ist, dass ein Dokument aktualisiert wurde, und woher es stammt, kann er besser entscheiden, welches Dokument er sich zuerst ansehen soll.

Beschränkungen

Die umfangreiche automatische Vervollständigung 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
Box Datei
Confluence Cloud Seite Leertaste
Dropbox Datei
Jira Cloud Problem Leertaste
OneDrive Datei
Salesforce Konto Lead Empfehlung
ServiceNow Vorfall Wissen
SharePoint Online Anhang Ereignis Datei Seite
Slack Nachricht

Prozedur

So senden Sie eine Anfrage für automatische Vervollständigung, die einen umfangreichen 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.

      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 completionConfig.completeQuery Methode 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 letzte Abfragen zurückgeben

Geben Sie als Vorschläge eine Liste der letzten Abfragen des Nutzers zurück, die mit der Abfrage in der Anfrage beginnen.

Die übereinstimmenden Suchvorschläge werden vom neuesten zum ältesten aufgelistet. Um die letzte Suche zu verwenden, muss die Pseudo-ID des Nutzers angegeben werden.

Beispiel

Ein Mitarbeiter sucht auf der Intranetseite seines Unternehmens nach Informationen zum Urlaub. Der Mitarbeiter hat die folgenden Abfragen ausgeführt, die vom neuesten zum ä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, lauten die Vorschläge für die automatische Vervollständigung so:

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

Prozedur

So senden Sie eine Anfrage für automatische Vervollständigung, die die letzten Abfragen 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.

      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 completionConfig.completeQuery Methode 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 ID 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 für dieses Feld nicht für mehrere Nutzer dieselbe ID fest. Dadurch werden ihre Abfrageverläufe kombiniert. Geben Sie in diesem Feld keine personenidentifizierbaren Informationen an.

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

Obwohl die erweiterte automatische Vervollständigung auf App-Ebene erfolgt, befinden sich Sperrlisten auf Datenspeicherebene. Das ist wichtig, wenn Ihre App eine zusammengeführte Such-App 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.