Документы и база знаний

База знаний — это ваши документы, на основе которых ассистент отвечает на вопросы. Всё управление документами происходит в панели «Мои документы».

💡 Ту же папку можно открыть как облако — кнопкой «☁️ Мои файлы» в шапке чата: там удобнее раскладывать файлы по папкам, искать по содержимому и делиться ссылками. Всё, что загружено в облако, попадает в базу знаний — см. «Облако для файлов».

Как открыть панель

Нажмите «📄 Документы» в шапке чата. Панель откроется справа; закрыть её можно кнопкой ✕ или кликом по затемнённой области.

Поддерживаемые форматы

Загрузка документов

1. В панели «Мои документы» нажмите на зону загрузки (или просто перетащите файлы в неё).
2. Выберите один или несколько файлов — загрузка начнётся сразу.
3. Дождитесь сообщения о завершении загрузки.

Полезно знать:

• Несколько файлов за раз — выбирайте все нужные файлы сразу или перетаскивайте пачкой.
• Повторная загрузка файла с тем же именем обновляет документ: старая версия заменяется новой, а не дублируется. Так удобно обновлять инструкции и прайсы.
• После загрузки система в фоне переиндексирует базу знаний — первые секунды поиск может идти по «старой» версии, но вскоре новые документы будут доступны для вопросов.
• Неподдерживаемые форматы (например, ZIP или исполняемые файлы) не принимаются — система сообщит об ошибке.

База знаний по ссылке на сайт

Если информация о вашей компании живёт на сайте, её можно не переносить в файлы вручную: в панели «📄 Документы» есть кнопка «🌐 Индексировать сайт» — укажите адрес, и система обойдёт страницы и соберёт из них один текстовый файл site_домен.txt. Обновлять его потом можно кнопкой ⟳ «Обновить с сайта» прямо в списке документов, а узнать, что вообще изменилось на сайте, — кнопкой «🔍 Проверить изменения» там же в окне индексации: она сверяет карту сайта с базой знаний за секунды и показывает, какие файлы затронуты. Обновить только их — кнопкой «⬆ Обновить затронутые».

Подробнее: «База знаний по ссылке на сайт».

Распознавание сканов (OCR)

Если администратор включил распознавание, страницы сканированных PDF без текстового слоя автоматически распознаются. Бумажный архив можно «оживить»: отсканируйте документы в PDF и загрузите — ассистент будет находить в них ответы. Если OCR не включён, такие страницы пропускаются — об этом можно уточнить у администратора.

Картинки, фото и схемы

Картинки (JPG, PNG, WEBP, BMP, GIF) — такой же источник знаний, как документы: загрузите фотографию, схемы, скриншот или снимок страницы бумажного документа, и система сама разберёт изображение.

Что происходит после загрузки:

1. Ассистент распознаёт весь текст на изображении — надписи, подписи, марки, артикулы, размеры, таблицы.
2. Дополнительно он описывает, что изображено: изделие, оборудование, схема, чертёж, скриншот интерфейса, ключевые элементы и подписи.
3. Рядом с картинкой создаётся текстовый файл с этим описанием — именно он попадает в базу знаний. Сама картинка остаётся в списке документов (пометка 🖼) и доступна для скачивания.

Полезно знать:

• Обработка идёт в фоне: картинка появляется в списке сразу, а её описание — через несколько секунд. Несколько картинок можно загрузить одной пачкой, обработаются они по очереди.
• Файл-описание скрыт в списке как RAG-файл (чтобы не засорять список): включите переключатель «📄 Показать RAG-файлы», если хотите его увидеть. Имя у него такое же, как у картинки: шильдик.jpg → шильдик.txt.
• Повторно распознавать не нужно: система помнит уже разобранные картинки, поэтому переиндексация базы знаний не тратит время и не обращается к модели заново.
• В ответах источник показывается под именем картинки — по ссылке скачивается сам файл изображения.
• Когда это особенно полезно: фотографии шильдиков и табличек с характеристиками, схемы подключения, чертежи с размерами, скриншоты настроек, снимки страниц бумажных документов.
• Если на картинке есть цены, помните: точные ответы о ценах даёт отдельный механизм прайс-листов (XLSX/CSV) — см. «Прайс-листы и цены».

Группировка по типам

Система автоматически определяет тип документа и раскладывает их по группам: 📖 Инструкции, 📄 Паспорта, 💲 Прайс-листы, 📁 Прочие документы и другие. Группа определяется по имени файла и содержимому.

