Erweiterte automatische Vervollständigung konfigurieren

Auf dieser Seite wird die erweiterte Funktion für die automatische Vervollständigung der Vertex AI Search beschrieben.

Genauso wie die einfache automatische Vervollständigung generiert die erweiterte automatische Vervollständigung Vorschläge basierend auf den ersten Zeichen der Suchanfrage.

Bevor Sie diese Seite lesen, sollten Sie sich mit der grundlegenden automatischen Vervollständigung von Vertex AI Search vertraut machen. Weitere Informationen finden Sie unter Automatische Vervollständigung konfigurieren.

Wichtige Funktionen der erweiterten automatischen Vervollständigung

Die wichtigsten Merkmale der erweiterten automatischen Vervollständigung, die sie von der einfachen wie folgt aussehen:

  • Gemischte Suche:Die erweiterte automatische Vervollständigung kann für die zusammengeführte Suche verwendet werden. sind allgemeine Such-Apps, die mit mehr als einem Datenspeicher verbunden sind.

  • Zugriffssteuerung: Die erweiterte automatische Vervollständigung berücksichtigt die Zugriffssteuerung. (Zugriff werden auch als ACLs (Access Control Lists, ACLs) bezeichnet. Bei der erweiterten automatischen Vervollständigung werden nur Suchanfragen vorgeschlagen, die sich auf Dokumente beziehen, auf die der Suchende Zugriff hat. Informationen zur Zugriffssteuerung finden Sie unter Daten verwenden Zugriff auf Quellcode

  • 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 verstärkt werden. Weitere Informationen finden Sie unter Anfrage zur automatischen Vervollständigung mit einer Sprachausgabe senden

  • Verschiedene Arten von Vorschlägen:Mit der erweiterten automatischen Vervollständigung regulärer automatisch vervollständigter Suchanfragenvorschläge, können Sie angeben, verschiedene Arten von Vorschlägen:

Autocomplete-Anfragen senden

Im Folgenden wird gezeigt, wie Sie erweiterte Anfragen für die automatische Vervollständigung mithilfe der Funktion completionConfig.completeQuery-Methode.

REST

So senden Sie eine Anfrage für die automatische Vervollständigung ü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 Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und rufen Sie die ID der App ab: der Spalte ID hinzu.

  2. 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"
        }'
    
    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

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

    • QUERY_STRING: Die Eingabe für die automatische Vervollständigung, die zum Abrufen von Vorschlägen verwendet wird.

Anfrage zur automatischen Vervollständigung mit Sprachoptimierung senden

Sie können die automatische Vervollständigung von Vorschlägen nach Sprachcode hervorheben oder unterdrücken, z. B. die automatische Vervollständigung von Vorschlägen in bestimmten Sprachen mit höherer oder geringerer Wahrscheinlichkeit anzeigen lassen.

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 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 Wert für die Sprachoptimierung:

  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 Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und rufen Sie die ID der App ab: der Spalte ID hinzu.

  2. 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
             }]
          }
        }'
    
    
    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

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

    • QUERY_STRING: Die Eingabe, die zum Abrufen von Vorschlägen verwendet wird.

    • LANG_CODE: der aus zwei Buchstaben bestehende Code für eine oder mehrere Sprachen in Anführungszeichen gesetzt werden. Beispiel: \"fr\", \"es\" zum Anwenden auf Spanisch und Französisch.

    • 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 sind, werden Vorschläge hochgestuft (sie werden in der Liste weiter oben angezeigt).

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

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

Neben dem Titel des Dokuments gibt die autocomplete-Anfrage source_type und entity_type sowie, falls verfügbar, die Schlüsseleigenschaften uri, create_time und update_time zurück. Sie können das Schlüsselattribut aufrufen und bearbeiten Zuordnungen auf dem Tab Schema auf der Datastore-Seite.

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

Beispiel

Ein Mitarbeiter sucht auf der Intranet-Website seines Unternehmens nach technischen Informationen zu Zugriffsberechtigungen.

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

Bei umfassenden Vorschlägen können Sie für jedes dieser vorgeschlagenen Dokumente alle folgenden Informationen anzeigen: den Dokumenttitel (title), einen Link zum Dokument (uri), das Datum der letzten Aktualisierung (update_time) und 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 leichter entscheiden, welches Dokument er sich zuerst ansehen soll.

Beschränkungen

Die erweiterte automatische Vervollständigung gilt nur für Drittanbieter-Connectors und nur für bestimmte 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
Hinweise für 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 Meldung

Prozedur

So senden Sie eine Anfrage zur automatischen Vervollständigung, die einen umfassenden Vorschlag zurückgibt: führen Sie folgende Schritte aus:

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 Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. 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": ["CONTENT"]
        }'
    
    
    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

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

    • QUERY_STRING: Die Eingabe für die automatische Vervollständigung, die zum Abrufen von Vorschlägen verwendet wird.

Anfrage zur automatischen Vervollständigung senden und aktuelle Abfragen zurückgeben

Als Vorschläge werden die letzten Suchanfragen des Nutzers zurückgegeben, die mit der Suchanfrage in der Anfrage übereinstimmen.

Die übereinstimmenden Suchvorschläge werden vom neuesten zum ältesten aufgeführt. Wenn Sie die letzte Suche verwenden möchten, muss die Pseudo-ID des Nutzers angegeben werden.

Beispiel

Ein Mitarbeiter führt eine Anfrage im Intranet des Unternehmens durch, um Informationen über Urlaub machen. Der Mitarbeiter hat die folgenden Abfragen durchgeführt: vom neuesten zum ältesten:

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?.

Als Antwort auf die Eingabe von vac in das Suchfeld erhält der Mitarbeiter jetzt wären Vorschläge für die automatische Vervollständigung:

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

Prozedur

So senden Sie eine autocomplete-Anfrage, die die letzten Suchanfragen 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 Agent Builder auf.

      Zu Apps wechseln

    2. Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.

  2. 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"
        }'
    
    
    • PROJECT_ID ist die ID Ihres Google Cloud-Projekts.

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

    • QUERY_STRING: Die Eingabe, die zum Abrufen von Vorschlägen verwendet wird.

    • USER_PSEUDO_ID: eine pseudonymisierte Kennung des Nutzers. Ich für dieses Feld ein HTTP-Cookie verwenden, das ein über ein einziges Gerät aufgerufen werden. Legen Sie für dieses Feld nicht dieselbe Kennung fest für mehrere Nutzer. Dadurch werden die Suchverläufe der Nutzer kombiniert. Das sollten Sie nicht tun: personenidentifizierbare Informationen (PII) enthalten.

Sperrliste für automatische Vervollständigung verwenden

Mit einer Sperrliste können Sie verhindern, dass bestimmte Begriffe automatisch vervollständigt werden Vorschläge machen.

Obwohl die erweiterte automatische Vervollständigung auf App-Ebene erfolgt, befinden sich Sperrlisten auf der Daten-Store-Ebene. Dies ist wichtig, wenn Ihre App eine gemischte Such-App ist. Erstellen Sie eine Sperrliste für jeden Datenspeicher, der mit der Anwendung verbunden ist.

Weitere Informationen zum Erstellen und Verwenden von Sperrlisten finden Sie unter Automatische Vervollständigung verwenden Sperrliste.