Base de connaissances

La Base de connaissances est le cœur de votre Agent IA Quickchat. Elle constitue le socle de sa compréhension de votre entreprise, de vos produits et de vos services. Une base bien structurée et complète garantit des réponses précises et utiles.

Ce guide présente un aperçu de la Base de connaissances, des stratégies pour bien la construire et des conseils d’optimisation.

Sources de données

La barre d’outils en haut de la page de la Base de connaissances vous permet d’ajouter des connaissances à partir de toutes les sources suivantes :

Add Article

Articles rédigés manuellement, avec un titre et un corps en texte enrichi. Utilisez cette option si vous souhaitez maîtriser exactement la formulation, par exemple pour des FAQ, des politiques internes, des spécifications produit ou tout contenu que vous colleriez normalement depuis un document.

Astuce

Consacrez chaque article à un seul sujet. Les articles longs qui couvrent plusieurs sujets compliquent la récupération des informations. Les diviser permet à l’IA de produire des réponses plus précises.

Add Paragraph

Faits courts et autonomes qui ne nécessitent pas un article complet. Les paragraphes sont regroupés, par exemple dans un dossier « Single Paragraphs », et traités comme de petites unités de connaissance. Ils conviennent à des phrases comme « L’expédition prend 3–5 jours ouvrés » ou « Les retours sont acceptés sous 30 jours ».

Add Website

Importez du contenu depuis n’importe quelle URL. Quatre modes d’importation sont disponibles :

• Page unique : importe une page web. Utilisez Options avancées → Sélecteur HTML pour limiter l’import à une partie précise de la page, par exemple main, #article-body ou .docs-content, lorsque le reste contient de la navigation, des publicités ou un pied de page.
• Pages multiples : collez une liste d’URLs. Chacune devient un article distinct.
• Plan de site : indiquez un fichier sitemap.xml. Chaque page du plan de site est importée comme un article distinct. Cette option convient particulièrement aux sites de documentation et aux blogs structurés.
• Toutes les pages : explore l’ensemble du site et importe chaque URL accessible du domaine. Utilisez cette option pour importer une documentation complète ou un blog d’entreprise.

Les URLs restent liées à leur source afin que vous puissiez les maintenir à jour automatiquement ou à la demande. Consultez Maintenir les articles URL à jour.

Actualisation automatique

Les articles associés à une URL peuvent récupérer automatiquement leur source une fois par jour, afin que la Base de connaissances suive la page source sans intervention manuelle.

Trois points à connaître avant de vous y fier :

• Le réglage s’applique par article, et non à l’ensemble du compte. Activez‑le pour les articles que vous voulez garder synchronisés.
• Il est réservé aux forfaits payants. Sur Free, utilisez l’actualisation manuelle.
• Modifier le contenu d’un article à la main le désactive pour cet article. C’est volontaire, car une récupération quotidienne écraserait sinon votre modification dès le lendemain matin. Mais cela signifie qu’une page que vous avez personnalisée cesse de suivre sa source jusqu’à ce que vous réactiviez l’option.

L’intervalle quotidien n’est pas modifiable.

Upload File

Téléversez des documents (PDF, Word, PowerPoint, Excel/CSV) et plus encore ; les images numérisées sont traitées par OCR. Le texte est extrait et indexé automatiquement. Taille maximale : 32 Mo, ou 1 Mo pour les fichiers texte (p. ex. txt, md, csv, json). Si un fichier texte est plus volumineux, divisez-le en parties plus petites et importez-les séparément.

Shopify MCP

Connectez votre boutique Shopify afin que l’IA puisse répondre aux questions en s’appuyant sur votre catalogue de produits à jour, les détails des produits et les politiques de la boutique. Collez l’URL de votre boutique pour configurer la connexion. En arrière-plan, Quickchat configure ainsi une action personnalisée de type Shopify MCP. Vous pouvez également la gérer depuis Actions & MCPs. Consultez Actions personnalisées. Vous y découvrirez aussi pourquoi le statut de commande nécessite une action distincte.

