La recherche sur le site de la base de connaissances Document360 aide les lecteurs à trouver rapidement des articles, des catégories et des pièces jointes en utilisant une barre de recherche au-dessus de la liste d’articles. Les résultats sont classés par pertinence et affichés avec le nom du contenu, un aperçu du texte correspondant et le chemin des miettes de pain. La recherche avancée permet aux lecteurs de filtrer les résultats et de rechercher dans plusieurs espaces de travail et langues simultanément, et les pièces jointes de recherche étendent la recherche au texte à l’intérieur de fichiers PDF.
Quand utiliser la recherche avancée et les filtres
Utilisez une recherche avancée et des filtres lorsque les lecteurs doivent affiner les résultats au-delà d’une simple correspondance de mots-clés.
- Un lecteur recherche un terme courant comme « connexion » et doit regrouper les résultats dans un espace de travail ou une langue.
- Votre base de connaissances couvre plusieurs espaces de travail, y compris la documentation de l’API, et les lecteurs ont besoin d’une seule recherche qui les couvre tous.
- Les lecteurs doivent trouver du contenu dans les pièces jointes PDF, pas seulement le texte de l’article.
Comment la recherche classe les résultats
Les résultats de recherche sont basés sur les attributs suivants : titres d’articles et de catégories, tags, slugs, breadcrumbs et contenu textuel au sein des articles et catégories.
Séquence de priorité de recherche : Les résultats sont classés selon leur pertinence dans cet ordre : Titre > Tags > Slug > Breadcrumbs > Contenu/Description. Lorsque plusieurs types de contenu (articles, arbres de décision, documentation API) correspondent à une requête, le résultat le plus pertinent apparaît le plus élevé, quel que soit le type de contenu. Si le score de pertinence d’un arbre de décision est supérieur ou égal à celui d’un article, l’arbre de décision apparaît plus haut dans les résultats.
Comment configurer les paramètres de recherche
Les paramètres suivants sont configurés dans > Knowledge base site > Article settings & SEO > Article settings , sous l’onglet Paramètres de recherche .
Activer la recherche avancée
- Naviguez dans > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.
- Naviguez dans Article settings & SEO.
- Dans l’accordéon des paramètres de recherche , activez le bouton Activer la recherche avancée .
- Sélectionnez la case Inclure tous les espaces de travail dans les recherches de site pour définir le filtre de recherche sur Tous les espaces de travail (y compris la Documentation API) par défaut, au lieu de Espace de travail actuel.
Si Activer la recherche avancée est désactivée, les options de filtre n’apparaissent pas sur le site de la base de connaissances.
Activez l’onglet pièces jointes dans la recherche
- Naviguez dans > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.
- Naviguez dans Article settings & SEO.
- Sélectionnez l’onglet Article settings .
- Développez l’accordéon des paramètres de recherche et activez l’onglet Afficher les pièces jointes dans la recherche .
Si le bouton Afficher les fichiers d’articles est désactivé, l’onglet Afficher les pièces jointes dans la recherche est inaccessible. Allumez-le d’abord dans l’accordéon droit de l’article . Lorsque l’onglet Afficher les pièces jointes dans la recherche est désactivé, la recherche ne couvre que les éléments d’article et de catégorie tels que le titre, le slug, les tags et le contenu.
Ne pas activer les retours de résultats de recherche
- Naviguez dans > Knowledge base site dans la barre de navigation de gauche du portail de la base de connaissances.
- Naviguez dans Article settings & SEO.
- Sélectionnez l’onglet Article settings .
- Développez l’accordéon des paramètres de recherche et activez le bouton Pas de retour de résultats de recherche .
Lorsque ce bouton est activé et qu’une recherche ne donne aucun article, les lecteurs voient un formulaire de retour au lieu d’une page de résultats vide. Les retours soumis apparaissent dans le module d’analyse de recherche . Lorsque le bouton est désactivé, les recherches sans résultat affichent une page de résultats vide.
Les paramètres de recherche sont désormais configurés pour la recherche avancée, la recherche par pièces jointes et le retour sans résultat.
Comment les lecteurs utilisent la recherche
Accès à la recherche avancée
- Cliquez sur la barre de recherche et sélectionnez Aller à la recherche avancée.
- Utilisez les filtres disponibles pour affiner les résultats.
| Filtre | Description |
|---|---|
| Espace de travail | Espace de travail actuel : résultats uniquement de l’espace actif actif. Tous les espaces de travail : résultats dans tous les espaces de travail, y compris la documentation de l’API. Spécifiques : résultats d’un ou plusieurs espaces de travail sélectionnés. |
| Langue | Langue actuelle : donne uniquement la langue active. Tous les langages : résultats dans toutes les langues prises en charge. Spécifique : résultats d’une ou plusieurs langues sélectionnées. |
| Tags | Réduit les résultats aux articles contenant les tags sélectionnés. |
| Contributeur | Réduit les résultats au contenu de contributeurs sélectionnés. |
| Date | Filtrez par plage de dates : Derniers 7 jours, Derniers 30 jours, Derniers 90 jours, ou une plage personnalisée. |
| Catégories | Réduit les résultats aux articles ou pages dans certaines catégories. |
Lorsque l’espace de travail actuel est sélectionné, les résultats apparaissent dans des onglets individuels (Articles, Catégories, Documents API) et dans un onglet Tout, classés par pertinence. Tous les espaces de travail scannent chaque espace de travail, y compris la documentation de l’API, et l’onglet Tous classe les résultats selon leur pertinence à travers eux.
Filtrage par type de contenu
L’option Filtrer à gauche de la barre de recherche restreint les résultats par type de contenu :
- Titres de catégories de recherche : Titres de catégories et articles contenant le mot-clé de recherche.
- Pièces jointes de recherche : pièces jointes contenant le mot-clé de recherche.
Recherche des pièces jointes
Lorsqu’un lecteur recherche un mot-clé, les résultats apparaissent sous les onglets de filtre :
- Articles () : Résultats dans les articles.
- Arbres de décision () : Résultats dans les guides de l’arbre de décision.
- API Docs () : Résultats dans la documentation de l’API.
- Catégories () : Résultats dans les catégories.
- Fichiers () : Résultats dans les pièces jointes PDF.
Si un mot-clé ne donne aucun résultat d’article, les lecteurs peuvent accéder à l’onglet Fichiers pour trouver des pièces jointes PDF correspondantes et les consulter en même temps que l’article. Dans le portail de la base de connaissances, les comptes d’équipe peuvent utiliser cela pour scanner les fichiers PDF dans le Drive à la recherche d’un mot-clé, même si le nom du fichier ne correspond pas. Les résultats de recherche de pièces jointes montrent le chemin complet des miettes de pain, y compris le nom de l’article, afin que les lecteurs sachent à quel article appartient une pièce jointe sans ouvrir le fichier.
Aucun comportement dans les résultats de recherche
Lorsque le retour « Aucun retour de recherche » est activé, le comportement dépend de la manière dont le lecteur recherche :
- Après avoir saisi un terme de recherche, le lecteur appuie soit sur Entrée , soit clique sur la bannière Entrer pour demander à Eddy IA .
- Si le lecteur appuie sur Entrée : Eddy, l’IA tente d’obtenir les résultats pertinents. Si l’entrée est un mot-clé, Eddy AI pose une question de suivi pour confirmer l’intention. Si l’entrée est une requête complète, Eddy AI récupère directement la réponse.
- Si le lecteur appuie sur la bannière Entrée pour demander à l’IA de Eddy : le système considère l’entrée comme une requête complète. Si aucun résultat n’est trouvé, le formulaire de retour sans résultat de recherche apparaît immédiatement, sans invite de suivi.
Support des opérateurs de recherche
Utilisez des opérateurs de recherche pour construire des requêtes plus précises.
- Deux guillemets (
"") : Cherchez une phrase exacte. Les mots entre guillemets doivent correspondre exactement dans cet ordre. - Signe moins (
-) : Exclure un mot des résultats. Placez le signe moins juste devant un mot, sans espace, pour l’exclure.
| Requête | Résultat |
|---|---|
search -recipe |
Les archives contenant search, mais pas recipe. |
search-recipe |
Des enregistrements contenant à la fois search et recipe — sans exclusion, puisque le signe moins est au milieu du mot. |
-recipe |
Tous les enregistrements sauf ceux contenant recipe. |
-recipe pasta |
Les archives contenant pasta, mais pas recipe. |
"-recipe" |
Les enregistrements contenant la phrase -recipe littérale — aucune exclusion n’est effectuée. |
Limites
| Limite | Valeur | Notes |
|---|---|---|
| Taille de pièce jointe PDF pour l’indexation de recherche | Jusqu’à 10 Mo | Les fichiers plus volumineux ne sont pas scannés pour trouver des correspondances de mots-clés. |
La recherche Document360 est alimentée par Algolia, qui équilibre rapidité et pertinence. Algolia peut renvoyer un nombre de résultats approximatif au lieu d’un total exhaustif pour maintenir des temps de réponse rapides, donc le nombre pour la même requête peut parfois varier. C’est un comportement attendu et ce n’est pas configurable depuis Document360.
Meilleures pratiques
- Activez l’inclusion de tous les espaces de travail dans les recherches de site si votre base de connaissances couvre plusieurs espaces de travail, y compris la documentation de l’API, afin que les lecteurs n’aient pas besoin de changer manuellement le filtre.
- Activez l’onglet Afficher les pièces jointes dans la recherche si votre base de connaissances repose sur des pièces jointes PDF pour les références que les lecteurs de contenu recherchent directement.
- Utilisez le formulaire de retour sans résultats de recherche pour recueillir ce que les lecteurs recherchaient, puis examinez les soumissions dans Search Analytics pour combler les lacunes de contenu.
- Syntaxe de l’opérateur de recherche de document (
""et-) pour les utilisateurs avancés qui ont besoin de requêtes précises et répétables.
FAQ
Qu’est-ce que la recherche avancée ?
La recherche avancée permet une recherche combinée à travers tous les espaces de travail et langues simultanément, aidant les lecteurs à localiser les résultats grâce aux filtres disponibles.
Comment fonctionne la recherche Algolia pour récupérer les réponses ?
Algolia cherche d’abord des articles contenant tous les mots de la requête. Si aucune correspondance exacte n’est trouvée, la recherche s’élargit pour inclure les articles contenant l’un des termes, classant les résultats selon le nombre de correspondances de termes. Cela garantit que les lecteurs perçoivent toujours le contenu pertinent même lorsqu’aucun article ne correspond exactement à chaque terme.
Comment masquer la barre de recherche sur la page d’accueil ?
La barre de recherche de la page d’accueil est visible par défaut et peut être cachée sans affecter la recherche sur le reste du site de la base de connaissances. Naviguez vers {{variable. Settings}} > {{variable. Site de la base de connaissances}}, puis allez dans Personnalisation du site > Personnaliser le site. Sélectionnez le menu déroulant En-tête et pied de page, choisissez Accueil, cliquez sur la section Héros, sélectionnez Rechercher, puis cliquez sur l’icône Masquer.
Comment puis-je exclure un article de la recherche ?
Vous pouvez exclure un article des recherches dans votre base de connaissances ou dans les moteurs de recherche externes — voir Exclure des articles des moteurs de recherche. Les articles cachés n’apparaissent pas sur le site de la base de connaissances et ne sont pas consultables par les lecteurs, bien que les membres de l’équipe puissent toujours les trouver dans le portail de la base de connaissances. Les catégories et les catégories de pages peuvent être masquées de la même manière.
Ma recherche inclura-t-elle les résultats de la documentation de l’API ?
Le filtre Espace de travail actuel est sélectionné par défaut. Pour rechercher ensemble dans votre documentation habituelle et votre documentation API, sélectionnez Tous les espaces de travail dans l’option Filtrer de la barre de recherche.
Comment la barre de recherche se comporte-t-elle avec les langues RTL, comme l’hébreu et l’arabe ?
Sélectionner un langage RTL ajuste la barre de recherche pour aligner le texte à droite et accepter l’entrée de droite à gauche. Si plusieurs langues sont sélectionnées et que toutes sont RTL, la barre de recherche conserve l’entrée et l’alignement de droite à gauche. Si la sélection mélange les langages RTL et LTR, le comportement suit le langage par défaut : l’entrée commence à droite si le défaut est RTL, ou à gauche si le défaut est LTR.
Puis-je localiser ou personnaliser le texte de l’interface utilisateur dans la recherche avancée ?
Oui, en utilisant des variables de localisation. Naviguez vers {{variable. Settings}} > {{variable. Portail de la base de connaissances}}, puis {{variable. Localisation n Espaces de travail}}. Dans l’onglet Variables de localisation, développez l’accordéon de recherche avancée pour mettre à jour des éléments tels que Aller dans recherche avancée, Espace de travail et Langue, puis cliquez sur Enregistrer.
Pourquoi le nombre de résultats de recherche varie-t-il parfois pour la même requête ?
La recherche Document360 est alimentée par Algolia, qui peut renvoyer un nombre approximatif de résultats au lieu d’un nombre exhaustif afin de maintenir des temps de réponse rapides. C’est un comportement attendu et ce n’est pas configurable depuis Document360.