Cet article décrit comment résoudre les problèmes liés au backend de recherche lorsque les résultats réels des entités ne s'affichent pas comme prévu.

Assurez-vous de suivre d'abord les étapes de l'article Premières étapes de dépannage des problèmes de backend de recherche.

 

Étapes générales de dépannage

Vous devrez comparer le log de recherche et y trouver la requête que vous dépannez avec les champs consultables définis dans la configuration. Commencez par ouvrir ces deux éléments :

1. Vérifiez la configuration du secteur.
   1. Accédez à Search > [[Experience Name]] > Verticals.
   2. Sélectionnez le secteur en question. Ici, vous verrez les champs de recherche du secteur.
2. Ouvrez le log de recherche correspondant à la requête pour laquelle vous rencontrez des problèmes. Soit :
   1. Accédez à Search > [[Experience Name]] > Test Search ou à un sous-onglet de Configuration. Exécutez une recherche de test, puis sélectionnez Debug Query dans le menu déroulant.
   2. Si vous avez déjà effectué la recherche dans un environnement de développement ou de production, accédez à Search > [[Experience Name]] > Search Logs et cliquez sur le log de recherche pertinent. Utilisez la barre de recherche ou les filtres pour trouver le bon log de recherche ou relancez la recherche pour qu'elle apparaisse en haut.

 

Cette entité n'apparaît pas du tout dans mes résultats

Les étapes suivantes vous guideront à travers les facteurs qui peuvent empêcher l'entité de s'afficher dans les résultats. Une fois que vous avez déterminé la nature du problème, vous pouvez :

• Comprenez que ce résultat est attendu et laissez-le tel quel
• Mettre à jour la configuration des champs de recherche ou des règles de requête
• Mettre à jour le contenu de l'entité en ouvrant la page de modification de l'entité

Une fois que vous avez résolu votre problème, vous pouvez ignorer les étapes restantes.