Articles Intercom

Importez en masse tous les articles de votre centre d’aide Intercom connecté. Intercom doit d’abord être connecté sous Applications externes → Intercom. Une nouvelle exécution de l’import synchronise les articles nouveaux et mis à jour.

YouTube

Collez une URL YouTube pour importer la transcription de la vidéo en tant qu’article. Cette option est utile pour les chaînes de tutoriels et les démonstrations de produits que vous ne souhaitez pas réécrire manuellement.

Maintenir les articles URL à jour

Les articles URL restent liés à leur page source, ce qui vous permet de les garder à jour sans réimporter manuellement. Il existe deux façons de procéder : Auto-refresh, qui s’exécute automatiquement chaque jour, et l’actualisation manuelle, que vous déclenchez à la demande. Les deux remplacent le contenu de l’article par la dernière version de la page en ligne, puis réentraînent automatiquement votre Agent IA.

Auto-refresh

Activez Auto-refresh pour un article URL et Quickchat revérifie sa page source une fois par jour, en mettant à jour l’article automatiquement dès que la source change. Cela permet de garder les connaissances issues d’URL synchronisées sans aucune intervention manuelle.

Note

L’actualisation automatique des URL est disponible avec les forfaits payants.

Comment l’activer

• Un seul article: ouvrez l’article et activez le commutateur Auto-refresh dans le panneau de métadonnées à droite, ou utilisez la bascule Auto-refresh URL sur la ligne de l’article dans la liste.
• Depuis le menu de la ligne: cliquez sur le menu ”…” sur une ligne d’article URL et choisissez Auto-refresh de l’URL.
• En masse: sélectionnez plusieurs articles URL à l’aide des cases à cocher et cliquez sur Auto-refresh des URLs (N) dans la barre d’outils de sélection.

Tant qu’Auto-refresh est activé, l’article est maintenu synchronisé avec sa source et son contenu devient en lecture seule, avec la bannière “Cet article est synchronisé avec sa source. Désactivez l’auto-refresh pour le modifier.” Pour modifier le texte vous-même, cliquez sur Désactiver et modifier (ou désactivez Auto-refresh). La modification d’un article URL désactive Auto-refresh automatiquement, de sorte qu’une actualisation ultérieure n’écrase jamais vos modifications.

Le champ Dernière actualisation dans le panneau de métadonnées indique la dernière fois que l’article a été mis à jour à partir de sa source.

Si une actualisation échoue, la dernière version enregistrée reste en ligne et votre Agent IA continue de l’utiliser. Consultez Si l’actualisation d’une URL échoue pour en savoir plus sur le statut, la raison et les nouvelles tentatives.

Actualisation manuelle

Pour récupérer le dernier contenu dès maintenant, sans attendre la vérification quotidienne :

• Un seul article: ouvrez-le et cliquez sur Actualiser l’URL manuellement dans le panneau de métadonnées, ou choisissez Actualiser l’URL manuellement dans le menu ”…” de la ligne.
• En masse: sélectionnez des articles URL et cliquez sur Actualiser les URLs manuellement (N), ou utilisez Actualiser toutes les URLs en haut à droite pour récupérer d’un coup tous les articles issus d’URL.

Une actualisation manuelle remplace vos modifications manuelles par la page en ligne, c’est pourquoi Quickchat vous demande de confirmer avant d’écraser les articles que vous avez modifiés. L’actualisation en masse couvre jusqu’à 1 000 articles URL à la fois.

Conseils pour construire une Base de connaissances efficace

Chaque article texte, URL ou PDF doit être autonome et complet sur son sujet. Une base bien structurée fournit à l’Agent le contexte dont il a besoin.

Lisez les conseils ci‑dessous pour mettre votre Agent sur les bons rails :

Étapes pour construire et affiner votre Base de connaissances

