> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Documents
> Téléchargez des sources de données pour votre agent IA
Si les *Crawlers* sont des livres de la bibliothèque publique (le web), les **Documents** sont les fichiers privés dans votre bureau.
C'est ici que vous téléchargez vos manuels confidentiels, vos listes de prix Excel ou vos guides PDF internes. Vous donnez à l'agent un accès direct à des fichiers spécifiques pour qu'il devienne un expert instantané de *votre* entreprise.
### 📥 Que puis-je télécharger ici ? (Formats magiques)
Votre agent est multilingue et peut lire presque tout :
* 📄 **PDF :** Manuels, catalogues, brochures.
* 📊 **XLSX / CSV :** Tableaux de prix, listes de stock, bases de données simples.
* 📝 **TXT / JSONL :** Notes rapides, journaux ou données structurées.
***
### ⚙️ Comment gérer vos fichiers (La zone de téléchargement)
C'est aussi simple que ça en a l'air :
1. **Glisser-déposer :** Faites glisser votre fichier dans la zone ou cliquez pour parcourir votre ordinateur.
2. **Traitement :** Le système lira (« parsera ») le texte pour que l'agent puisse le comprendre.
3. **Prêt !** Une fois traité, vous verrez le fichier dans la liste ci-dessous.
#### Contrôles de la liste :
* **Nom :** Le nom du fichier. Gardez-le clair (ex. `Tarifs_2024.pdf` au lieu de `doc1.pdf`).
* **Interrupteur (Le commutateur) :** La fonctionnalité la plus utile.
* 🔵 **ON :** L'agent lit et utilise ce fichier.
* ⚪ **OFF :** Le fichier est stocké mais ignoré par l'agent. Parfait pour les brouillons ou les anciennes versions que vous ne voulez pas supprimer complètement.
* **Corbeille 🗑️ :** Supprime définitivement le fichier de la mémoire de l'agent.
***
### ⚠️ Règles d'or (Ce qu'il ne faut PAS faire)
Pour que tout fonctionne bien, gardez ceci à l'esprit :
#### 1. Fichiers vides = Erreur 🚫
Si vous téléchargez un PDF qui ne contient que des images scannées (pas de texte sélectionnable) ou un fichier corrompu, vous verrez une erreur du type `[MARKITDOWN] pdf is empty`.
> **Solution :** Assurez-vous que le PDF contient du vrai texte (OCR) ou que le fichier Excel contient des données réelles.
#### 2. Attention à la taille (Découpez !) ✂️
Il y a une limite de mots par fichier pour éviter de surcharger le cerveau de l'agent.
* *Votre manuel fait 500 pages ?* Ne le téléchargez pas en un seul fichier.
* **Découpez-le :** Téléchargez `Manuel_Partie1.pdf`, `Manuel_Partie2.pdf`, etc.
* L'agent est intelligent et combinera les informations de tous les fichiers actifs pour donner une réponse cohérente.
***
### 🧠 Comment l'agent raisonne-t-il avec cela ?
Imaginez que vous téléchargez trois fichiers et les activez (**ON**) :
1. `Manuel_Lave_Linge.pdf`
2. `Prix_Pieces_Detachees.xlsx`
3. `Politique_Garantie.txt`
Maintenant, si un utilisateur demande : *« Combien coûte la pièce X et est-elle couverte par la garantie ? »*
L'agent va :
1. Chercher le prix dans l'**Excel**.
2. Lire les conditions dans le **TXT**.
3. Combiner les deux et répondre : *« La pièce coûte 20 € et oui, elle est couverte par la clause 3. »* 🤯
***
### 🎓 Résumé des bonnes pratiques (Aide-mémoire)
* **Noms descriptifs :** Aidez l'agent (et vous-même) à comprendre ce qu'il y a à l'intérieur. `Menu_Mariage.pdf` est mieux que `scan001.pdf`.
* **Mises à jour :** Si vous téléchargez une nouvelle version (`Tarifs_V2.xlsx`), n'oubliez pas de désactiver (OFF) ou de supprimer l'ancienne (`Tarifs_V1.xlsx`) pour que le bot ne se mélange pas avec deux prix différents.
* **Données propres :** Évitez de télécharger des fichiers Excel avec des milliers de lignes vides ou des PDF avec des filigranes lourds. Plus le texte est propre, plus la réponse est intelligente.
Commencez à remplir le cerveau de votre agent avec vos meilleurs documents ! 📂✨