> ## 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.
# Documenti
> Carica le fonti di dati per il tuo agente AI
Se i *Crawler* sono libri della biblioteca pubblica (il web), i **Documenti** sono i file privati nel tuo ufficio.
Qui è dove carichi i tuoi manuali confidenziali, listini prezzi Excel o guide interne in PDF. Dai all'agente accesso diretto a file specifici così diventa un esperto istantaneo nella *tua* attività.
### 📥 Cosa posso caricare qui? (Formati magici)
Il tuo agente è multilingue e può leggere quasi tutto:
* 📄 **PDF:** Manuali, cataloghi, brochure.
* 📊 **XLSX / CSV:** Tabelle prezzi, liste di inventario, database semplici.
* 📝 **TXT / JSONL:** Note rapide, log o dati strutturati.
***
### ⚙️ Come gestire i tuoi file (La zona di caricamento)
È facile come sembra:
1. **Trascina e rilascia:** Trascina il tuo file nella casella o clicca per sfogliare il tuo computer.
2. **Elaborazione:** Il sistema leggerà ("analizzerà") il testo in modo che l'agente possa capirlo.
3. **Pronto!** Una volta elaborato, vedrai il file nella lista sottostante.
#### Controlli della lista:
* **Nome:** Il nome del file. Mantienilo chiaro (es. `Prezzi_2024.pdf` invece di `doc1.pdf`).
* **Interruttore (Lo switch):** La funzionalità più utile.
* 🔵 **ON:** L'agente legge e usa questo file.
* ⚪ **OFF:** Il file è memorizzato ma ignorato dall'agente. Perfetto per bozze o versioni precedenti che non vuoi eliminare completamente.
* **Cestino 🗑️:** Rimuove permanentemente il file dalla memoria dell'agente.
***
### ⚠️ Regole d'oro (Cosa NON fare)
Per mantenere tutto in funzione senza problemi, tieni questo a mente:
#### 1. File vuoti = Errore 🚫
Se carichi un PDF che contiene solo immagini scansionate (nessun testo selezionabile) o un file corrotto, vedrai un errore come `[MARKITDOWN] pdf is empty`.
> **Soluzione:** Assicurati che il PDF contenga testo reale (OCR) o che il file Excel abbia dati effettivi.
#### 2. Attenzione alla dimensione (Dividilo!) ✂️
C'è un limite di parole per file per evitare di sovraccaricare il cervello dell'agente.
* *Il tuo manuale ha 500 pagine?* Non caricarlo come un unico file.
* **Dividilo:** Carica `Manuale_Parte1.pdf`, `Manuale_Parte2.pdf`, ecc.
* L'agente è intelligente e combinerà le informazioni da tutti i file attivi per dare una risposta coerente.
***
### 🧠 Come ragiona l'agente con questi?
Immagina di caricare tre file e di attivarli **ON**:
1. `Manuale_Lavatrice.pdf`
2. `Prezzi_Ricambi.xlsx`
3. `Politica_Garanzia.txt`
Ora, se un utente chiede: *"Quanto costa il ricambio X ed è coperto dalla garanzia?"*
L'agente:
1. Cercherà il prezzo nell'**Excel**.
2. Leggerà le condizioni nel **TXT**.
3. Combinerà entrambi e risponderà: *"Il ricambio costa 20€ e sì, è coperto dalla clausola 3."* 🤯
***
### 🎓 Riepilogo delle migliori pratiche (Cheat Sheet)
* **Nomi descrittivi:** Aiuta l'agente (e te stesso) a capire cosa c'è dentro. `Menu_Matrimonio.pdf` è meglio di `scan001.pdf`.
* **Aggiornamenti:** Se carichi una nuova versione (`Prezzi_V2.xlsx`), ricorda di disattivare o eliminare quella vecchia (`Prezzi_V1.xlsx`) così il bot non si confonde con due prezzi diversi.
* **Dati puliti:** Evita di caricare file Excel con migliaia di righe vuote o PDF con watermark pesanti. Più il testo è pulito, più la risposta è intelligente.
Inizia a riempire il cervello del tuo agente con i tuoi migliori documenti! 📂✨