Erweiterte automatische Vervollständigung konfigurieren

Auf dieser Seite wird die erweiterte Funktion zur automatischen Vervollständigung von AI Applications beschrieben.

Wie bei der einfachen automatischen Vervollständigung werden 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 Vervollständigungsfunktion von AI Applications vertraut machen. 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 folgende:

  • Zusammengeführte Suche:Die erweiterte automatische Vervollständigung kann mit Apps für die zusammengeführte Suche verwendet werden. Das sind benutzerdefinierte Suchanwendungen, die mit mehr als einem Datenspeicher verbunden sind.

  • Zugriffssteuerung:Bei der erweiterten automatischen Vervollständigung wird die Zugriffssteuerung berücksichtigt. (Zugriffssteuerungen werden 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. 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 Autocomplete-Anfrage mit Sprach-Boost senden.
  • Letzte Suchanfragen:Mit der erweiterten automatischen Vervollständigung erhalten Nutzer anstelle von regulären Vorschlägen für die automatische Vervollständigung ihre letzten Suchanfragen, die mit den eingegebenen Buchstaben beginnen. 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:

  • Prü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 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 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 die erforderlichen DLP-Schutzmaßnahmen (Data Loss Prevention, Schutz vor Datenverlust) ein, um PII-Lecks zu verhindern.

Autocomplete-Anfragen senden

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

REST

So senden Sie eine Vervollständigungsanfrage über die API:

  1. Suchen Sie Ihre App-ID. 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.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-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 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 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 fördert die Sprache.

Verwenden Sie zweibuchstabige Sprachtags, 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:

  1. Suchen Sie Ihre App-ID. 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.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-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 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 Boost-Wert 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 erscheinen weiter unten in der Liste der Vorschläge). Bei einem positiven Wert werden Vorschläge höher in der Liste angezeigt.

Senden einer Vervollständigungsanfrage und Zurückgeben der letzten Anfragen

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

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

Beispiel

Ein Mitarbeiter fragt auf der Intranetseite seines Unternehmens nach Informationen zum Thema Urlaub. Der Mitarbeiter hat die folgenden Abfragen durchgeführt, 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

  1. Suchen Sie Ihre App-ID. 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.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und entnehmen Sie die App-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 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, das einen Besucher auf einem einzelnen Gerät eindeutig identifiziert. Legen Sie für dieses Feld nicht dieselbe ID für mehrere Nutzer 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 ist zwar auf App-Ebene verfügbar, die Sperrlisten jedoch auf Datenspeicherebene. Das ist wichtig, wenn Ihre App eine Blended-Search-App ist. Erstellen Sie für jeden Datenspeicher, der mit der App verbunden ist, eine Denylist.

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.