1. Examinez les champs de recherche du secteur et notez ce qui est activé pour le secteur dans lequel se trouve cette entité.
2. Vérifiez les filtres déduits : dans le log de recherche, trouvez le secteur pertinent et vérifiez si des filtres déduits ont été appliqués à ce secteur. Si tel est le cas, l’entité doit satisfaire exactement à tous les filtres déduits appliqués.
3. Vérifiez la similarité sémantique : si la recherche sémantique est activée, vérifiez la similarité sémantique de l'entité (vous devez exécuter la requête dans la recherche de secteur et ouvrir le log de recherche si elle n'apparaît pas dans la recherche universelle). Si cette valeur est inférieure à la valeur par défaut de 0,3, l’entité n’apparaîtra pas dans les résultats.
4. Vérifiez les règles de requête : vérifiez si une règle de requête active n'empêche pas l'affichage de cette entité. Les règles de requête actives sont affichées dans la case des facteurs de recherche en haut à droite du log de recherche.
5. Vérifiez les correspondances de recherche par mot-clé, recherche de document et recherche par expression : si ces types de champs consultables sont activés, dans le log de recherche, examinez les jetons de recherche, puis les correspondances des champs consultables à côté de chaque entité dans le secteur pertinent pour voir sur quelle partie de la requête l'algorithme se base.
   1. Confirmez que l'entité en question possède ces correspondances.
   2. Si la requête de recherche comportait plusieurs mots (par exemple « facteurs de recherche au niveau de l'entité ») qui ont été pris comme des éléments distincts (par ex. « niveau de l’entité », « recherche » et « facteurs », et qu'ils devraient réellement ne constituer qu'un seul jeton ; configurez une phrase personnalisée.
      1. Accédez à Search > [[Experience Name]] > General Settings (Paramètres généraux).
      2. Sous Custom Phrases (Expressions personnalisées), saisissez la phrase souhaitée.
6. Vérifiez les filtres enregistrés : les entités n'apparaîtront pas si elles ne font pas partie d'un filtre enregistré.
   1. Accédez à Search > [[Experience Name]] > Verticals.
   2. Sélectionnez le secteur pertinent, cliquez sur l'onglet Paramètres et trouvez la propriété Filtres enregistrés.
   3. Vérifiez si un filtre enregistré est sélectionné ici et mettez-le à jour si nécessaire.
   4. Pour voir quels filtres sont utilisés et quelles entités sont incluses dans ce filtre enregistré :
      1. Accédez à Knowledge Graph > Entities (Entités).
      2. Cliquez sur l'icône en forme d'entonnoir dans le coin supérieur droit.
      3. Cliquez sur le nom du filtre à appliquer.
      4. Les filtres appliqués s'affichent en haut de l'écran et les entités qui correspondent au filtre enregistré sont listées en dessous.

 

Cette entité apparaît plus haut ou plus bas dans les résultats que prévu

1. Vérifiez l'ordre de tri : dans le log de recherche, recherchez les secteurs pertinents et voyez quel ordre de tri, le cas échéant, a été appliqué.
   1. Ajoutez ou modifiez la configuration de tri en accédant à Search > [[Experience Name]] > Verticals et en cliquant sur l'onglet Sorting (Tri). Ensuite, ajoutez ou modifiez les règles.
2. Vérifiez la similitude sémantique : vérifiez la similitude sémantique pour l'entité concernée et celles qui l'entourent.
   1. Si la recherche sémantique et la recherche par mot-clé sont toutes deux activées et que la similitude sémantique dépasse 0,65, l'algorithme augmente automatiquement ce résultat, indépendamment de ses correspondances de jetons.
3. Vérifiez les règles de requête : vérifiez si une règle de requête active n'empêche pas l'affichage de cette entité. Les règles de requête actives sont affichées dans la case des facteurs de recherche en haut à droite du log de recherche.
4. Vérifiez les correspondances de recherche par mot-clé, recherche de document et recherche par expression : si ces types de champs consultables sont activés, dans le log de recherche, examinez les jetons de recherche, puis les correspondances des champs consultables à côté de chaque entité dans le secteur pertinent pour voir sur quelle partie de la requête l'algorithme se base.
   1. Vérifiez le nombre de correspondances de jetons pour cette entité par rapport à d'autres. Un nombre plus élevé de correspondances sera mieux classé dans les résultats.
   2. Confirmez que l'entité en question possède ces correspondances.
   3. S'il existe une correspondance d'expression sur une entité différente avec le même nombre de correspondances de jetons, la correspondance d'expression appliquera un boost sur cette entité afin qu'elle apparaisse plus haut dans les résultats de recherche.
   4. Si la requête de recherche comportait plusieurs mots (par exemple « facteurs de recherche au niveau de l'entité ») qui ont été pris comme des éléments distincts (par ex. « niveau de l’entité », « recherche » et « facteurs », et qu'ils devraient réellement ne constituer qu'un seul jeton ; configurez une phrase personnalisée.
      1. Accédez à Search > [[Experience Name]] > General Settings (Paramètres généraux).
      2. Sous Custom Phrases (Expressions personnalisées), saisissez la phrase souhaitée.

 

Les entités n'apparaissent plus dans ma recherche sémantique

1. Ouvrez le log de recherche pour trouver la requête pour laquelle vous rencontrez des problèmes. Soit :
   
   1. Accédez à Search > [[Experience Name]] > Test Search ou à un sous-onglet de Configuration. Lancez une recherche de test, puis sélectionnez Debug Query dans le menu déroulant.
   2. Si vous avez déjà effectué la recherche dans un environnement de développement ou de production, accédez à Search > [[Experience Name]] > Search Logs et cliquez sur le log de recherche pertinent. Utilisez la barre de recherche ou les filtres pour trouver le bon log de recherche ou relancez la recherche pour qu'elle apparaisse en haut.
2. Pensez également à ouvrir un ancien log de recherche dans lequel l’entité concernée est apparue dans les résultats. Utilisez la barre de recherche de la page des logs de recherche pour filtrer par termes de recherche et en ouvrir une où l'entité est apparue.
3. Vérifiez le score sémantique des entités et la différence entre les scores sémantiques.
4. N'oubliez pas que les modèles de science des données derrière la recherche sémantique sont constamment améliorés. Cela fait parfois perdre toute pertinence à des résultats qui n'étaient guère pertinents auparavant.

 

Des entités ayant des scores inférieurs à mes seuils sémantiques apparaissent

1. Vérifiez le seuil du secteur.
   1. Accédez à Search > [[Experience Name]] > Verticals.
   2. Trouvez le secteur pertinent et notez la valeur du Seuil.
2. Ouvrez le log de recherche correspondant à la requête pour laquelle vous rencontrez des problèmes. Soit :
   1. Accédez à Search > [[Experience Name]] > Test Search ou à un sous-onglet de Configuration. Exécutez une recherche de test, puis sélectionnez Debug Query dans le menu déroulant.
   2. Si vous avez déjà effectué la recherche dans un environnement de développement ou de production, accédez à Search > [[Experience Name]] > Search Logs et cliquez sur le log de recherche pertinent. Utilisez la barre de recherche ou les filtres pour trouver le bon log de recherche ou relancez la recherche pour qu'elle apparaisse en haut.
3. Examinez le score sémantique du résultat de l'entité numéro un dans ce secteur et examinez le score du secteur. Pour rappel, le seuil du secteur détermine à quel point une entité doit être pertinente au sein du secteur pour que celui-ci apparaisse. Tant que le résultat de la première entité dépasse le seuil, le produit fonctionne comme prévu.