Configurer votre expérience de Suggestion automatique personnalisée
Avertissement
Le 30 octobre 2020, les API de recherche Bing sont passées des services Azure AI aux services de recherche Bing. Cette documentation est fournie à des fins de référence uniquement. Pour accéder à la documentation mise à jour, consultez la documentation de l’API Recherche Bing. Pour obtenir des instructions sur la création de nouvelles ressources Azure pour Recherche Bing, consultez Créer une ressource Recherche Bing à l’aide de Place de marché Azure.
La suggestion automatique personnalisée retourne une liste de suggestions de chaînes de requête qui correspondent à votre recherche. Les chaînes de requête suggérées sont basées sur la chaîne de requête partielle qui est fournie par l’utilisateur dans la zone de recherche. La liste contient un maximum de 10 suggestions.
Vous spécifiez s’il faut retourner uniquement des suggestions personnalisées ou inclure également des suggestions Bing. Si vous incluez les suggestions Bing, les suggestions personnalisées apparaissent avant celles-ci. Si vous fournissez suffisamment de suggestions pertinentes, il est possible que la liste de suggestions retournée n’inclue pas les suggestions de Bing. Les suggestions Bing correspondent toujours au contexte de votre instance de Recherche personnalisée.
Pour configurer des suggestions de requête de recherche pour votre instance, cliquez sur l’onglet Suggestion automatique.
Notes
Pour utiliser cette fonctionnalité, vous devez vous abonner à la Recherche personnalisée au niveau approprié (voir Tarifs).
Les suggestions peuvent mettre jusqu’à 24 heures pour apparaître dans le point de terminaison de service (c’est-à-dire l’API ou l’interface utilisateur hébergée).
Activer les suggestions Bing
Pour activer les suggestions Bing, placez le curseur Automatic Bing suggestions (Suggestions automatiques Bing) sur la position d’activation. Le curseur devient bleu.
Ajouter vos propres suggestions
Pour ajouter vos propres suggestions de chaînes de requête, ajoutez-les à la liste qui se trouve sous Suggestions définies par l’utilisateur. Après avoir ajouté une suggestion à la liste, appuyez sur la touche Entrée ou cliquez sur l’icône + . Vous pouvez spécifier la suggestion dans n’importe quelle langue. Vous pouvez ajouter un maximum de 5 000 suggestions de chaînes de requête.
Charger des suggestions
Si vous le souhaitez, vous pouvez charger un fichier contenant la liste de suggestions. Le fichier doit contenir une seule chaîne de requête de recherche par ligne. Pour charger le fichier, cliquez sur l’icône de chargement, puis sélectionnez le fichier à charger. Le service extrait les suggestions du fichier et les ajoute à la liste.
Supprimer des suggestions
Pour supprimer une suggestion, cliquez sur l’icône de suppression en regard de la suggestion à éliminer.
Bloquer des suggestions
Si vous incluez des suggestions Bing, vous pouvez ajouter une liste comprenant les chaînes de requête que Bing ne doit pas retourner. Pour ajouter une chaîne de requête à bloquer, cliquez sur Show blocked suggestions (Afficher les suggestions bloquées). Ajoutez la chaîne de requête à la liste, puis appuyez sur la touche Entrée ou cliquez sur l’icône + . Vous pouvez bloquer un maximum de 50 chaînes de requête.
Publier ou annuler
Les modifications que vous apportez à une instance Recherche personnalisée sont effectuées dans l’onglet Configuration pour que vous puissiez valider vos modifications. Lorsque vos modifications sont terminées et que vous êtes prêt à les publier, cliquez sur Publish (Publier). Les modifications n’apparaissent sur vos points de terminaison de production qu’après leur publication.
Avant la publication, si vous décidez de ne pas conserver les modifications que vous avez effectuées, cliquez sur Revert (Rétablir). Lorsque vous annulez vos modifications, la configuration de l’état en direct demeure inchangée et l’onglet Configuration est rétabli pour correspondre à cet état.
Notes
Les modifications de configuration de la Suggestion automatique personnalisée peuvent demander jusqu’à 24 heures pour prendre effet.
Activation de la suggestion automatique dans l’interface utilisateur hébergée
Pour activer les suggestions de chaînes de requête pour votre interface utilisateur hébergée, cliquez sur Hosted UI (Interface utilisateur hébergée). Faites défiler jusqu’à la section Additional Configuration (Configuration supplémentaire). Sous Recherche Web, sélectionnez Activé pour l’option Enable autosuggest (Activer la suggestion automatique). Pour activer la suggestion automatique, vous devez sélectionner une disposition qui comprenne une zone de recherche.
Appel de l’API Suggestion automatique
Pour obtenir des suggestions de chaînes de requête à l’aide de l’API Recherche personnalisée Bing, envoyez une requête GET au point de terminaison suivant.
GET https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/Suggestions
La réponse contient une liste d’objets SearchAction contenant les chaînes de requête suggérées.
{
"displayText" : "sailing lessons seattle",
"query" : "sailing lessons seattle",
"searchKind" : "CustomSearch"
},
Chaque suggestion comporte les champs displayText et query. Le champ displayText correspond à la chaîne de requête suggérée que vous utilisez pour remplir la liste déroulante de la zone de recherche.
Si l’utilisateur sélectionne une chaîne de requête suggérée dans la liste déroulante, utilisez la chaîne de requête dans le champ query lorsque vous appelez l’API Recherche personnalisée Bing.