# Bases de connaissances

> Range ton site, tes fichiers et tes réponses dans une base de connaissances, puis relie-la à tes agents pour qu'ils répondent avec tes vrais faits.

Source: https://docs.whatsetter.com/fr/dashboard/knowledge-base/

Une base de connaissances, c'est ce que ton agent lit avant de répondre à un
lead : les pages de ton site, tes fichiers et les réponses que tu écris
toi-même. Tu crées une base une fois, puis tu la relies à un ou plusieurs
agents. Tout se trouve sous **Connaissances** dans le menu.

## Ce qu'est une base de connaissances

Ouvre **Connaissances** dans le menu. Chaque ligne est une base : un classeur
qui porte un nom. Une base contient trois sortes de sources.

| Source | Ce que c'est |
|---|---|
| **Un site web** | Ses pages. Elles sont lues quand tu ajoutes le site, puis relues environ une fois par semaine avec un forfait payant. Les autres pages du site ne sont lues que si tu les choisis. |
| **Un fichier** | Une brochure, une grille de tarifs, un règlement. |
| **Tes réponses** | Des questions et des réponses que tu écris à la main. |

Une base est reliée à un ou plusieurs agents, qui répondent à partir d'elle.
Un agent répond à partir d'une seule base à la fois.

Si tu as connu l'ancien tableau de bord : la page s'appelait Base de
connaissances et une base contenait des Documents, des Sites web et des
listes de Questions & réponses. Les documents sont maintenant des fichiers.
Les listes de questions et réponses sont devenues **Tes réponses** : une par
base, sans rien à créer ni à nommer. « Resynchroniser » s'appelle maintenant
**Relire le site**, et connecter un agent se dit maintenant le relier. Les
campagnes s'appellent maintenant des agents.

## Ce que montre la page Connaissances

Ouvre **Connaissances**. Le haut de la page compte tes bases. Chaque ligne
montre quatre choses :

- **Base** : son nom.
- **Contient** : ce qu'elle contient, par exemple « 1 site · 2 fichiers · 12 réponses », ou **Vide**.
- **Agents** : les agents qui répondent à partir d'elle.
- **État** : un mot, comme **Prête** ou **Lecture**.

Les bases sont regroupées. **À vérifier** vient en premier : les bases
illisibles, vides ou pas à jour alors qu'un agent qui n'est pas un brouillon
répond à partir d'elles. Viennent ensuite les bases reliées à un agent,
celles dont l'agent est en service d'abord. Les bases qu'aucun agent
n'utilise sont repliées sous **Sans agent** en bas de page : clique sur
**Afficher**. Au-delà de 6 bases, un champ de recherche cherche dans les noms
des bases, des sources et des agents.

Clique sur une ligne pour ouvrir la base : son **Contenu** à gauche, ses
**Agents reliés** à droite.

## Créer une base de connaissances

1. Ouvre **Connaissances** et clique sur **Nouvelle base**. Si tu n'as encore aucune base, le bouton indique **Créer une base**.
2. Saisis le **Nom de la base**, par exemple le nom de ton entreprise. Il peut contenir jusqu'à 120 caractères.
3. Clique sur **Créer la base**.

Tu arrives dans la nouvelle base. Elle est vide tant que tu n'as pas ajouté
de source.

Créer une base demande un forfait payant et la permission
**Modifier les agents et leurs prompts**. Chaque forfait comprend un nombre
de bases : 1 avec Starter, 3 avec Business, 10 avec Scale. Une fois ce nombre
atteint, la fenêtre affiche un message comme
**Ton forfait comprend 1 base de connaissances.** et un lien
**Voir les forfaits**. Avec le forfait gratuit, le bouton porte un cadenas et
ouvre **Créer et remplir une base**, qui mène aux forfaits.

## La base créée avec ton agent

Ouvre **Connaissances** : si tu as créé un agent à partir de ton site, une
base est déjà là. Les pages lues pendant la création de l'agent ont été
rangées dans une base, et l'agent y a été relié. C'est pareil pour un agent
créé à partir d'un document. Si ton équipe avait déjà une base qui contenait
le même site, le nouvel agent a été relié à cette base : rien n'est lu deux
fois.

