Bases de connaissances

Créez une base de connaissances, alimentez-la avec vos documents, vos FAQ, vos sites web et vos outils de support, puis vérifiez ce que vos agents y trouveront.

Une base de connaissances rassemble les contenus dans lesquels vos agents vont chercher leurs réponses : conditions générales, FAQ du service client, fiches produits, procédures internes, pages de votre centre d'aide. Chaque contenu est découpé en segments puis indexé, pour qu'un agent retrouve en quelques millisecondes le passage qui répond à la question d'un client, au lieu de supposer la réponse.

Cette page explique comment créer une base, l'alimenter et la tenir à jour. Pour qu'un agent l'utilise, voir Relier une base à un agent.

Avant de commencer

  • Les bases se gèrent depuis Connaissances dans le menu principal (titre de page : Base de connaissances).
  • Pour importer depuis Mayday, Zendesk, Stonly ou Mindsay, l'intégration correspondante doit d'abord être connectée dans Paramètres > Connecteurs.

Créer une base

  1. Ouvrez Connaissances.
  2. Dans la colonne de gauche, cliquez sur Nouvelle.
  3. Saisissez le nom de la base (par exemple « FAQ Service client »), puis validez avec Entrée ou le bouton de confirmation.

La base créée s'ouvre aussitôt. Chaque base a sa propre adresse dans l'application (/knowledge/<identifiant>) : vous pouvez la partager avec un collègue ou la retrouver après un rechargement.

Détail d'une base de connaissances avec ses documents

  • La colonne de gauche liste vos bases avec, pour chacune, le nombre de documents qu'elle contient.
  • Le champ Filtrer les bases… retrouve une base par son nom, sans tenir compte des majuscules ni des accents (« general » trouve « Général »).
  • Les bases s'affichent par pages de 15.
  • Les flèches ↑ et ↓ du clavier passent d'une base à l'autre lorsque le curseur n'est pas dans un champ de saisie.

Ajouter du contenu

Cliquez sur Ajouter sous le nom de la base. Le panneau Ajouter à la base propose huit types de sources.

TypeCe qu'il ajouteQuand l'utiliser
TexteUn document saisi à la mainUne réponse courte, une consigne, un texte que vous n'avez pas sous forme de fichier
FichierUn document importé (PDF, Word, PowerPoint, Excel, texte)Conditions générales, guides, grilles tarifaires
CSVUne série de couples question / réponseUne FAQ existante exportée d'un tableur
Site webLes pages d'un site, explorées automatiquementVotre centre d'aide ou vos pages produits publiques
Mayday, Zendesk, Stonly, MindsayUne collection (ou, pour Mindsay, une base) de votre outil de supportGarder la base alignée sur votre outil de gestion de contenu

Texte

  1. Choisissez Texte.
  2. Renseignez Titre du document et le contenu dans Contenu à indexer….
  3. Facultatif : indiquez une URL source (optionnel), affichée avec le document.
  4. Cliquez sur Indexer.

Le titre et le contenu sont obligatoires.

Fichier

  1. Choisissez Fichier.
  2. Cliquez sur Choisir ou déposer un fichier, ou glissez-déposez le fichier dans la zone.

Le contenu est extrait (texte des diapositives, feuilles et cellules…) puis indexé automatiquement. Le nom du fichier devient le titre du document, et un badge indique son format dans la liste.

FormatExtension
PDF.pdf
Word.docx (.doc également accepté)
PowerPoint.pptx
Excel.xlsx
Texte.txt (.md également accepté)

Le format est vérifié avant l'envoi. Un fichier d'un autre format, sans extension ou vide est refusé avec un message explicite, et le panneau reste ouvert pour que vous puissiez en choisir un autre. Un fichier trop volumineux est refusé avec le message « Fichier trop volumineux pour être importé. »

CSV de questions / réponses

Le CSV convient aux FAQ : chaque ligne devient un document.

  1. Choisissez CSV.
  2. Si besoin, cliquez sur Télécharger le modèle CSV pour partir d'un fichier prêt à remplir.
  3. Cliquez sur Choisir un fichier CSV (ou déposez le fichier).

Le fichier doit être séparé par des virgules et comporter trois colonnes :

