implementeer autocomplete
Cloud Search ‘ s autocomplete helpt een gebruiker door woorden voor te stellen wanneer de gebruiker een zoekopdracht istypt. De suggesties kunnen worden woorden uit document titels, search operators, search operator waarden, namen en e-mail van het Google Workspace domein, en ga zo maar door.
Autocomplete haalt de zinnen uit de titels van geïndexeerde documenten en gebruikt een n-gram model, bepaalt suggesties om te dienen met behulp van de Suggest API. Bijvoorbeeld, laten we zeggen dat we de volgende DataSource met gegevens over films:
- de gegevensbron bevat 2 documenten.
- elk document heeft een titel (
ItemMetadata.title
) en twee eigenschappen:genre
encharacters
. - het eerste document is getiteld “Avengers Infinity War” met
genre=science fiction
encharacters=Iron Man, Hulk
- het tweede document is getiteld “Harry Potter” met
genre=Adventure, Fantasyand
characters=Hermione, Harry Potter`
autocomplete suggesties worden geëxtraheerd uit het document titels, eigenschappen, en de eigenschap waarden.
uit document 1 halen we ngrams (tot trigrammen) “Avengers”, “Infinity”, “War”,”Avengers Infinity”, “Infinity War”, “Avengers Infinity War”.”Op dezelfde manier genereren we uit document 2 “Harry”, “Potter”, “Harry Potter”.
bij het opvragen van deze gegevensbron, laten we zeggen dat de gebruiker begint met het typen van “h”.:
- Harry
- Hermione
- Hulk
- Harry Potter
stel dat de gebruiker de autocomplete suggestie “Hermione” selecteert en de volgende toets van de gebruiker het teken “a” is. de autocomplete suggesties die aan de gebruiker worden getoond zijn:
- Hermione Adventure
- Hermione Action
- Hermione Avengers
Cloud Search ‘ s AutoComplete geeft maximaal 5 suggesties uit documentinhoud en 2 suggesties voor mensen.
standaard worden zinnen uit de documenttitels getoond in Automatisch aanvullen. Schemaproperties moeten expliciet gemarkeerd worden als is_suggestable
voor de API suggereren om de corresponderende eigenschapsnaam en waarden automatisch aan te vullen.
integreer met de Autocomplete API
als u de standaardzoektoepassing of de integreerbare searchwidget gebruikt, wordt de autocomplete-functie van Cloud Search native ondersteund zonder extra werk. Onthoud dat standaard zinnen uit de documenttitels worden weergegeven in Automatisch aanvullen. Schema-eigenschappen moeten expliciet worden gemarkeerd als is_suggestable
voor de API suggereren om de bijbehorende eigenschapsnaam en waarden automatisch aan te vullen.
Als u een aangepaste zoektoepassing bouwt, is autocomplete beschikbaar door de /query/suggest
API-eindpunten te bevragen.
beperkingen
Autocomplete heeft de volgende beperkingen:
-
Het beperken van de autocomplete zinnen van Cloud Search met behulp van de
FilterOptions
gedefinieerd in het schema wordt niet ondersteund, behalve voor de volgende ingebouwde infiltranten:objectype
mimetype
, en type filters. -
op zoekgeschiedenis gebaseerde suggesties (zoekopdrachten uitgevoerd door de gebruiker eerder in een zoekprogramma) worden niet ondersteund
-
maximaal 20 eigenschappen kunnen worden gemarkeerd als
is_suggestable
. Deze limiet kan worden verhoogd door contact op te nemen met Cloud Search support. -
zoekoperator autocomplete is niet beschikbaar voor eigenschappen met
exact_match_with_operator
.