La création de l'agent reste rapide : elle lit la page d'accueil et jusqu'à
cinq pages principales, pas tout le site. Pour que ton agent en lise
d'autres, vois [Ajouter d'autres pages d'un site](#ajouter-dautres-pages-dun-site).

Cela se passe aussi avec le forfait gratuit. La page indique alors que la
base de ton agent a été remplie à sa création. Tu peux l'ouvrir, voir ses
pages et cliquer sur **Relire le site**. Pour créer une autre base, ou pour
ajouter un site, un fichier ou tes réponses, il faut un forfait payant.

Vois [Créer ton agent IA](/fr/getting-started/agent/).

## Ajouter un site web

1. Ouvre **Connaissances**, ouvre ta base et clique sur **Ajouter**.
2. Sous **Que veux-tu ajouter ?**, choisis **Un site web**.
3. Saisis l'**Adresse du site**, avec ou sans `https://`.
4. Clique sur **Lire ce site**.

Ce qui est lu :

- L'adresse que tu as donnée d'abord, puis les pages trouvées sur le même domaine.
- Jusqu'au nombre de pages par site de ton forfait : 50, 150 ou 200. La fenêtre affiche le tien.
- Le texte seulement. Les images, les PDF et les autres fichiers du site sont ignorés.

La ligne du site affiche **Lecture** avec le nombre de pages restantes, puis
**Prête**. Garde une page **Connaissances** ouverte pendant la lecture. Si tu
la quittes, la lecture reprend à ton retour.

Deux messages peuvent t'arrêter. **Ce site est déjà dans tes connaissances.**
veut dire que la base contient déjà ce site.
**Ce site ne s'ouvre pas. Vérifie l'adresse.** veut dire que le site n'a pas
pu être joint.

## Ajouter un fichier

1. Ouvre **Connaissances**, ouvre ta base et clique sur **Ajouter**.
2. Choisis **Un fichier**.
3. Dépose le fichier dans la zone, ou clique sur la zone pour le choisir.
4. Clique sur **Ajouter le fichier**.

Formats acceptés : PDF, Word (.docx, .doc), texte (.txt, .md), HTML et CSV.
Un fichier à la fois, 50 Mo au plus.

La ligne du fichier affiche **Lecture** pendant qu'il est lu, puis **Prête**.
La page se met à jour toute seule. Un autre format est refusé avec
**Ce format n'est pas lu. Choisis un PDF, un fichier Word, texte, HTML ou CSV.**
Un fichier trop lourd est refusé avec **Ce fichier dépasse 50 Mo.**

Clique sur un fichier pour ouvrir son panneau. **Ouvrir** affiche un fichier
PDF, HTML, texte ou CSV dans le navigateur. **Télécharger** enregistre
n'importe quel fichier. Il n'y a pas de bouton pour le modifier : pour mettre
un fichier à jour, retire-le et ajoute la nouvelle version.

## Ajouter une réponse que tu écris

1. Ouvre **Connaissances**, ouvre ta base et clique sur **Ajouter**.
2. Choisis **Une réponse que tu écris**.
3. Remplis **La question**, par exemple « Y a-t-il un parking ? », puis **Ta réponse**.
4. Clique sur **Enregistrer la réponse**.

Sers-t'en pour une question qu'on te pose souvent. Toutes les réponses d'une
base apparaissent comme une seule source appelée **Tes réponses**, avec leur
nombre. Tes agents peuvent utiliser une réponse dès qu'elle est enregistrée.

Limites : une question contient jusqu'à 1 000 caractères, une réponse jusqu'à
4 000, et une base contient jusqu'à 200 réponses avec tous les forfaits
payants. À ce moment-là, la fenêtre indique
**Tu as atteint 200 réponses, le maximum.**

## Modifier ou supprimer une réponse

Ouvre **Connaissances**, ouvre la base et clique sur **Tes réponses**. Le
panneau **Questions et réponses** les liste, la plus récente en premier.

- Le crayon (**Modifier**) ouvre la question et la réponse. Change-les et clique sur **Enregistrer**. Tes agents utilisent le nouveau texte aussitôt.
- La corbeille (**Supprimer**) demande **Supprimer cette réponse ?**. Clique sur **Supprimer** pour confirmer, ou sur **Garder**.
- **Nouvelle réponse** en ajoute une sans quitter le panneau, tant que la base n'a pas atteint 200 réponses.

