> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volubile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Base de données (RAG)

> La **Base de données** (RAG, Retrieval-Augmented Generation) enrichit vos agents Volubile avec vos propres connaissances. Importez des documents, indexez des pages web, puis affinez le contenu fragment par fragment pour des réponses précises et à jour.

<Frame>
  <img src="https://mintcdn.com/weengage/_3vYDlD6yxxxMu7I/images/rag/volubile-rag.png?fit=max&auto=format&n=_3vYDlD6yxxxMu7I&q=85&s=7188ee797917fadea23cb4270d7c3575" alt="Base de données (RAG)" width="1568" height="765" data-path="images/rag/volubile-rag.png" />
</Frame>

## Vue d'ensemble

La section **Base de données**, accessible depuis le menu latéral, centralise les connaissances mises à disposition de vos agents. Elle s'organise en deux sources complémentaires :

| Source        | Description                                                                             |
| ------------- | --------------------------------------------------------------------------------------- |
| **Documents** | Fichiers que vous importez (PDF, DOCX, PPTX, XLSX, CSV).                                |
| **Pages web** | Pages de sites web indexées automatiquement par crawl, avec rafraîchissement optionnel. |

Chaque source est découpée en **fragments** : ce sont les extraits de texte que l'agent recherche et cite pour formuler ses réponses.

<Note>
  Une seule base de connaissances est partagée à l'échelle du client. Les agents y puisent les informations dont ils
  ont besoin selon leur configuration.
</Note>

## Documents

### Importer un fichier

Déposez votre fichier dans la zone prévue à cet effet, ou cliquez dessus pour parcourir votre ordinateur.

<Frame>
  <img src="https://mintcdn.com/weengage/_3vYDlD6yxxxMu7I/images/rag/volubile-rag-documents.png?fit=max&auto=format&n=_3vYDlD6yxxxMu7I&q=85&s=0482e0faf4152fc3a4b083b1421890de" alt="Import de documents dans la Base de données" width="1201" height="530" data-path="images/rag/volubile-rag-documents.png" />
</Frame>

| Spécification              | Description                                          |
| -------------------------- | ---------------------------------------------------- |
| **Formats pris en charge** | `PDF`, `DOCX`, `PPTX`, `XLSX`, `CSV`                 |
| **Taille maximale**        | 10 Mo par fichier                                    |
| **Limite de lignes**       | 10 000 lignes maximum pour les fichiers Excel et CSV |
| **Taille d'un fragment**   | 6 000 caractères maximum                             |

Une fois le fichier traité, il apparaît dans la liste **Documents indexés**, avec son nom, sa taille et sa date d'import. L'indexation peut prendre quelques instants : un indicateur de statut signale sa progression.

### Actions sur un document

Le menu <Icon icon="ellipsis-vertical" iconType="solid" /> à droite de chaque document donne accès aux actions suivantes :

| Action                   | Description                                                                       |
| ------------------------ | --------------------------------------------------------------------------------- |
| **Télécharger**          | Exporte le contenu du document au format Excel (limité à 10 000 enregistrements). |
| **Remplacer le fichier** | Importe un nouveau fichier à la place de l'actuel.                                |
| **Supprimer**            | Retire le document et tous ses fragments de la base.                              |

### Remplacer un fichier

Le remplacement réindexe entièrement le document à partir du nouveau fichier.

<Warning>
  Tous les fragments existants de ce document seront **supprimés** et remplacés par le contenu du nouveau fichier. Les
  modifications manuelles effectuées sur les fragments seront perdues.
</Warning>

<Tip>
  Si vous importez un fichier portant le même nom qu'un document déjà présent, Volubile vous propose de **remplacer**
  le document existant plutôt que d'en créer un doublon.
</Tip>

## Gestion des fragments

Cliquez sur un document pour ouvrir le panneau latéral et consulter ses **fragments**.

<Frame>
  <img src="https://mintcdn.com/weengage/_3vYDlD6yxxxMu7I/images/rag/volubile-rag-fragments.png?fit=max&auto=format&n=_3vYDlD6yxxxMu7I&q=85&s=7ee55557e7dfaa2be9048f3ba005ecba" alt="Gestion des fragments d'un document" width="672" height="1230" data-path="images/rag/volubile-rag-fragments.png" />
</Frame>

### Rechercher dans les fragments

Deux modes de recherche sont disponibles :

