La saisie semi-automatique de Google Cloud Search aide les utilisateurs en leur suggérant des mots lorsqu'ils saisissent une requête de recherche. Par exemple, les suggestions peuvent inclure des mots tirés des titres de documents, des opérateurs de recherche ou des noms de votre organisation Google Workspace.
La saisie semi-automatique extrait des expressions des titres de documents indexés et utilise un modèle n-gram pour déterminer les suggestions à l'aide de l'API Suggest. Par défaut, la saisie semi-automatique affiche des expressions issues des titres de documents. Vous pouvez également marquer les propriétés de schéma de texte et d'énumération comme is_suggestable pour compléter automatiquement les noms et les valeurs des propriétés.
L'API Suggest examine les requêtes de recherche pour détecter des indices de langue, comme l'anglais ou l'espagnol, et hiérarchise les résultats. Le champ languageCode d'une requête permet également d'améliorer les suggestions spécifiques à une langue.
Exemple de scénario
Prenons l'exemple d'une source de données contenant des données de films :
- La source de données contient deux documents.
- Chaque document possède un titre (
ItemMetadata.title) et deux propriétés :genreetcharacters. - Titre du document 1 : "Avengers Infinity War" ;
genre=science fiction;characters=Iron Man, Hulk. - Titre du document 2 : "Harry Potter" ;
genre=Adventure, Fantasy;characters=Hermione, Harry Potter.
La figure 1 illustre la façon dont la saisie semi-automatique extrait les suggestions.
À partir du document 1, le modèle extrait des n-grammes (jusqu'à des trigrammes) tels que "Avengers", "Infinity", "War", "Avengers Infinity", "Infinity War" et "Avengers Infinity War". À partir du document 2, il génère "Harry", "Potter" et "Harry Potter".
Si un utilisateur saisit "h" lorsqu'il interroge cette source de données, les suggestions suivantes peuvent s'afficher :
- Harry
- Hermione
- Hulk
- Harry Potter
Si l'utilisateur sélectionne "Hermione", puis saisit "a", la saisie semi-automatique peut afficher :
- Aventure d'Hermione
- Action Hermione
- Hermione Avengers
La saisie semi-automatique tente de compléter le dernier mot ou n-gramme saisi. Dans cet exemple, "a" est développé en "aventure", "action" et "avengers" (avengers) car aucun texte indexé ne commence par "hermione a.". Il s'agit d'une suggestion de queue.
La saisie semi-automatique de Cloud Search renvoie un maximum de cinq suggestions de contenu de document et deux suggestions de personnes.
Par défaut, la saisie semi-automatique affiche des expressions issues des titres de documents. Vous devez marquer explicitement les propriétés de schéma comme is_suggestable pour que l'API Suggest puisse compléter automatiquement les noms et les valeurs des propriétés.
Intégrer l'API Suggest
Si vous utilisez l'application de recherche par défaut ou le widget de recherche intégrable, Cloud Search est compatible avec la saisie semi-automatique. N'oubliez pas de marquer les propriétés de schéma comme is_suggestable si vous souhaitez qu'elles soient complétées automatiquement.
Si vous créez une application de recherche personnalisée, la saisie semi-automatique est disponible à l'aide des points de terminaison de l'API /query/suggest.
Limites
La saisie semi-automatique présente les limites suivantes :
- Il n'est pas possible de limiter les expressions de saisie semi-automatique à l'aide de
FilterOptions, sauf pour les filtres intégrés tels queobjecttypeetmimetype. - Les suggestions basées sur l'historique des requêtes d'un utilisateur ne sont pas acceptées.
- Vous pouvez marquer jusqu'à 20 propriétés comme
is_suggestable. Contactez l'assistance Cloud Search pour augmenter cette limite. - La saisie semi-automatique des opérateurs de recherche n'est pas disponible pour les propriétés avec
exact_match_with_operator. - La saisie semi-automatique renvoie un maximum de cinq suggestions de contenu de document et deux suggestions de personnes.
- La saisie semi-automatique ne suggère que des expressions provenant de documents auxquels l'utilisateur a accès.