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

# Bases de connaissances

> Aider les assistants à répondre depuis vos documents et sites web

Une base de connaissances fournit à un assistant des informations validées sur vos produits, politiques, horaires, tarifs et autres sujets professionnels. Lorsqu'un appelant pose une question liée, l'assistant peut s'appuyer sur les passages les plus pertinents de votre contenu au lieu de deviner.

## Comment ça marche

Tout ce que vous ajoutez est découpé en courts passages, puis indexé. Pendant une conversation, la question de l'appelant est comparée à cet index, et seuls les passages les plus pertinents sont transmis à l'assistant comme contexte pour sa réponse — pas le document entier, et pas toute la base de connaissances.

Cela a une conséquence pratique : l'assistant ne voit jamais que les passages qui ont correspondu. Si la réponse à une question est répartie sur trois documents, ou si la condition qui la qualifie se trouve dans une section différente du fait lui-même, le passage retrouvé peut être exact mais incomplet. Rédiger chaque sujet comme une section autonome est ce qui rend la recherche fiable — voir ci-dessous.

## Créer et connecter une base de connaissances

<Steps>
  <Step title="Créer">
    Ouvrez **Knowledge bases → New**, saisissez un nom et ajoutez une courte description du contenu.
  </Step>

  <Step title="Ajouter du contenu">
    Importez des fichiers PDF, DOCX, HTML ou texte. Vous pouvez aussi ajouter du texte, des URL de documents ou une source de site web.
  </Step>

  <Step title="Attendre que le contenu soit prêt">
    Chaque élément affiche son statut. Si un élément ne peut pas être traité, ouvrez-le pour voir ce qu'il faut modifier.
  </Step>

  <Step title="Tester">
    Utilisez **RAG Search** pour poser de vraies questions clients et prévisualiser les passages qu'un assistant trouverait. Améliorez tout document qui ressort peu clair ou contradictoire.
  </Step>

  <Step title="Connecter un assistant">
    Sélectionnez la base de connaissances dans l'éditeur d'assistant. Aucune modification du prompt n'est nécessaire.
  </Step>
</Steps>

## Rédiger du contenu qui répond bien

* Utilisez un titre clair pour chaque sujet.
* Gardez les faits et les conditions nécessaires à une réponse dans la même section.
* Placez les chiffres importants dans le texte, pas uniquement dans des tableaux complexes.
* Supprimez les copies obsolètes ou contradictoires.
* Privilégiez un seul sujet par document quand c'est possible.
* Surveillez la latence sur les très grandes bases de connaissances, en particulier avec de nombreux PDF volumineux — convertir le contenu essentiel en fichiers texte se traite et se recherche généralement plus vite.

## Importer un site web

Ajoutez une source de site web avec une URL racine. Vous pouvez la limiter à certains préfixes de chemin, exclure des sections indésirables et définir le nombre maximal de pages à importer.

Lancez l'import une fois, ou activez la synchronisation automatique pour revérifier le site à l'intervalle de votre choix. Seules les pages nouvelles ou modifiées consomment des crédits d'import.

Donnez un nom personnalisé à chaque source d'actualisation automatique lors de son ajout. C'est ce nom qui apparaît sous **Auto Refresh** ; il ne modifie ni l'URL du site ni le dossier connecté. Choisissez **Edit** sur la source plus tard pour la renommer ou changer ses réglages d'actualisation.

Choisissez **Load pages** sur une source de site web pour afficher les chemins dont l'indexation est terminée. Charger cette liste ne fait que lire l'index actuel ; cela n'actualise pas le site web et ne consomme pas de crédits.

Pour un accès via l'API ou MCP, utilisez `GET /knowledge-bases/{id}/crawl-sources/{sourceId}/pages` ou `list_crawl_source_pages`. Les deux ne renvoient que les pages prêtes et indexées, et ne déclenchent jamais d'actualisation ni de consommation de crédits.

Les imports de site web :