| Mode          | Description                                                                                                          |
| ------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Full-text** | Recherche textuelle classique sur le contenu des fragments.                                                          |
| **Vectoriel** | Recherche sémantique : les fragments les plus proches du sens de votre requête, classés par **score** de pertinence. |

### Modifier le contenu

Chaque fragment peut être géré individuellement :

| Action                                                    | Description                                                                |
| --------------------------------------------------------- | -------------------------------------------------------------------------- |
| **Ajouter**                                               | Le bouton **Ajouter** crée un nouveau fragment (jusqu'à 6 000 caractères). |
| **Éditer** <Icon icon="pen-to-square" iconType="solid" /> | Modifie le contenu du fragment en ligne.                                   |
| **Supprimer** <Icon icon="trash" iconType="solid" />      | Retire définitivement le fragment.                                         |

<Tip>
  Affiner manuellement les fragments est le meilleur moyen d'améliorer la qualité des réponses : reformulez,
  découpez ou enrichissez les extraits pour qu'ils correspondent aux questions réelles de vos utilisateurs.
</Tip>

## Pages web

En complément des fichiers, vous pouvez indexer le contenu de pages web. Saisissez une URL, puis cliquez sur **Ajouter**.

<Frame>
  <img src="https://mintcdn.com/weengage/_3vYDlD6yxxxMu7I/images/rag/volubile-rag-webpages.png?fit=max&auto=format&n=_3vYDlD6yxxxMu7I&q=85&s=e5eb1634257b2d88e8c966f92279673b" alt="Indexation de pages web" width="1224" height="357" data-path="images/rag/volubile-rag-webpages.png" />
</Frame>

### Configuration de la récupération

L'ajout d'une URL ouvre la fenêtre de configuration du crawl.

<Frame>
  <img src="https://mintcdn.com/weengage/_3vYDlD6yxxxMu7I/images/rag/volubile-rag-crawl-config.png?fit=max&auto=format&n=_3vYDlD6yxxxMu7I&q=85&s=da3efe29a92c7ff9c55a35ff653f86a6" alt="Configuration de la récupération de pages web" width="601" height="888" data-path="images/rag/volubile-rag-crawl-config.png" />
</Frame>

<Steps>
  <Step title="Titre de la source">
    Donnez un nom reconnaissable à la source web (obligatoire).
  </Step>

  <Step title="Root URL">
    L'URL racine du site. La découverte et l'ajout manuel d'URLs sont limités aux sous-chemins de ce root URL.
  </Step>

  <Step title="URLs à récupérer">
    Utilisez **Découvrir** pour détecter automatiquement les pages du domaine, ou ajoutez manuellement des
    sous-chemins. Maximum 100 URLs par source.
  </Step>

  <Step title="Rafraîchissement automatique">
    Activez une récurrence (**tous les jours**, **une fois par semaine** ou **une fois par mois**) pour que les pages
    soient ré-indexées régulièrement.
  </Step>
</Steps>

<Warning>
  Le rafraîchissement automatique réindexe **toutes** les pages de la source. Si vous avez modifié manuellement
  certains fragments issus de ces pages, ces modifications seront perdues.
</Warning>

### Suivi des pages indexées

Chaque source web affiche son titre, son URL, son nombre de pages et sa date d'indexation, ainsi qu'un indicateur de statut :

| Statut                                               | Signification                             |
| ---------------------------------------------------- | ----------------------------------------- |
| <Icon icon="circle-check" iconType="solid" /> Succès | L'indexation s'est terminée correctement. |
| <Icon icon="spinner" iconType="solid" /> En cours    | Le crawl est en cours de traitement.      |
| <Icon icon="circle-xmark" iconType="solid" /> Erreur | L'indexation a échoué.                    |

Le menu <Icon icon="ellipsis-vertical" iconType="solid" /> de chaque source permet de **configurer** le crawl, de le **rafraîchir** ou de **supprimer** la source. Comme pour les documents, cliquez sur une source pour consulter ses pages crawlées et leurs fragments (vues **Fragments** et **Markdown**).

## Supprimer une source

La suppression d'un document ou d'une source web est **irréversible**.

<Warning>
  Si la source est utilisée par un ou plusieurs agents, sa suppression est bloquée. Volubile affiche la liste des
  agents concernés : retirez d'abord la source de leur configuration avant de pouvoir la supprimer.
</Warning>