• Включите переключатель «🗂️ По группам» в шапке панели — документы сгруппируются по типу.
• Выключите — увидите общий список.
• Прайс-листы всегда попадают в группу 💲 Прайс-листы (о них — в разделе «Прайс-листы и цены»).

Сортировка

В шапке панели есть выбор сортировки:

• По дате загрузки — свежие документы сверху (по умолчанию).
• По имени — алфавитный порядок.

Выбор запоминается между визитами.

Действия с документами

Для каждого документа доступны:

• ⬇️ Скачать — загрузить файл на компьютер.
• 🗑️ Удалить — удалить документ из базы знаний (система спросит подтверждение).

Документ с пометкой 📋 и числом — прайс-лист; число показывает, сколько позиций из него распознано.

Множественные действия

Отметьте галочками несколько документов — внизу панели появится панель действий:

• ☑️ Выбрать все / Снять — отметить или снять все документы.
• ⬇️ Скачать выбранные — скачать отмеченные файлы одним ZIP-архивом.
• 🗑️ Удалить выбранные — удалить отмеченные документы разом.

RAG-файлы: как улучшить индексацию документа

RAG-файл — это обычный TXT-файл, который помогает системе лучше «понять» документ. Обычно вы создаёте его сами — это ручной инструмент для тонкой настройки базы знаний. Исключение — картинки: для них такое описание система составляет автоматически (см. раздел «Картинки, фото и схемы»).

Как это работает:

1. Создайте TXT-файл с тем же именем, что и документ: например, инструкция.pdf → инструкция.txt.
2. Загрузите его в базу знаний.
3. При индексации система берёт текст из TXT-файла, а оригинал (PDF, DOCX и т.п.) остаётся на месте и доступен для скачивания.

Важные детали:

• В ответах ассистента источник показывается под именем оригинального документа (например, инструкция.pdf), и по ссылке скачивается именно оригинал — даже если ответ найден в вашем TXT.
• В списке документов такие TXT-файлы скрыты по умолчанию (пометка «RAG-файлы»), чтобы не засорять список. Переключатель «📄 Показать RAG-файлы» под списком показывает их — например, чтобы удалить лишний.
• Удалите RAG-файл — и система снова будет индексировать оригинальный документ.

Когда это полезно:

• PDF-скан без текстового слоя, когда распознавание выключено, — приложите свой TXT с текстом документа.
• Система извлекла из документа мало или «кривой» текст (битая кодировка, свёрстанные таблицы).
• Нужно дать системе «чистую» версию текста или дополнить документ фактами, которых в нём нет.

Как правильно составлять RAG-файлы

Текст TXT-файла попадает в базу знаний построчно: каждая непустая строка становится отдельным фрагментом для поиска. От того, как вы разобьёте текст на строки, напрямую зависит качество ответов.

Правила:

• Одна строка — один факт. Пишите полные, законченные предложения: «Доставка по Москве занимает 1–2 рабочих дня». Не разбивайте один факт на несколько строк и не склеивайте несколько фактов в одну строку.
• Самодостаточные строки. Строка должна быть понятна сама по себе, без ссылок на соседние строки («как указано выше», «см. п. 3»).
• Чистый текст, без мусора. Не включайте номера страниц, колонтитулы, оглавление, символы-разделители (####, ====), служебные пометки — весь текст строки попадает в индекс как есть.
• Кодировка UTF-8. Сохраняйте файл в кодировке UTF-8 (стандартная для Блокнота Windows).
• Имя файла. Точно совпадает с именем документа, расширение — .txt: каталог.pdf → каталог.txt.
• Язык запросов. Формулируйте фразы так, как их задают пользователи: те же термины и синонимы («оплата», «рассрочка», «срок поставки»).
• Размер строки. Строка в 1–2 предложения ищется и сопоставляется лучше, чем абзац на полстраницы.

Пример правильного RAG-файла каталог.txt рядом с каталог.pdf:

Кресло офисное «Комфорт» поставляется в разобранном виде.
Срок поставки мебели — от 3 до 7 рабочих дней.
Доставка по Москве бесплатная при заказе от 30 000 ₽.
Гарантия на кресла — 18 месяцев с даты покупки.

Если в TXT-файле есть цены, помните: точные ответы на вопросы о ценах даёт отдельный механизм прайс-листов (XLSX/CSV) — см. «Прайс-листы и цены».

Изоляция базы знаний

У каждого пользователя — своя база знаний. Ваши документы, история и настройки не видны другим пользователям, и вы не видите чужие. Скачивание и удаление работают только с вашими файлами.