* suivent les pages sur le même hôte,
* respectent les règles d'exploration du site web,
* fonctionnent mieux avec les pages dont le texte principal est présent dans le HTML, et
* ignorent les pages non prises en charge ou trop volumineuses.

Si un site ne charge tout son texte utile qu'après l'exécution de JavaScript, ajoutez plutôt son contenu sous forme de documents ou de texte direct.

## Synchronisation de stockage cloud

Ajoutez un dossier Google Drive, OneDrive, Box, Dropbox ou SharePoint comme source de base de connaissances qui reste automatiquement à jour, de la même façon qu'une source de site web. Connectez d'abord le compte sous **[Automations → Connections](/fr/automations/overview)** s'il ne l'est pas encore — une connexion OAuth, pas une clé collée — puis ajoutez le dossier comme source et sélectionnez cette connexion. SharePoint nécessite en plus l'ID de lecteur (drive ID) de la bibliothèque de documents — un chemin de dossier seul ne suffit pas pour en lister le contenu.

Lancez une synchronisation une fois, ou activez la synchronisation automatique pour revérifier le dossier à l'intervalle de votre choix. Seuls les fichiers nouveaux ou modifiés consomment des crédits de synchronisation.

La synchronisation de stockage cloud est en Beta : activez **Beta Features** sous **Settings → Workspace** pour faire apparaître les options de stockage cloud. Elle est soumise à sa propre fonctionnalité de forfait, distincte de l'exploration de sites web, et facturée par fichier synchronisé au double du tarif d'exploration de site web par page — indiqué comme **KB cloud drive sync file** sur la [page Usage](https://app.famulor.io/usage), où vous pouvez consulter vos tarifs actuels.

Pour un accès via l'API ou MCP, utilisez `GET`/`POST /api/v1/knowledge-bases/{id}/drive-sources`, `GET`/`PATCH`/`DELETE /api/v1/knowledge-bases/{id}/drive-sources/{sourceId}` et `POST /api/v1/knowledge-bases/{id}/drive-sources/{sourceId}/run`, ou les outils MCP `list_drive_sources`, `create_drive_source`, `update_drive_source`, `delete_drive_source`, `run_drive_source`.

## FAQ auto-apprenante (Beta)

L'onglet **FAQ (Beta)** apparaît une fois **Beta Features** activé sous **Settings → Workspace**. Des paires question-réponse peuvent être rédigées directement sous **Entries** — une alternative plus légère à l'import d'un document. Indépendamment de cela, l'**Inbox** rassemble les questions factuelles des clients qui n'ont pas obtenu de résultat utile dans la base de connaissances. Vérifiez la réponse proposée, corrigez-la, puis choisissez **Approve & publish** avant qu'elle ne rejoigne la base de connaissances.

Les propositions générées par l'assistant ne sont jamais publiées automatiquement. Selon le réglage de l'assistant, Famulor peut se contenter de recueillir la question, préparer un brouillon privé, ou partager une réponse clairement provisoire pendant la conversation.

## Disponibilité et limites

Le nombre de bases de connaissances et l'accès à l'import de site web dépendent de votre forfait. Si le nombre de bases de connaissances inclus dans votre forfait ne suffit pas, achetez des emplacements supplémentaires depuis **Settings → Plan**, sous forme d'add-on **Extra Knowledgebases**, facturé par base de connaissances et par mois. Les limites actuelles par base de connaissances sont :

| Ressource     | Limite                            |
| ------------- | --------------------------------- |
| Fichiers      | 25 fichiers, 20 Mo maximum chacun |
| URL           | 500                               |
| Entrées texte | 50                                |
| CSV ou TSV    | 1 000 lignes et 50 colonnes       |

Les imports de site web sont facturés en crédits par page nouvelle ou modifiée, au tarif **KB crawl / auto-sync page** de l'espace de travail — les tarifs actuels figurent sur la [page Usage](https://app.famulor.io/usage). La source affiche la progression et toute action nécessaire si le solde de crédits disponible est épuisé.