ColonneContenuExemple
questionLa question posée par le clientQuels sont vos horaires d'ouverture ?
responseLa réponse à donnerLe support est ouvert du lundi au vendredi, de 9h à 18h.
optionMode d'indexation : QUESTION, RESPONSE ou QUESTION_RESPONSEQUESTION_RESPONSE

Attention

La colonne option n'accepte que ces trois valeurs. Une autre valeur fait échouer l'import. Le modèle téléchargeable n'utilise que des valeurs valides.

L'indexation d'un CSV se poursuit après l'envoi : les nouveaux documents apparaissent dans la liste au bout de quelques secondes. Si ce n'est pas le cas, cliquez sur l'icône de rafraîchissement à côté de Documents.

Panneau d'ajout de contenu, onglet Fichier

Site web

Flowtative explore le site à partir de l'adresse indiquée, découvre les pages liées, puis les indexe.

  1. Choisissez Site web.
  2. Saisissez l'adresse de départ (par exemple https://exemple.com/aide).
  3. Facultatif : un Titre (optionnel) pour reconnaître la source.
  4. Choisissez le Rafraîchissement (voir ci-dessous).
  5. Ajustez Pages max (100 par défaut, 0 = sans limite) et Profondeur (2 par défaut, 0 = page de départ seule, 10 au maximum).
  6. Cliquez sur Crawler.
RafraîchissementComportement
Manuelle (par défaut)Les pages découvertes attendent votre feu vert (bouton Indexer) ; le rafraîchissement se fait à la main.
HebdomadaireIndexation automatique après l'exploration, puis re-exploration et ré-indexation tous les 7 jours.
MensuelleIdem, tous les 30 jours.
TrimestrielleIdem, tous les 90 jours.

Chaque site ajouté apparaît sous Sources web avec son statut, le nombre de pages, la fréquence et la date de la dernière synchronisation.

StatutSignification
Exploration…Flowtative parcourt le site.
Échec de l'explorationL'exploration a échoué : vérifiez l'adresse et les réglages d'exploration (Configurer).
À indexerExploration terminée en mode manuel. Cliquez sur Indexer les N pages découvertes.
Indexation en attente / Indexation…Les pages sont en cours d'indexation.
À jourToutes les pages sont indexées.

Tant qu'une exploration ou une indexation est en cours, aucune autre action n'est possible sur la source.

Configurer une source web

Survolez la source puis cliquez sur l'icône Configurer pour ouvrir le panneau Configurer la source.

