📚 База знаний

База знаний — документы проекта, из которых AI берёт факты для ответов. На них опираются генерация ответа оператору и блок «ИИ — ответ по базе» в сценариях.

Раздел находится в меню «Проект» → «База знаний». Подзаголовок раздела — «Управление документами базы знаний проекта».

Как устроен раздел

Экран разделён на две части:

• слева — рейл «Папки» с деревом папок; верхний узел — «Все документы» (это корень, в нём видны документы, не разложенные по папкам);
• справа — таблица документов выбранной области.

В шапке — строка поиска «Поиск по базе знаний...» и две кнопки: «Загрузить файл» и «Создать документ».

Колонки таблицы: «Название», «Содержимое» (превью текста без markdown-разметки), «Автор», «Дата создания», «Дата обновления», «Теги», «Управление». Названия, автора и обе даты можно сортировать кликом по заголовку колонки. Количество строк на странице подбирается под высоту окна, внизу — пагинация.

Папки

Папки нужны, чтобы разложить документы по темам: инструкции, тарифы, регламенты. Вложенность произвольная.

Действие	Как выполнить
Создать папку в корне	Кнопка «+» в шапке рейла «Папки» — откроется окно «Создание папки» с подписью «Создать папку в корне»
Создать подпапку	Навести курсор на строку папки → «Добавить подпапку»; в окне будет подпись «Создать папку внутри «название»»
Переименовать	Навести курсор на строку папки → значок карандаша («Редактировать»), окно «Переименование папки»
Удалить	Навести курсор на строку папки → значок корзины («Удалить»), окно «Удалить папку?»
Перенести папку	Перетащить папку мышью на другую папку в дереве
Перенести документ	Перетащить строку документа на нужную папку в дереве

Папку документа можно задать и без перетаскивания — полем «Папка» в окнах создания и изменения документа. Вариант «Корень (без папки)» оставляет документ вне папок.

Удаление папки необратимо

В окне подтверждения написано: «Папка со всеми вложенными папками и документами будет удалена безвозвратно». Если внутри есть документы, добавляется строка «В этой папке есть документы — они тоже будут удалены». Восстановить удалённое нельзя.

Папку нельзя перенести внутрь самой себя или собственной подпапки — появится сообщение «Нельзя перенести папку внутрь самой себя или своей подпапки».

Документы

Создать вручную

Кнопка «Создать документ» открывает окно «Создание документа» с тремя полями:

Поле	Описание
«Имя документа»	Название, до 64 символов. Обязательно
«Папка»	Куда положить документ. По умолчанию — папка, которая сейчас выбрана в дереве; вариант «Корень (без папки)»
«Содержимое документа»	Текст в markdown-редакторе с панелью форматирования (жирный, курсив, код, ссылка, заголовок, списки, отмена и повтор). Обязательно, длина не ограничена

Загрузить файлом

Кнопка «Загрузить файл» открывает выбор файла на компьютере. После выбора появляется окно «Загрузка документа» с именем и размером файла и кнопками «Применить» и «Отменить».

• Допустимые форматы: PDF, DOCX, TXT, MD.
• Размер файла — не больше 1 МБ, файл не должен быть пустым.
• Название документа берётся из имени файла без расширения.
• Документ попадает в папку, которая выбрана в дереве в момент загрузки.

Из PDF и DOCX извлекается только текст: изображения, таблицы-картинки и оформление не сохраняются. Если файл не подошёл, появится сообщение «Неподдерживаемый формат. Допустимы: PDF, DOCX, TXT, MD», «Файл пустой» или «Файл слишком большой (максимум 1 МБ)».

Посмотреть и изменить

Клик по названию или по содержимому строки (а также по документу в дереве папок) открывает окно «Информация о документе»: поля «Название документа», «Автор», «Создан», «Обновлён», «Содержимое» (отображается уже отформатированным — заголовки, списки, таблицы; ссылки открываются в новой вкладке) и плитки «Символов», «Слов», «Строк». Кнопка «Редактировать» переводит в окно «Изменение документа».

