> ## 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.
# Documentos de Conocimiento
> Sube fuentes de datos para tu agente de IA
Si los *Crawlers* son libros de la biblioteca pública (la web), los **Documentos** son los archivos privados de tu oficina.
Aquí es donde subes tus manuales confidenciales, listas de precios de Excel o guías internas en PDF. Le das al agente acceso directo a archivos específicos para que se convierta en un experto instantáneo en *tu* negocio.
### 📥 ¿Qué puedo subir aquí? (Formatos mágicos)
Tu agente es multilingüe y puede leer casi cualquier cosa:
* 📄 **PDF:** Manuales, catálogos, folletos.
* 📊 **XLSX / CSV:** Tablas de precios, listas de stock, bases de datos simples.
* 📝 **TXT / JSONL:** Notas rápidas, logs o datos estructurados.
***
### ⚙️ Cómo gestionar tus archivos (La Zona de Subida)
Es tan fácil como parece:
1. **Arrastrar y soltar:** Arrastra tu archivo al recuadro o haz clic para explorar tu ordenador.
2. **Procesamiento:** El sistema leerá ("parseará") el texto para que el agente pueda entenderlo.
3. **¡Listo!** Una vez procesado, verás el archivo en la lista inferior.
#### Controles de la lista:
* **Nombre:** El nombre del archivo. Mantenlo claro (ej. `Precios_2024.pdf` en lugar de `doc1.pdf`).
* **Interruptor (El Switch):** La función más útil.
* 🔵 **Activado:** El agente lee y usa este archivo.
* ⚪ **Desactivado:** El archivo está almacenado pero ignorado por el agente. Perfecto para borradores o versiones antiguas que no quieres eliminar completamente.
* **Papelera 🗑️:** Elimina permanentemente el archivo de la memoria del agente.
***
### ⚠️ Reglas de Oro (Qué NO hacer)
Para que todo funcione sin problemas, ten esto en cuenta:
#### 1. Archivos vacíos = Error 🚫
Si subes un PDF que solo contiene imágenes escaneadas (sin texto seleccionable) o un archivo corrupto, verás un error como `[MARKITDOWN] pdf is empty`.
> **Solución:** Asegúrate de que el PDF contiene texto real (OCR) o que el archivo Excel tiene datos reales.
#### 2. Vigila el tamaño (¡Divídelo!) ✂️
Hay un límite de palabras por archivo para evitar sobrecargar el cerebro del agente.
* *¿Tu manual tiene 500 páginas?* No lo subas como un solo archivo.
* **Divídelo:** Sube `Manual_Parte1.pdf`, `Manual_Parte2.pdf`, etc.
* El agente es inteligente y combinará información de todos los archivos activos para dar una respuesta coherente.
***
### 🧠 ¿Cómo razona el agente con esto?
Imagina que subes tres archivos y los activas (**ON**):
1. `Manual_Lavadora.pdf`
2. `Precios_Repuestos.xlsx`
3. `Politica_Garantia.txt`
Ahora, si un usuario pregunta: *"¿Cuánto cuesta la pieza X y está cubierta por la garantía?"*
El agente:
1. Buscará el precio en el **Excel**.
2. Leerá las condiciones en el **TXT**.
3. Combinará ambos y responderá: *"La pieza cuesta 20€ y sí, está cubierta según la cláusula 3."* 🤯
***
### 🎓 Resumen de Buenas Prácticas (Cheat Sheet)
* **Nombres descriptivos:** Ayuda al agente (y a ti mismo) a entender qué hay dentro. `Menu_Boda.pdf` es mejor que `scan001.pdf`.
* **Actualizaciones:** Si subes una nueva versión (`Precios_V2.xlsx`), recuerda desactivar o eliminar la antigua (`Precios_V1.xlsx`) para que el bot no se confunda con dos precios diferentes.
* **Datos limpios:** Evita subir archivos Excel con miles de filas vacías o PDFs con marcas de agua pesadas. Cuanto más limpio sea el texto, más inteligente será la respuesta.
¡Empieza a llenar el cerebro de tu agente con tus mejores documentos! 📂✨