> ## 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.
# Документы
> Загрузите источники данных для вашего AI-агента
Если *Краулеры* — это книги из публичной библиотеки (веб), то **Документы** — это личные файлы в вашем офисе.
Здесь вы загружаете конфиденциальные руководства, прайс-листы в Excel или внутренние PDF-руководства. Вы даёте агенту прямой доступ к конкретным файлам, чтобы он мгновенно стал экспертом в *вашем* бизнесе.
### 📥 Что можно загрузить? (Поддерживаемые форматы)
Ваш агент многоязычен и может читать практически всё:
* 📄 **PDF:** Руководства, каталоги, брошюры.
* 📊 **XLSX / CSV:** Прайс-таблицы, списки товаров, простые базы данных.
* 📝 **TXT / JSONL:** Быстрые заметки, логи или структурированные данные.
***
### ⚙️ Как управлять файлами (Зона загрузки)
Это так просто, как выглядит:
1. **Перетащите:** Перетащите файл в область или нажмите для выбора на компьютере.
2. **Обработка:** Система прочитает («распарсит») текст, чтобы агент мог его понять.
3. **Готово!** После обработки файл появится в списке ниже.
#### Элементы управления списком:
* **Название:** Имя файла. Используйте понятные имена (например, `Прайс_2024.pdf` вместо `doc1.pdf`).
* **Переключатель:** Самая полезная функция.
* 🔵 **ВКЛ:** Агент читает и использует этот файл.
* ⚪ **ВЫКЛ:** Файл хранится, но игнорируется агентом. Идеально для черновиков или старых версий, которые вы не хотите полностью удалять.
* **Корзина 🗑️:** Безвозвратно удаляет файл из памяти агента.
***
### ⚠️ Золотые правила (Чего НЕ делать)
Чтобы всё работало гладко, помните:
#### 1. Пустые файлы = Ошибка 🚫
Если вы загрузите PDF, содержащий только сканированные изображения (без выделяемого текста) или повреждённый файл, вы увидите ошибку `[MARKITDOWN] pdf is empty`.
> **Решение:** Убедитесь, что PDF содержит реальный текст (OCR) или что в Excel-файле есть реальные данные.
#### 2. Следите за размером (Разделяйте!) ✂️
Существует лимит слов на файл, чтобы не перегружать мозг агента.
* *У вашего руководства 500 страниц?* Не загружайте его одним файлом.
* **Разделите:** Загрузите `Руководство_Часть1.pdf`, `Руководство_Часть2.pdf` и т.д.
* Агент достаточно умён и объединит информацию из всех активных файлов для связного ответа.
***
### 🧠 Как агент рассуждает с этим?
Представьте, что вы загрузили три файла и включили их **ВКЛ**:
1. `Руководство_Стиральная_Машина.pdf`
2. `Цены_Запчасти.xlsx`
3. `Гарантийная_Политика.txt`
Теперь, если пользователь спрашивает: *«Сколько стоит деталь X и покрывается ли она гарантией?»*
Агент:
1. Найдёт цену в **Excel**.
2. Прочитает условия в **TXT**.
3. Объединит оба и ответит: *«Деталь стоит 2000 руб., и да, она покрывается по пункту 3.»* 🤯
***
### 🎓 Краткое резюме лучших практик (Шпаргалка)
* **Описательные названия:** Помогите агенту (и себе) понять, что внутри. `Свадебное_Меню.pdf` лучше, чем `скан001.pdf`.
* **Обновления:** Если вы загружаете новую версию (`Прайс_V2.xlsx`), не забудьте выключить или удалить старую (`Прайс_V1.xlsx`), чтобы бот не путался с двумя разными ценами.
* **Чистые данные:** Избегайте загрузки Excel-файлов с тысячами пустых строк или PDF с тяжёлыми водяными знаками. Чем чище текст, тем умнее ответ.
Начните наполнять мозг агента вашими лучшими документами! 📂✨