---
title: Bases de connaissances
description: >-
  Créez une base de connaissances depuis des fichiers, des URL, un site exploré ou du texte, testez ses réponses, mesurez-la et tenez-la à jour.
---
Une base de connaissances regroupe les contenus qu'un agent peut consulter pendant une conversation : vos politiques, vos pages produits, vos grilles tarifaires, vos articles d'aide. Vous la créez et la testez sous **Knowledge Bases** (Bases de connaissances), puis vous la confiez à un agent avec l'[outil Knowledge Base](/fr/build/tools/knowledge-base).

Ne mélangez pas les deux usages. Les informations sur votre entreprise ont leur place ici. Ce que l'agent apprend sur une personne en particulier relève de la [Mémoire](/fr/build/memory).

## Ce qu'elle contient

Une base de connaissances se compose de sources : des fichiers, des URL ou du texte.

- **Fichiers.** Documents, JSON et feuilles de calcul au format Excel ou CSV.
- **URL.** Ajoutez des pages une par une, ou activez **Crawl website** (Explorer le site web), indiquez une **Website URL** (URL du site web) et choisissez les pages découvertes à ingérer. Vous pouvez ajouter un Google Doc via son **Google Doc URL** (URL du Google Doc). Une page doit être accessible publiquement pour pouvoir être récupérée.
- **Texte.** Collez directement votre contenu. Le Markdown est pris en charge.

La liste **Sources** indique ce qui compose actuellement la base de connaissances.

## Créer une base de connaissances

1. Sous **Knowledge Bases**, choisissez **Add Resource** (Ajouter une ressource).
2. Dans **Choose your source** (Choisissez votre source), sélectionnez **Text** (Texte), **URL**, **File** (Fichier) ou **Google Doc**. Un clic sur une carte vous fait passer directement à l'étape suivante.
3. Donnez un **Name** (Nom) à la base de connaissances et configurez la source. Pour **URL**, choisissez un **Mode** : **URLs** ajoute les pages une par une (**Add URL**, Ajouter une URL, en met une autre en file d'attente), avec une option **Auto-update** (Mise à jour automatique) qui les actualise toutes les 6, 12 ou 24 heures ; **Crawler** (Robot d'exploration) part d'une **Website URL** et découvre les pages accessibles depuis celle-ci. Un Google Doc doit être partagé de sorte que toute personne disposant du lien puisse le consulter.
4. Choisissez **Create** (Créer). Avec **Crawler**, choisissez plutôt **Discover** (Découvrir), sélectionnez les pages à inclure, puis lancez **Crawl** (Explorer).
5. L'assistant affiche le traitement du contenu, puis ouvre **Test your knowledge base** (Testez votre base de connaissances) pour que vous puissiez poser une première question.

## Ajouter des données

**Add data** (Ajouter des données) enrichit une base de connaissances existante. Chaque ajout complète ou remplace le contenu :

- **Add to existing data** (Ajouter aux données existantes) conserve le contenu enregistré et y ajoute le nouveau contenu.
- **Replace** (Remplacer) supprime tout le contenu existant ainsi que son index de recherche, puis enregistre le nouveau contenu à sa place. L'application vous demande une confirmation, car cette action est irréversible.

Les sources URL peuvent également récupérer à nouveau leur contenu selon un calendrier défini : une base de connaissances construite à partir de votre site web suit ainsi son évolution.

## Vérifier que l'ingestion a fonctionné

L'ajout d'une source lance une tâche d'ingestion. **Live ingestion** (Ingestion en direct) affiche les tâches en cours, et **Ingestion history** (Historique d'ingestion) les conserve toutes, y compris les pages explorées en échec, comptabilisées en pages réussies et pages en échec. Lorsqu'une tâche échoue, une bannière **Ingestion failed** (Échec de l'ingestion) vous le signale et **Retry ingestion** (Relancer l'ingestion) la relance.

## Tester ses réponses

**Test** (Tester) propose deux approches.

- **Test via chat** (Tester par chat). Posez des questions comme le ferait un appelant. Les réponses s'affichent au fil de l'eau avec leurs sources, ce qui vous permet de voir d'où provient chaque affirmation, et des suggestions de questions montrent ce à quoi la base de connaissances sait répondre.
- **Semantic search** (Recherche sémantique). Recherchez directement des passages. Sous **Retrieval options** (Options de récupération), **Fast search** (Recherche rapide) contourne le modèle de réponse et renvoie uniquement le texte correspondant, sans réponse générée ni sources : c'est le moyen le plus rapide de vérifier qu'un passage figure bien dans la base.

Effectuez vos tests ici avant de connecter la base de connaissances à un agent. Un agent ne peut pas répondre mieux que sa base de connaissances.

## La mesurer

Au-delà des vérifications ponctuelles, **Evaluation** (Évaluation) soumet un jeu de questions fixe à la base de connaissances et conserve chaque exécution.

1. Créez un jeu de données de questions. Ajoutez-les une par une, importez un fichier CSV comportant les colonnes `question` et `expected_answer` (5 Mo maximum), ou générez-les à partir de la base de connaissances.
2. Créez une évaluation et lancez une exécution.
3. Consultez **Run history** (Historique des exécutions) après avoir modifié les sources.

Relancez le même jeu de questions après chaque modification importante : une exécution dont les résultats se dégradent vous indique quelle modification annuler.

## Vider et supprimer

**Clear** (Vider) efface le contenu d'une base de connaissances tout en conservant la base elle-même, prête à recevoir de nouvelles données. **Delete** (Supprimer) la supprime entièrement. Vous pouvez également supprimer plusieurs bases de connaissances à la fois depuis la liste.

## Voir aussi

- [Outil Knowledge Base](/fr/build/tools/knowledge-base)
- [Mémoire](/fr/build/memory)
- [Évaluations](/fr/test-and-improve/evaluations)