В колонке «Управление» доступны редактирование и удаление документа. Удаление подтверждается окном «Удаление документа» с вопросом «Вы действительно хотите удалить документ?».

Автор

Автор проставляется автоматически — это участник, создавший документ. Если документ попал в базу знаний через импорт по API, автора у него нет и в колонке будет прочерк.

Массовые действия

В таблице у каждой строки есть чекбокс, а в шапке — «Выбрать все» (отмечает документы текущей страницы). Как только выбран хотя бы один документ, над таблицей появляется панель «Выбрано: N» со ссылкой «Снять выделение» и кнопками:

• «Переместить в…» — окно «Перемещение документов», выбор целевой папки. Итог: «Перемещено документов: N из M».
• «Удалить выбранные» — окно «Удалить выбранные документы?» с текстом «Будет удалено документов: N. Действие необратимо.». Итог: «Удалено документов: N из M».

Переход в другую папку сбрасывает выделение.

Теги

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

Поиск

Строка «Поиск по базе знаний...» в шапке ищет документы по всему проекту, а не только в открытой папке. Поиск нечёткий: небольшая опечатка в запросе результат не ломает. Если ничего не нашлось, показывается «Документы не найдены» и подсказка «Попробуйте изменить критерии поиска».

Поиск идёт только по названию документа

Содержимое документов при поиске не просматривается. Запрос сверяется только с полем «Название», поэтому найти документ по фразе из его текста нельзя — даже если эта фраза в нём точно есть.

Практический вывод: выносите ключевые слова в название. «Возврат товара: сроки и условия» найдётся по слову «возврат», а документ с названием «Регламент №14» — нет.

На ответы AI это ограничение не распространяется: генерация ответа ищет по содержимому фрагментов, а не по названиям.

Как база знаний используется AI

При каждом сохранении документ автоматически разбивается на фрагменты — границы проходят по markdown-заголовкам. AI ищет ответ не по документу целиком, а по этим фрагментам, поэтому:

• структурируйте текст заголовками — один заголовок на один смысловой блок;
• держите ответ на вопрос рядом с самим вопросом, а не в другой части документа;
• избегайте длинных «простыней» без разделов — их сложнее найти по конкретному запросу.

Поиск учитывает и смысл формулировки, и точные слова из документа.

Изменения доезжают не мгновенно

Индексация асинхронная: только что созданный или изменённый документ становится доступен AI с небольшой задержкой. Переименование, правка содержимого и перенос в другую папку тоже вызывают переиндексацию, удаление — убирает документ из поиска AI.

Импорт по API

Документы могут попадать в базу знаний не только из интерфейса: публичный API поддерживает пакетный импорт с автоматическим созданием папок по указанному пути. Повторная загрузка неизменённого документа ничего не меняет, а удалённые в источнике документы удаляются и из базы знаний. Подробности — в разделе API базы знаний.

Ограничения

• Поиск работает только по названию документа — по содержимому не ищет.
• Название документа и название папки — до 64 символов.
• Файл при загрузке — до 1 МБ, форматы PDF, DOCX, TXT, MD. Другие форматы (XLSX, PPTX, HTML, изображения) загрузить нельзя.
• Содержимое документа по длине не ограничено.
• Версий документа нет. Правка перезаписывает текст: посмотреть предыдущую редакцию или откатить изменение нельзя.
• Не видно, какими фрагментами воспользовался AI. В окне генерации ответа и в переменных сценария список использованных документов не показывается — сверять факты приходится вручную по разделу «База знаний».
• Удаление документа, папки и массовое удаление необратимы.

Кто что может

Действие	Минимальная роль
Открывать раздел, читать документы, искать	По умолчанию
Создавать документы и папки, загружать файлы	Редактор
Редактировать документы, переименовывать и перетаскивать папки	Редактор
Назначать теги на документы и папки	Редактор
Удалять документы и папки, массовое удаление	Администратор

Кнопка, на которую у участника нет права, не отображается. Про роли — на странице Пользователи и роли.

---

→ AI-возможности · Генерация ответа · Теги · API базы знаний