База знаний

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

Откройте базу знаний

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

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

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

Добавьте первый материал

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

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

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

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

Затем подключите материалы к агенту. Для большого набора создайте папки; поиск, перемещение и удаление описаны в управлении материалами.

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

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

• Файл - документ базы знаний. Может быть создан вручную или получен из загруженного файла: Markdown, TXT, DOCX, PDF или другой поддержанный формат.

• Изображение — отдельный материал для ответов и поиска. Проверьте изображение и AI-описание.

• Таблица - структурированные данные, которые открываются в отдельном редакторе таблиц.

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

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

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

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