База знаний
База знаний хранит материалы для ответов: инструкции, файлы, таблицы, FAQ, описания продукта и рабочие регламенты. Важно не только загрузить документ, но и привязать его к нужному агенту с правильными правами.
Страница находится в настройках проекта и показывает дерево ресурсов: папки, файлы и таблицы. Вверху есть поиск, счетчик показанных элементов, хлебные крошки текущей папки и кнопка добавления материала.
Основные действия
- искать материалы по названию и содержимому;
- открывать папки и возвращаться в корень базы знаний;
- создавать папки для группировки материалов;
- создавать текстовые документы прямо в кабинете;
- создавать таблицы для структурированных данных;
- загружать файлы и ZIP-архивы;
- открывать меню материала, затем переименовывать или редактировать его;
- открывать созданные таблицы в редакторе;
- копировать выбранные материалы в другой проект;
- создавать ссылку для передачи выбранных материалов;
- удалять устаревшие элементы с отдельным подтверждением.
Для текущей папки доступно редактирование: измените название и нажмите "Сохранить".
Типы ресурсов
- Папка - контейнер для файлов и таблиц. Если папку привязать к агенту, текущие и будущие элементы внутри нее будут доступны в ответах этого агента.
- Файл - документ базы знаний. Может быть создан вручную или получен из загруженного файла: Markdown, TXT, DOCX, PDF или другой поддержанный формат.
- Изображение - отдельный материал базы знаний, который можно использовать рядом с Markdown-инструкциями и в предпросмотре документа.
- Таблица - структурированные данные, которые открываются в отдельном редакторе таблиц.
Markdown-файлы могут хранить метаданные в frontmatter: например ID документа, маршрут раздела или источник. Эти данные помогают поиску и связке с нужным материалом, но не заменяют понятный текст самой инструкции. Если Markdown содержит ссылки или картинки, кабинет старается связать их с загруженными материалами базы знаний.
Статусы карточек
На карточках могут быть статусы:
- "Неактивно" - ресурс выключен и может не использоваться в ответах.
- "Обработка" или "Обработка: N%" - файл ещё извлекается или индексируется; нажмите индикатор, чтобы увидеть подробности.
- "Ошибка обработки" - текст не удалось подготовить; откройте индикатор, проверьте причину и повторите загрузку при необходимости.
- "Без извлечения текста" - файл сохранен, но текст не извлечен для поиска.
Удаление материалов
Удаление элемента нельзя отменить через обычную форму. Перед удалением важно проверить, не подключен ли этот файл, папка или таблица к агенту. Если ресурс уже привязан к агенту, сначала откройте настройки агента и проверьте блок "База знаний".
Для перемещения нескольких выбранных материалов нажмите "Переместить", выберите папку назначения и подтвердите действие через кнопку перемещения. Для массового удаления используйте "Удалить" и отдельное подтверждение.
При массовом удалении или перемещении проверяйте фоновые процессы и историю событий: такие операции могут выполняться последовательно, а интерфейс не всегда показывает подробный прогресс по каждому элементу.
Если нужно перенести материалы в другой проект, выберите элементы и используйте «Скопировать» или «Поделиться». Эти действия создают пакет ресурсов, а импорт пакета отображается как фоновый процесс.
Если знания не попадают в ответы
Проверьте по порядку:
- Ресурс существует в "Настройки" -> "База знаний".
- Ресурс активен и не находится в ошибке обработки.
- Файл или папка привязаны к нужному агенту.
- Для агента включено право "Получать данные".
- Если вопрос связан с картинкой, PDF или другим файлом, такой материал тоже загружен, активен и подключен к агенту.
- Если вопрос связан с элементом сайта, есть ли отдельная статья или инструкция, которая описывает этот элемент.
- Если документ ссылается на картинку или файл, целевой материал действительно есть в базе знаний и ссылка в Markdown написана верно.
- После изменения документа ответ был проверен на реальном вопросе.
Где это в интерфейсе
Основные элементы раздела:
- кнопка добавления материала в базу знаний
- кнопка создания папки
- поле названия папки
- вкладка папки
- материал базы знаний
- страница базы знаний
- поле поиска по базе знаний
- страница настроек проекта
- пункт «Настройки» в боковом меню