RéglageDescriptionValeur par défaut
TitreNom affiché de la sourceTitre saisi à la création
LangueLangue du contenu (ex. fr)Vide
Nettoyage LLM du contenuFait nettoyer le texte des pages avant indexationDésactivé
Fréquence automatiqueManuelle, Hebdomadaire, Mensuelle ou TrimestrielleChoix de la création
Pages maxNombre maximal de pages explorées (0 = sans limite)100
ProfondeurNombre de liens suivis depuis la page de départ2
Durée (s)Durée maximale d'une exploration, de 15 à 10 800 secondes900
Chemins inclus (whitelist)N'explorer que ces chemins (ex. /docs/*)Aucun
Chemins exclusNe jamais explorer ces chemins (ex. /blog/*)Aucun
Suivre les sous-domaines internesExplorer aussi les sous-domaines du siteActivé
Suivre les liens externesExplorer les liens vers d'autres sitesDésactivé
Ignorer la restriction de chemin racineSortir du chemin de l'adresse de départDésactivé

La section Avancé ajoute : Domaines externes autorisés (si les liens externes sont suivis), Sous-domaines internes autorisés, Balises HTML à exclure (ex. nav, footer, pour ignorer menus et pieds de page), Pays (proxy) et Budget crédits (0 = ∞).

Le même panneau propose trois actions ponctuelles, disponibles selon le statut de la source :

  • Re-explorer maintenant : relit le site pour trouver les nouvelles pages et les pages modifiées (une fois la source à jour).
  • Indexer les nouvelles pages : n'indexe que les pages pas encore indexées.
  • Tout ré-indexer : ré-indexe toutes les pages avec les réglages actuels, par exemple après un changement de nettoyage ou de langue.

Cliquez sur Enregistrer pour appliquer les réglages.

Mayday, Zendesk, Stonly et Mindsay

  1. Choisissez l'outil concerné.
  2. Si aucune intégration n'est connectée, le panneau vous renvoie vers Paramètres > Connecteurs. Connectez votre espace, puis revenez.
  3. Sélectionnez une collection dans Choisir une collection… (pour Mindsay : Choisir une base Mindsay…). Le nombre de documents de chaque collection est indiqué.
  4. Cliquez sur Importer la collection (Mindsay : Importer la base).

Les collections rattachées apparaissent sous Collections externes. Pour chacune, vous pouvez :

  • cliquer sur la carte pour n'afficher que ses documents (un filtre collection · … apparaît au-dessus de la liste ; cliquez dessus pour le retirer) ;
  • Synchroniser pour récupérer les dernières modifications ;
  • Retirer de la base (confirmation Retirer ?).

Pour Mindsay, une intégration en temps réel est signalée par la mention temps réel à la place de la date de synchronisation.

Suivre vos documents

La section Documents liste le contenu de la base, par pages de 10. Chaque document affiche son titre, un extrait, le nombre de segments et des badges d'état.

BadgeSignification
IndexéLe document est découpé en segments et consultable par vos agents.
En traitementL'indexation est en cours.
En échecL'indexation a échoué. Le détail du document indique pourquoi.
Brouillon / DésactivéÉtat du document dans la base (hors production).
Suggestion, En relecture, Approuvé, Rejeté, ArchivéÉtape de relecture du document, lorsqu'il en a une.
Triangle et nombreNombre d'erreurs de traitement.

Cliquez sur un document (ou sur Voir le contenu) pour ouvrir son détail :

  • l'URL source, si elle existe ;
  • les Erreurs de traitement, avec leur date et leur message ;
  • le Contenu, en mode Rendu (lecture mise en forme) ou RAW (texte exact indexé) ;
  • les Segments indexés, c'est-à-dire les passages que la recherche peut renvoyer.

Pour supprimer un document, cliquez sur l'icône Supprimer le document.

Attention

La suppression d'un document est immédiate, sans demande de confirmation.

Tester la recherche

Avant de confier la base à un agent, vérifiez qu'elle renvoie les bons passages.

  1. Dans le champ Tester la recherche sémantique…, tapez une question telle qu'un client la poserait, par exemple « Combien de temps ai-je pour retourner un article ? ».
  2. Cliquez sur Chercher.

Jusqu'à 5 résultats s'affichent, chacun avec le titre du document, un extrait et un score de pertinence entre 0 et 1. Seuls les passages dont le score atteint 0,3 sont retenus. Si aucun résultat ne remonte, le message « Aucun segment trouvé. » s'affiche : reformulez la question, ou complétez la base.

Propriétés de la base

Cliquez sur Propriétés en haut à droite de la base.

PropriétéDescription
NomRenommez la base, puis cliquez sur Enregistrer.
Configuration d'embeddingsModèle utilisé pour transformer documents et questions en vecteurs comparables. Une liste avec recherche permet de choisir parmi les configurations disponibles.
IdentifiantL'identifiant de la base, avec un bouton de copie.

Important

Après un changement de configuration d'embeddings, lancez une réindexation de la base : les vecteurs existants ne sont plus comparables avec les nouveaux.

Trois actions figurent en bas du panneau :

  • Réindexer : recalcule l'indexation de tous les documents.
  • Vider la base : supprime définitivement tous les documents. La base, ses sources web et ses intégrations restent.
  • Supprimer la base : supprime définitivement la base entière, avec ses documents, ses sources web et ses rattachements aux outils de support.

Pour vider ou supprimer une base, vous devez taper son nom exact avant de confirmer. Ces deux opérations sont irréversibles.

Bonnes pratiques

  • Une base par périmètre. Séparez par exemple « FAQ Service client » et « Catalogue produits » : un agent de support n'a pas besoin des fiches techniques, et des résultats plus ciblés donnent de meilleures réponses.
  • Des documents courts et titrés. Une question par document dans une FAQ, un titre explicite : la recherche renvoie des passages plus précis.
  • Testez avec les mots de vos clients. Reprenez des formulations réelles tirées de vos transcriptions plutôt que le vocabulaire interne.
  • Limitez l'exploration des sites. Utilisez Chemins inclus et Balises HTML à exclure pour ne garder que le contenu utile (centre d'aide, pages produits) et ignorer menus, blog et mentions légales.
  • Choisissez un rafraîchissement automatique pour les sites qui changent souvent, afin d'éviter des réponses périmées.

Pour aller plus loin

Sur cette page