Erweiterte automatische Vervollständigung konfigurieren

Auf dieser Seite wird die erweiterte Funktion zur automatischen Vervollständigung von KI-Anwendungen beschrieben.

Ähnlich wie bei der einfachen automatischen Vervollständigung werden auch bei der erweiterten automatischen Vervollständigung Abfragevorschläge basierend auf den ersten eingegebenen Zeichen generiert.

Bevor Sie diese Seite lesen, sollten Sie sich mit der grundlegenden automatischen Vervollständigung von KI-Anwendungen 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:

  • Kombinierte Suche:Die erweiterte automatische Vervollständigung kann mit Suchanwendungen für die kombinierte Suche verwendet werden. Das sind benutzerdefinierte Suchanwendungen, die mit mehreren Datenspeichern verbunden sind.

  • Zugriffssteuerung:Die erweiterte automatische Vervollständigung berücksichtigt die Zugriffssteuerung. (Zugriffssteuerungen werden auch als ACLs bezeichnet, Access Control Lists.) 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 Zugriffssteuerung für Datenquellen verwenden.

  • Sprachoptimierung:Die erweiterte automatische Vervollständigung kann so konfiguriert werden, dass Vorschläge in einer oder mehreren Sprachen optimiert werden. Wenn die Browsersprache beispielsweise Niederländisch ist, können Vorschläge für die automatische Vervollständigung in dieser Sprache optimiert werden. Weitere Informationen finden Sie unter Abschlussvorschlagsanfrage mit Sprachoptimierung senden.

Hinweise

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

  • Prüfen und bearbeiten Sie gegebenenfalls 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.

  • Bei kleineren Datenspeichern legen Sie für Automatische Vervollständigung aktivieren die Option Jetzt fest. Wir empfehlen dies, da kleine Datenspeicher möglicherweise nicht genügend Daten enthalten, um genaue Vorschläge zu machen.

  • Wenn Ihre Datenspeicher personenidentifizierbare Informationen (PII) enthalten oder Sie das Modell für Suchverlaufs- oder Nutzerereignisabfragevorschläge verwenden, lesen Sie den Hilfeartikel Schutz vor Datenlecks und richten Sie Data Loss Prevention-Sicherheitsmaßnahmen ein, die möglicherweise erforderlich sind, um Datenlecks zu verhindern.

Autocomplete-Anfragen senden

Im Folgenden wird gezeigt, wie Sie erweiterte Vorschläge mit der Methode completionConfig.completeQuery senden.

REST

So senden Sie eine autocomplete-Anfrage über die API:

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

    1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Zu Apps wechseln

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

  1. 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/v1beta/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 Google Cloud Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • QUERY_STRING: Die Eingabevorschau, mit der Vorschläge abgerufen werden.

Anfrage zur automatischen Vervollständigung mit Sprachoptimierung senden

Sie können Vorschläge zur automatischen Vervollständigung nach Sprachcode hervorheben oder unterdrücken, z. B. die Wahrscheinlichkeit erhöhen oder verringern, dass Vorschläge zur automatischen Vervollständigung in bestimmten Sprachen angezeigt werden.

Der Wert für die Steigerung muss zwischen -1 und 1 liegen. Wenn Sie eine negative Zahl festlegen, werden Vorschläge für die automatische Vervollständigung in dieser Sprache unterdrückt. Eine positive Zahl erhöht die Gewichtung der Sprache.

Verwenden Sie zweistellige Sprachtags gemäß BCP 47, z. B. en, fr, hi und zh.

REST

So senden Sie eine autocomplete-Anfrage mit einem Sprach-Boost-Wert:

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

    1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Zu Apps wechseln

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

  1. 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/v1beta/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 Google Cloud Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • QUERY_STRING: Die Eingabevorschau, mit der Vorschläge abgerufen werden.

    • LANG_CODE: Der zweistellige Code für eine oder mehrere Sprachen in doppelten Anführungszeichen. Beispiel: \"fr\", \"es\", um den Wert für Spanisch und Französisch anzuwenden.

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

Anfrage für die automatische Vervollständigung senden und letzte Suchanfragen zurückgeben

Gib 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 vom neuesten zum ältesten aufgeführt. Wenn Sie die letzten Suchanfragen verwenden möchten, muss die Pseudo-ID des Nutzers angegeben werden.

Beispiel

Ein Mitarbeiter sucht auf der Intranet-Website seines Unternehmens nach Informationen zu Urlaubstagen. Der Mitarbeiter hat die folgenden Abfragen ausgeführt, sortiert nach Datum (neueste zuerst):

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 folgende Vorschläge zur automatischen 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 automatische Vervollständigungsanfrage, die die letzten Suchanfragen des Nutzers zurückgibt:

REST

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

    1. Rufen Sie in der Google Cloud Console die Seite KI-Anwendungen auf.

      Zu Apps wechseln

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

  1. 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/v1beta/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 Google Cloud Projekts.

    • APP_ID: die ID der Vertex AI Search-Anwendung.

    • QUERY_STRING: Die Eingabevorschau, 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, das einen Besucher auf einem einzelnen Gerät eindeutig identifiziert. Legen Sie für dieses Feld nicht dieselbe Kennung für mehrere Nutzer fest. Dadurch werden die Suchverläufe der Nutzer kombiniert. Geben Sie in dieses Feld keine personenidentifizierbaren Informationen an.

Sperrliste für die 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 zwar auf App-Ebene, aber Sperrlisten auf Datenspeicherebene. Dies ist wichtig, wenn es sich bei Ihrer App um eine App mit kombinierter Suche handelt. Erstellen Sie eine Sperrliste für jeden Datenspeicher, der mit der App verknüpft 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 angeben, anstatt Vorschläge zu verwenden, die aus einem Datenmodell für die automatische Vervollständigung generiert wurden.

Informationen zum Importieren einer Liste finden Sie unter Importierte Liste mit Vorschlägen zur automatischen Vervollständigung verwenden.