Quand tu supprimes la dernière réponse d'une base, **Tes réponses** disparaît
de son contenu. La source revient avec la prochaine réponse que tu
enregistres.

## Relier une base à un agent

Deux endroits font la même chose.

Depuis la base : ouvre **Connaissances**, ouvre la base et regarde
**Agents reliés** à droite. Clique sur **Relier un agent**, coche un ou
plusieurs agents, puis clique sur le bouton qui indique **Relier 1 agent**,
avec ton propre nombre. Les agents sont regroupés sous **Actifs** et
**En pause**. Les brouillons sont derrière un lien en bas de la liste.

Depuis l'agent : ouvre **Agents**, clique sur ton agent, puis sur l'onglet
**Réglages** et la section **Connaissances**. Choisis une base dans la liste
**Base de connaissances** et clique sur **Enregistrer**.

Un agent répond à partir d'une seule base à la fois. Si l'agent que tu
choisis utilise déjà une autre base, la fenêtre te prévient :
**Cet agent quittera la base qu'il utilise aujourd'hui.** Plusieurs agents
peuvent partager la même base.

## Délier une base d'un agent

Ouvre **Connaissances**, ouvre la base et, dans **Agents reliés**, clique sur
l'icône **Délier** sur la ligne de l'agent. Ou ouvre **Agents**, clique sur
ton agent, puis sur l'onglet **Réglages** et la section **Connaissances**,
choisis **Aucune** dans la liste **Base de connaissances** et clique sur
**Enregistrer**.

La base et son contenu ne bougent pas : seul le lien disparaît. L'agent n'a
alors plus de connaissances. Il répond à partir de son prompt seul, et ses
réglages indiquent qu'il n'est relié à aucune base. Tu peux le relier à une
autre base quand tu veux.

Une base qu'aucun agent n'utilise passe dans le groupe **Sans agent**, en bas
de la page **Connaissances**.

## Comment ton agent utilise la base dans une conversation

Il n'y a rien à activer. Dès qu'une base est reliée (ouvre **Agents**, ton
agent, **Réglages**, puis **Connaissances** pour vérifier), ton agent s'en
sert chaque fois qu'il répond à un message d'un lead.

- Il cherche dans la base avec les derniers messages du lead et garde les passages qui correspondent le mieux, 4 au plus.
- Ces passages lui sont remis comme matière pour les faits, avec la page ou le fichier d'où ils viennent.
- Ton contenu peut être écrit dans une autre langue que la conversation : l'agent continue de répondre dans la langue du lead.
- Quand rien dans la base ne correspond, il répond à partir de son prompt seul.
- Si la base est injoignable un instant, la réponse part quand même.

Le premier message et les relances automatiques ne cherchent pas dans la
base. Une page, un fichier ou une réponse sert dès qu'il a été lu. Tu peux
vérifier ce que répond ton agent dans son onglet **Tester** : vois
[Tester ton agent](/fr/dashboard/playground/).

## Ce que veulent dire les états

Sur la page **Connaissances** et dans une base, chaque ligne porte un état.

| État | Signification |
|---|---|
| **Lecture** | Un site ou un fichier est en cours de lecture. Pour un site, le nombre de pages restantes suit. |
| **Prête** | La source a été lue et tes agents peuvent s'en servir. |
| **Illisible** | La lecture a échoué. Ouvre la ligne pour voir pourquoi. |
| **Vide** | Rien n'a encore été lu. Une base sans source est vide aussi. |
| **Pas à jour** | Le site n'a pas été relu en entier depuis plus de 30 jours, alors qu'un agent qui n'est pas un brouillon répond à partir de la base. |
| **Sans agent** | Affiché sur une base : son contenu est prêt, mais aucun agent n'y est relié. |

Un site passe à **Prête** dès qu'une de ses pages a été lue, même si d'autres
pages ont échoué. Une base prend l'état de ses sources : **Lecture** tant que
l'une d'elles est lue, **Illisible** quand l'une d'elles a échoué.

