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:
Umfassende Vorschläge:Die automatisch vervollständigten Vorschläge enthalten Informationen zu Dokumenten, bei denen das Titelpräfix mit den eingegebenen Buchstaben übereinstimmt. Weitere Informationen finden Sie unter Anfrage zur automatischen Vervollständigung senden und Rich-Text zurückgeben. Vorschläge
Letzte Suchanfragen:Als automatisch vervollständigte Vorschläge sehen Nutzer ihre letzten Abfragen, bei denen ein Präfix den eingegebenen Buchstaben entspricht. Weitere Informationen finden Sie unter Abschlussvorschlagsanfrage senden und letzte Suchanfragen zurückgeben.
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:
Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und rufen Sie die ID der App ab: der Spalte ID hinzu.
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:
Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und rufen Sie die ID der App ab: der Spalte ID hinzu.
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
Suchen Sie Ihre App-ID. Wenn Sie bereits eine App-ID haben, fahren Sie mit dem nächsten Schritt fort.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.
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
Suchen Sie Ihre App-ID. Wenn Sie Ihre App-ID bereits haben, fahren Sie mit dem nächsten Schritt fort.
Rufen Sie in der Google Cloud Console die Seite Agent Builder auf.
Suchen Sie auf der Seite Apps nach dem Namen Ihrer App und sehen Sie sich die ID der App in der Spalte ID an.
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.