1. Clarifiez l’objectif
   Définissez le rôle de l’Agent et les types de questions à couvrir. Classez vos connaissances par catégories selon les besoins des utilisateurs.

   Exemple Agent e‑commerce :

   • Navigation & Achat : détails produits, comparaisons, FAQ
   • Paiement : moyens de paiement, codes promo, taxes
   • Livraison : expédition, modification de commande, suivi

   Exemple Agent prêts étudiants :

   • Avant la demande : éligibilité, conditions
   • Demande : guides, termes, pas‑à‑pas
   • Après diplôme : échéanciers, reports

2. Assurez la qualité des données
   La qualité des réponses dépend de la qualité des contenus téléversés. Concentrez‑vous sur :

   • Lisibilité : retirez l’inutile (redondances, tableaux non pertinents, en‑têtes superflus)
   • Pertinence : visez les questions fréquentes et attentes des utilisateurs
   • Cohérence : évitez contradictions et informations obsolètes (dates, prix)
   • Texte uniquement : les images ne sont pas prises en charge, mettez les infos clés en texte

3. Priorisez la clarté
   Des paragraphes logiques, concis et faciles à suivre.

4. Soyez exhaustif
   Fournissez suffisamment de détails pour gérer des demandes complexes.

5. Préférez des réponses complètes au format Q/R
   L’IA extrait les informations pertinentes. Inutile de multiplier des paires question‑réponse.

6. Intégrez des URLs dans le texte
   Ajoutez des liens dans chaque article. Même lors d’un import par URL, lier les produits ou formulaires améliore l’utilisabilité.

   Exemple :
   « Pour annuler une commande, remplissez ce formulaire : https://example.com/cancel-order. »

7. Testez en profondeur
   Simulez des interactions, repérez les lacunes et ajustez.

Problèmes fréquents

• L’IA ignore des liens ou ne les inclut pas : assurez‑vous que les liens sont présents dans le texte.
• Informations répétées : évitez les doublons entre articles.
• Détails manquants : créez des articles dédiés pour les cas spécifiques (critères, cas particuliers).
• Dates ou prix incorrects : vérifiez et mettez à jour régulièrement.

La construction d’une Base de connaissances efficace est itérative. Partez d’objectifs clairs, structurez logiquement et testez pour affiner la performance de votre Agent.

Note

Besoin d’aide ou d’intégrations sur mesure ? Écrivez‑nous à contact@quickchat.ai.

Recherche

La Recherche vous permet de retrouver rapidement des articles en parcourant leurs titres et contenus.

Utilisation

1. Saisissez des mots‑clés dans la barre Search en haut de l’interface Knowledge Management.
2. Les résultats s’actualisent instantanément en listant les articles contenant le texte saisi.

Sélection multiple et suppression en masse

Gérez facilement plusieurs articles à la fois.

Sélection multiple

1. Ouvrez la liste de la Base de connaissances
2. Cliquez sur « … » à côté d’un Article puis Select
3. Cochez les cases à gauche des Articles à sélectionner
4. Les Articles restent surlignés pour les actions suivantes

Suppression en masse

1. Après sélection, cliquez sur Delete en bas
2. Confirmez pour supprimer définitivement les Articles choisis

Tags

Les tags vous aident à organiser la Base de connaissances et permettent à l’Agent IA de cibler les articles à consulter pour une question donnée. Ils apparaissent sur chaque ligne d’article ainsi que sous forme de filtre en haut de la liste.

Il y a deux façons d’ajouter des tags à un article :

• Manuellement : ouvrez un article et utilisez + Add Tag dans le panneau de métadonnées à droite.
• Auto-tag with AI : cliquez sur Auto-tag with AI dans ce même panneau. Quickchat lit l’article et suggère des tags en fonction de son contenu. Pratique pour les bases importées en masse (Sitemap, All Pages, Intercom), où taguer des centaines d’articles à la main n’est pas réaliste.

Utilisez le filtre Tags de la barre d’outils pour ne garder que les articles correspondant à un ou plusieurs tags.

Comment vos changements sont mis en ligne