## Une source est marquée Illisible

Ouvre **Connaissances**, ouvre la base et clique sur la ligne marquée
**Illisible**. Le panneau donne la raison.

| Message | Que faire |
|---|---|
| **Le site ne répond pas. Vérifie son adresse, puis relis-le.** | Vérifie que le site est en ligne, puis clique sur **Relire** sur sa ligne. |
| **Aucun texte lisible n'a été trouvé sur ces pages.** | Les pages ne contiennent pas de texte, par exemple seulement des images. Ajoute ce contenu sous forme de fichier ou de réponses. |
| **La lecture a échoué. Relis la source pour réessayer.** | Pour un site, clique sur **Relire**. Pour un fichier, retire-le et ajoute-le de nouveau. |

Dans un site à l'état **Prête**, une page seule peut quand même indiquer
**Page illisible** dans la liste des pages. Les autres pages servent
normalement.

## Mettre à jour un site web

Ouvre **Connaissances**, ouvre la base et clique sur le site. Son panneau
indique quand a eu lieu la dernière lecture complète.

- Chaque semaine, un site est relu tout seul quand sa base est reliée à un agent actif ou en pause et que ton équipe a un forfait payant. Cette relecture couvre les pages déjà connues. Elle ne cherche pas de nouvelles pages.
- **Relire le site**, en bas du panneau, relit tout de suite les pages que ton agent a déjà. Il n'en ajoute pas : les nouvelles pages du site se choisissent avec **Voir les autres pages du site**.
- Une page dont le texte n'a pas changé garde ce qui en avait déjà été appris.

Avec le forfait gratuit, il n'y a pas de relecture hebdomadaire : clique
toi-même sur **Relire le site**. Quand un site n'a pas été relu depuis plus
de 30 jours alors qu'un agent l'utilise, sa ligne affiche **Pas à jour** avec
un bouton **Relire**.

## Ajouter d'autres pages d'un site

Un site ne grandit jamais tout seul dans ta base : seules les pages que ton
agent a déjà sont relues. Pour qu'il en lise d'autres, comme une page de
services ou un nouvel article, c'est toi qui choisis. Il faut un forfait
payant.

1. Ouvre **Connaissances**, ouvre la base et clique sur le site. Le haut du panneau dit combien de pages ton agent a lues, par exemple « Ton agent a lu 1 page de ce site. »
2. Clique sur **Voir les autres pages du site**. Les pages du site sont cherchées une fois, puis listées sous **Autres pages du site**.
3. Coche les pages que ton agent doit lire. Les pages légales, de compte ou d'offres d'emploi sont décochées au départ, avec la mention **Page légale, de compte ou d'emploi** : tu peux quand même les cocher. **Tout cocher** et **Tout décocher** vont plus vite.
4. Clique sur **Lire ces pages** en bas du panneau. Le bouton dit combien de pages tu as cochées.

Le panneau affiche « 14 pages ajoutées : ton agent les lit maintenant. » La
ligne du site passe à **Lecture**, puis à **Prête**. Les pages ajoutées sont
relues chaque semaine avec les autres.

- La liste reste en mémoire : la rouvrir ne recherche pas le site. **Chercher à nouveau** le recherche, par exemple après la mise en ligne de nouvelles pages.
- Ton forfait fixe le nombre de pages par site (50, 150 ou 200). Si tu en coches plus qu'il n'en reste, un message le dit et le bouton attend que tu en décoches.
- **Aucune autre page trouvée : ton agent a déjà toutes les pages de ce site.** veut dire qu'il n'y a rien à ajouter.

## Ignorer une page d'un site

Ouvre **Connaissances**, ouvre la base et clique sur le site. Le panneau liste
les **Pages que ton agent lit**, chacune avec un interrupteur. Au-delà de 8 pages, un champ
**Chercher une page** apparaît.

- Éteins l'interrupteur d'une page : tes agents cessent aussitôt de s'en servir, et la page indique **Page ignorée**.
- Rallume-le : la page indique **En attente de lecture**, puis sert de nouveau une fois lue.
- Une page ignorée le reste quand le site est relu, par toi ou par la relecture hebdomadaire.

