Документация/База знаний

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

Обновлено 23 сентября 2026 г.

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

База знаний общая на организацию — раздел «База знаний» в левом меню. Все агенты видят её целиком, если вы не скрыли от конкретного агента какие-то разделы (см. статью «Что из базы знаний видит агент»).

Из чего состоит

  • Разделы — папки для порядка: «Цены», «Доставка», «Гарантия». Могут быть вложенными.
  • Материалы — сам контент внутри раздела: текст, набранный вручную, или загруженный файл.
  • Сайты — отдельный блок ниже: ваш сайт сканируется целиком, каждая страница становится материалом.

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

Комментарий к материалу

У каждого материала есть необязательное поле «Комментарий» — контекст, которого нет в самом тексте: «цены без НДС», «касается только новых двигателей», «актуально до конца года». Агент видит комментарий вместе с каждым фрагментом материала.

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

Когда клиент задаёт вопрос, агент сам решает, стоит ли посмотреть в базу знаний, и ищет по смыслу — не по точным словам. Находит самые подходящие фрагменты и отвечает по ним. В «Диалогах» под ответом видно, какие материалы агент использовал — можно проверить, откуда взялась цифра.

Этот инструмент включён у агента по умолчанию — тумблер на вкладке «База знаний» карточки агента.

Индексация

Добавленный материал не сразу доступен агенту: сначала он разбивается на фрагменты и индексируется в фоне. Обычно это секунды, у больших файлов — минуты. Статус виден рядом с материалом; если что-то пошло не так, кабинет покажет ошибку.

Действия

  • «+ Раздел», «+ Материал», «+ Сайт» — кнопки сверху. Пока в базе нет ни одного раздела, «+ Материал» сначала предложит его создать (окно «Сначала создайте раздел») — материал не может быть без раздела.
  • «⋯» у раздела или материала — переименовать, удалить.
  • Клик по материалу — просмотр: путь, статус, комментарий и полный текст.

Совет. Начните с сайта — это самый быстрый способ наполнить базу. Потом добавляйте то, чего на сайте нет: внутренние регламенты, ответы на частые вопросы, прайс из файла.