Il n’y a aucune étape de réentraînement ni aucun bouton à cliquer. Chaque modification de la Base de connaissances est traitée automatiquement en arrière‑plan, article par article. Seuls les articles que vous avez réellement touchés sont retraités, de sorte que le reste de votre Base de connaissances continue de répondre aux questions pendant tout ce temps.

Cela vaut pour toutes les façons dont le contenu change : ajout ou modification d’un article, suppression, import d’un site web ou d’un fichier, actualisation manuelle d’une URL, et actualisation automatique quotidienne.

Statut d’un article

Chaque ligne de la liste de la Base de connaissances possède une colonne Status :

Status	Ce que cela signifie
Pending	En file d’attente, en attente de traitement.
Processing	En cours de traitement.
Ready	En ligne. Votre Agent IA utilise cet article.
Failed	Le traitement n’a pas abouti. Voir « Si un article échoue » ci‑dessous.
Échec de l’actualisation	Votre AI Agent utilise toujours la dernière version enregistrée.

Les statuts se mettent à jour tout seuls : inutile de recharger la page.

Tant qu’un traitement est en cours, le haut de l’application affiche « N articles still processing ». Le message disparaît une fois tout terminé. La plupart des articles passent à Ready en quelques secondes ; les imports volumineux prennent plus de temps, car les articles sont traités par lots.

Quand un article est en ligne

Dès qu’un article affiche Ready, il est en ligne partout à la fois : votre widget déployé, chaque canal connecté, l’API et AI Preview. Il n’y a ni étape de publication ou de déploiement distincte, ni copie brouillon de votre Base de connaissances entre vous et votre Agent.

Attention

Comme rien n’est mis en attente, une modification atteint votre Agent IA en ligne dès que son traitement est terminé. Si votre Agent est en production, relisez le contenu de l’article avant d’enregistrer, puis relancez un dataset de simulation pour confirmer que le changement n’a pas provoqué de régression.

Si l’actualisation d’une URL échoue

Un article URL au statut Échec de l’actualisation reste en ligne avec la dernière version enregistrée par Quickchat. Survolez le statut pour savoir pourquoi la source n’a pas pu être actualisée, par exemple en raison d’une page indisponible, d’une connexion requise, d’une redirection vers un autre site ou d’un contenu illisible.

Quickchat poursuit ses tentatives en cas d’échec temporaire. Si les tentatives d’actualisation de la source continuent d’échouer pendant 14 jours, les vérifications automatiques s’arrêtent pour éviter de récupérer à plusieurs reprises une page indisponible de façon permanente. Après avoir corrigé la source, choisissez Actualiser l’URL manuellement. Une actualisation réussie supprime l’état d’échec et relance les vérifications automatiques. Vous pouvez également choisir à nouveau Auto-refresh de l’URL pour redémarrer la période de nouvelles tentatives.

Si un article échoue

Un article en Failed n’est tout simplement pas utilisé par votre Agent IA. Le reste de votre Base de connaissances n’est pas affecté, et votre Agent continue de répondre à partir de tout ce qui est en Ready.

La plupart des échecs sont temporaires, et Quickchat relance le traitement automatiquement pour vous, si bien que le problème se résout généralement tout seul. Si vous ne voulez pas attendre, cliquez sur Retry à côté du message « N failed to process » en haut de l’application pour relancer immédiatement tous les articles en échec.

Si un article échoue systématiquement, le problème vient généralement du contenu source : une page vide, un fichier dont aucun texte ne peut être extrait, ou une URL qui ne répond plus. Ouvrez l’article pour vérifier ce qui a réellement été importé, ou réimportez‑le depuis une source fonctionnelle. Si l’échec persiste, écrivez‑nous à contact@quickchat.ai.

Tout le reste prend effet immédiatement

Seul le contenu de la Base de connaissances passe par un traitement. Les paramètres comme Identity, AI Personality, Languages, Actions, les réponses de l’Inbox, Insights et Conversation Rating s’appliquent dès que vous les enregistrez.