Sers-t'en pour les pages que ton agent ne doit pas citer, comme une ancienne
offre ou des mentions légales. **Ouvrir le site** ouvre le site dans un
nouvel onglet.

## Retirer un site ou un fichier

Ouvre **Connaissances**, ouvre la base et clique sur le site ou sur le
fichier. En bas du panneau, clique sur **Retirer ce site** ou
**Retirer ce fichier**, puis confirme avec **Retirer**. **Garder** annule.

Tes agents oublient aussitôt cette source : ses pages ou son contenu ne
servent plus dans les réponses. Pour un fichier, la copie enregistrée est
supprimée aussi.

> **C'est irréversible**
Tu peux ajouter de nouveau le site ou le fichier, mais un site est alors relu
depuis le début, et les pages que tu avais ignorées reviennent.

Retirer une source libère une place dans le compte de sites ou de fichiers
que ton forfait prévoit pour cette base.

## Renommer ou supprimer une base

Ouvre **Connaissances** et ouvre la base.

- Renommer : clique sur le nom de la base en haut, saisis le nouveau et appuie sur Entrée. Tu peux aussi ouvrir **Autres actions**, le bouton à trois points, et choisir **Renommer**.
- Supprimer : ouvre **Autres actions**, choisis **Supprimer la base** et confirme.

> **Supprimer une base est irréversible**
Ses sources sont effacées définitivement : sites, fichiers et réponses. Les
agents qui y étaient reliés sont déliés et n'ont plus de connaissances tant
que tu ne les relies pas à une autre base. La fenêtre de confirmation te le
dit avant que tu confirmes.

## Limites par forfait

Ouvre **Abonnement**, puis **Comparer en détail**, pour retrouver ces
chiffres dans l'application.

| Forfait | Bases de connaissances | Sites web par base | Pages lues par site | Fichiers par base | Réponses par base |
|---|---|---|---|---|---|
| Starter | 1 | 1 | 50 | 3 | 200 |
| Business | 3 | 3 | 150 | 5 | 200 |
| Scale | 10 | 10 | 200 | 10 | 200 |

Avec le forfait gratuit, tu ne peux ni créer une base ni ajouter une source :
les boutons **Nouvelle base** et **Ajouter** portent un cadenas et mènent aux
forfaits. Tu gardes la base remplie à la création de ton agent, et tu peux
relire son site.

Quand une limite est atteinte, la fenêtre **Ajouter** le dit, par exemple
**Ton forfait comprend 1 site.**, avec un lien **Voir les forfaits**. Vois
[Abonnement & facturation](/fr/dashboard/billing/).

## Qui peut modifier les connaissances

Toute personne qui a la permission **Voir les agents** peut ouvrir
**Connaissances** et lire ce que contient une base. Créer une base, ajouter
ou retirer une source, relire un site et relier des agents demandent la
permission **Modifier les agents et leurs prompts**.

- **Propriétaire**, **Admin** et **Éditeur** peuvent tout modifier sur cette page.
- Un **Lecteur** consulte seulement : les boutons qui modifient quelque chose ne sont pas affichés.
- Un **Répondant** ne voit pas **Connaissances** dans le menu.

Un jeu de permissions sur mesure suit les deux mêmes règles. Vois
[Équipe & rôles](/fr/dashboard/team/).

## Les connaissances dans l'API et avec un assistant IA

- `GET /knowledge-bases` liste tes bases, leurs sources et les agents reliés à chacune.
- `GET /knowledge-bases/{id}/search` renvoie les passages qu'un agent reçoit pour un message, avec la même recherche que lorsqu'il répond.
- Les réponses de **Tes réponses** s'ajoutent, se corrigent et se retirent avec `POST`, `PATCH` et `DELETE` sur `/knowledge-bases/{id}/answers`. Les sites et les fichiers s'ajoutent ici, dans le dashboard.

Vois [API : bases de connaissances](/fr/developers/guides/knowledge/).

## Voir aussi

- [Mes Styles](/fr/dashboard/styles/)
- [Le prompt de ton agent](/fr/dashboard/prompt/)
- [Tester ton agent](/fr/dashboard/playground/)
- [Agents](/fr/dashboard/agents/)
