La saisie semi-automatique de Google Cloud Search aide les utilisateurs en suggérant des mots à mesure qu'ils saisissent une requête de recherche. Par exemple, les suggestions peuvent inclure des mots provenant de 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 provenant des titres de documents. Vous pouvez également marquer des 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 obtenir des indications sur la langue, comme l'anglais ou l'espagnol, et hiérarchise les résultats. Le champ
languageCode
d'une requête améliore également les suggestions spécifiques à la langue.
Exemple de scénario
Prenons l'exemple d'une source de données contenant des données sur des films :
- La source de données contient deux documents.
- Chaque document comporte 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 montre comment 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" lors de l'interrogation de cette source de données, il peut voir les suggestions suivantes :
- Harry
- Hermione
- Hulk
- Harry Potter
Si l'utilisateur sélectionne "Hermione", puis saisit "a", la saisie semi-automatique peut afficher les éléments suivants :
- Hermione Adventure
- Hermione Action
- Hermione Avengers
La saisie semi-automatique tente de compléter le dernier mot ou n-gramme saisi. Dans cet exemple, elle développe "a" en "adventure", "action" et "avengers", car aucun texte indexé ne commence par "hermione a". Il s'agit d'une suggestion de fin.
La saisie semi-automatique de Cloud Search renvoie un maximum de cinq suggestions à partir du contenu du document et deux suggestions de personnes.
Par défaut, la saisie semi-automatique affiche des expressions provenant des titres de documents. Vous devez marquer explicitement les propriétés de schéma comme is_suggestable pour que l'API Suggest complète 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 :
- La restriction des expressions de saisie semi-automatique à l'aide de
FilterOptionsn'est pas acceptée, à l'exception des 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 un maximum de 20 propriétés comme
is_suggestable. Contactez l'assistance Cloud Search pour augmenter cette limite. - La saisie semi-automatique de l'opérateur 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.