База знаний

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

Как начать работу с базой знаний

Шаг 1. Откройте базу знаний

Нажмите кнопку «Настройки» с шестерёнкой справа от названия проекта.

В открывшемся меню настроек найдите группу «Данные проекта» и выберите «База знаний».

Откроется страница базы знаний с папками, файлами и таблицами проекта.

Шаг 2. Добавьте первый материал

Если база пока пустая, нажмите кнопку «Добавить» в пустой базе. Она расположена в центре страницы.

В открывшемся окне выберите способ по тому, в каком виде информация уже хранится:

• если документ готов, загрузите файл или ZIP-архив;
• если нужно быстро написать инструкцию, FAQ или заметку, создайте текстовый документ прямо в кабинете;
• если данные удобнее хранить по строкам и столбцам, создайте таблицу — после создания её можно открыть в редакторе.

Подробные шаги вынесены в отдельные инструкции: загрузка файлов, текстовые документы и таблицы базы знаний.

Шаг 3. Найдите материал или добавьте следующий

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

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

Наведите указатель на значок, чтобы увидеть название режима, затем введите запрос. Если вы находитесь внутри папки, поиск выполняется в ней. Чтобы искать по всей базе, сначала вернитесь в корень.

Рядом со строкой находится кнопка добавления материала — нажмите её, чтобы добавить ещё один.

На снимке ниже строка поиска с переключателем области отмечена цифрой 1, а кнопка добавления — цифрой 2.

Шаг 4. Организуйте материалы по папкам

Когда материалов становится много, создайте отдельные папки, например по продуктам, отделам или задачам. Нажмите «Добавить», выберите создание папки, откройте вкладку «Папка» и укажите понятное название.

Чтобы открыть содержимое, выберите папку. Путь над списком поможет вернуться на предыдущий уровень или в корень базы знаний. Если папку нужно переименовать, откройте её настройки, измените название и нажмите «Сохранить».

Шаг 5. Измените, передайте или удалите материал

Откройте меню действий на карточке нужного материала. Открывшееся меню позволяет переименовывать или редактировать его, а также удалять устаревшие элементы. На снимке ниже сначала показана кнопка меню, а затем доступные действия.

Несколько выбранных элементов можно перенести в другую папку, скопировать в другой проект или передать по ссылке. При удалении кабинет попросит отдельно подтвердить действие. Сначала проверьте, не использует ли этот материал агент; подробнее об этом рассказано в разделе «Удаление материалов» ниже.

Типы ресурсов

• Папка - контейнер для файлов и таблиц. Если папку привязать к агенту, текущие и будущие элементы внутри нее будут доступны в ответах этого агента.
• Файл - документ базы знаний. Может быть создан вручную или получен из загруженного файла: Markdown, TXT, DOCX, PDF или другой поддержанный формат.
• Изображение - отдельный материал базы знаний, который можно использовать рядом с Markdown-инструкциями и в предпросмотре документа. Откройте его через меню материала: предпросмотр можно развернуть, а рядом показывается AI-описание для поиска или состояние его подготовки.
• Таблица - структурированные данные, которые открываются в отдельном редакторе таблиц.

Markdown-файлы могут хранить метаданные в frontmatter: например ID документа, маршрут раздела или источник. Эти данные помогают поиску и связке с нужным материалом, но не заменяют понятный текст самой инструкции. Если Markdown содержит ссылки или картинки, кабинет старается связать их с загруженными материалами базы знаний.

Статусы карточек

На карточках могут быть статусы:

• "Неактивно" - ресурс выключен и может не использоваться в ответах.
• "Обработка" или "Обработка: N%" - файл ещё извлекается или индексируется; нажмите индикатор, чтобы увидеть подробности.
• "Ошибка обработки" - текст не удалось подготовить; откройте индикатор, проверьте причину и повторите загрузку при необходимости.
• "Без извлечения текста" - файл сохранен, но текст не извлечен для поиска.

Материал со статусом «Обработка» ещё не участвует в поиске и ответах агента. Само извлечение выполняется на сервере и автоматически продолжается после кратковременного перезапуска, поэтому обновлять страницу или загружать файл заново не нужно.

У изображения вместо текстового редактора показываются сама картинка и результат распознавания. Статус может означать, что описание ещё готовится, обработка завершилась ошибкой, описание готово или распознавание не запускалось. AI-описание доступно для проверки, но редактировать его как Markdown-текст нельзя.

Удаление материалов

Удаление элемента нельзя отменить через обычную форму. Перед удалением важно проверить, не подключен ли этот файл, папка или таблица к агенту. Если ресурс уже привязан к агенту, сначала откройте настройки агента и проверьте блок "База знаний".

Для перемещения нескольких выбранных материалов нажмите "Переместить", выберите папку назначения и подтвердите действие через кнопку перемещения. Для массового удаления используйте "Удалить" и отдельное подтверждение.

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

Если нужно перенести материалы в другой проект, выберите элементы и используйте «Скопировать» или «Поделиться». Эти действия создают пакет ресурсов, а импорт пакета отображается как фоновый процесс.

Если знания не попадают в ответы

Проверьте по порядку:

1. Ресурс существует в "Настройки" -> "База знаний".
2. Ресурс активен и не находится в ошибке обработки.
3. Файл или папка привязаны к нужному агенту.
4. Для агента включено право "Получать данные".
5. Если вопрос связан с картинкой, PDF или другим файлом, такой материал тоже загружен, активен и подключен к агенту.
6. Если вопрос связан с элементом сайта, есть ли отдельная статья или инструкция, которая описывает этот элемент.
7. Если документ ссылается на картинку или файл, целевой материал действительно есть в базе знаний и ссылка в Markdown написана верно.
8. После изменения документа ответ был проверен на реальном вопросе.