Implementieren Sie die automatische Vervollständigung

Die automatische Vervollständigung von Cloud Search unterstützt einen Benutzer, indem sie Wörter vorschlägt, wenn der Benutzer eine Suchanfrage eingibt. Die Vorschläge können Wörter aus Dokumenttiteln, Suchoperatoren, Suchoperatorwerten, Namen und E-Mails aus der Google Workspace-Domäne usw. sein.

Autocomplete extrahiert die Phrasen aus den Titeln indizierter Dokumente und ermittelt anhand eines n-Gram-Modells Vorschläge, die mithilfe der Suggest-API bereitgestellt werden sollen. Angenommen, wir haben die followingdatasource, die Daten zu Filmen enthält:

• Die Datenquelle enthält 2 Dokumente.
• Jedes Dokument hat einen Titel (ItemMetadata.title) und zwei Eigenschaften:genre und characters.
• Das erste Dokument trägt den Titel „Avengers Infinity War“ mitgenre=science fiction und characters=Iron Man, Hulk
• Das zweite Dokument trägt den Titel „Harry Potter“ mit genre=Adventure, Fantasyandcharacters=Hermine, Harry Potter`

Abbildung 1 zeigt, wie die Vorschläge zur automatischen Vervollständigung extrahiert aus thedocument Titeln, Eigenschaften und den Eigenschaftswerten.

Aus Dokument 1 extrahieren wir ngramme (bis zu Trigrammen) „Avengers“, „Infinity“, „War“,“Avengers Infinity“, „Infinity War“, „Avengers Infinity War.“In ähnlicher Weise generieren wir aus Dokument 2 „Harry“, „Potter“, „Harry Potter“.

Wenn Sie diese Datenquelle abfragen, nehmen wir an, der Benutzer beginnt mit der Eingabe von „h“. Die dem Benutzer angezeigten Vorschläge wären:

• Harry
• Hermine
• Hulk
• Harry Potter

Angenommen, der Benutzer wählt den Autocomplete-Vorschlag „Hermine“ aus und der nächste Tastendruck des Benutzers ist das Zeichen „a“. Die dem Benutzer angezeigten Autocomplete-Vorschläge lauten:

• Hermine Adventure
• Hermine Action
• Hermine Avengers

Die automatische Vervollständigung von Cloud Search gibt maximal 5 Vorschläge aus documentcontent und 2 Personenvorschläge zurück.

Standardmäßig werden Phrasen aus den Dokumenttiteln in Autocomplete angezeigt. Schemaproperties muss explizit als is_suggestable markiert sein, damit die Suggest-API den entsprechenden Eigenschaftsnamen und die entsprechenden Werte automatisch vervollständigt.

Integration mit der Autocomplete-API

Wenn Sie die Standardsuchanwendung oder das einbettbare searchwidget verwenden, wird die Autocomplete-Funktion von Cloud Search ohne zusätzliche Arbeit nativ unterstützt. Denken Sie daran, standardmäßig werden Phrasen aus den Dokumenttiteln angezeigtin der automatischen Vervollständigung. Schemaeigenschaften müssen explizit als is_suggestablemarkiert sein, damit die Suggest-API den entsprechenden Eigenschaftsnamen und die entsprechenden Werte automatisch vervollständigt.

Wenn Sie eine benutzerdefinierte Suchanwendung erstellen, ist die automatische Vervollständigung verfügbar, indem Sie die /query/suggest API-Endpunkte abfragen.

Einschränkungen

Die automatische Vervollständigung hat die folgenden Einschränkungen:

• Die Einschränkung der automatischen Vervollständigung von Cloud Search mithilfe der im Schema definiertenFilterOptionswird mit Ausnahme der folgenden integrierten Filter nicht unterstützt: objectypemimetype und geben Sie Filter ein.

• Abfragehistorie-basierte Vorschläge (Suchen, die der Benutzer zuvor in einer Suchanwendung durchgeführt hat) werden nicht unterstützt

• Maximal 20 Eigenschaften können als is_suggestable markiert werden. Dieses Limit kann seinerhöht durch Kontaktaufnahme mit dem Cloud Search Support.

• Die automatische Vervollständigung des Suchoperators ist für Eigenschaften mitexact_match_with_operator nicht verfügbar.