Документация › Инструменты бота › База знаний

База знаний (RAG)

Обновлено 4 октября 2026 г.

Сюда грузишь факты о бизнесе (прайс, услуги, условия): бот сам подмешивает нужное в ответы и перестаёт выдумывать.

⏱ 8 мин · 👤 для владельца и оператора · 🟢 live

База знаний: загрузка документов (FAQ, прайс, описание услуг), бот использует их для точных ответов через векторный поиск
База знаний: загрузка документов (FAQ, прайс, описание услуг), бот использует их для точных ответов через векторный поиск
За 30 секунд:
  • База знаний = большие справочники бизнеса: полный прайс, каталог услуг, FAQ, условия, документы. Пара цен и адрес удобнее в поле «Информация о компании»: его бот видит всегда.
  • Грузишь текст, файл (TXT/CSV/PDF/DOCX) или ссылку (URL): система сама разбивает и индексирует.
  • Бот на каждое сообщение ищет подходящие куски и добавляет их в ответ (это RAG, автоматически).
  • Лимит: 100 записей на проект (всего, не только активных), до 1 000 000 символов при вставке текстом, из файла и со страницы по ссылке извлекается до 500 000, файл до 4 МБ.
  • Короткие факты, нужные всегда, держи в «Информации о компании»; большое и меняющееся сюда (что куда класть).

Зачем это нужно

Бот знает только то, что ты ему дал. Если прайс есть лишь «в голове» у тебя, бот начнёт выдумывать цифры. База знаний даёт ему точные факты: он ищет в них релевантное под вопрос клиента и отвечает по делу, а не фантазирует. Это разница между «кажется, около 20 тысяч» и «чистка, 18 000 ₸».

Что сюда класть

Объёмное и меняющееся: полный прайс, описания услуг, FAQ, условия, документы. Короткие факты, нужные в каждом ответе (адрес, часы, ключевые услуги), лучше в поле «Информация о компании», а поведение бота в промпт. Как разложить всё по местам: Что куда класть.

Как добавить

Вкладка проекта «База знаний» → «Добавить документ».

  1. Название: понятное («Прайс услуг», «FAQ доставки»);
  2. Тип, выбери источник:
  3. Текст: вставь напрямую (до 1 000 000 символов);
  4. Файл: TXT, CSV, PDF, DOCX (до 4 МБ, текст извлечётся сам);
  5. URL, ссылка на страницу сайта (можно с глубиной сканирования: только страница / +ссылки 1-2 уровня / максимум);
  6. (для URL) Автообновление, нет / еженедельно / ежемесячно;
  7. «Добавить»: пойдёт загрузка → индексация → готово.

⚠️ Обработка документа стоит немного (около $0.01 за документ на индексацию, минимальное списание, 1¢), спишется с баланса. При добавлении показывается оценка токенов.

Как бот это использует

Тебе ничего вызывать не надо, это работает само:

  1. Клиент пишет вопрос;
  2. Бот ищет в базе знаний тремя способами сразу: по смыслу (похожие формулировки), по словам (точное совпадение: артикул, марка, название модели) и с поправкой на опечатки. Результаты объединяются, и кусок, найденный двумя способами, идёт выше;
  3. Лучшие фрагменты (в сумме до 8 000 символов) добавляются в контекст ответа;
  4. Бот отвечает, опираясь на них.

📌 Пример. В базе это прайс и условия. Клиент: «делаете отбеливание и сколько?». Бот находит строку про отбеливание → отвечает с точной ценой. Про услугу, которой в базе нет, он честно скажет, что уточнит.

📌 Пример на точные слова. Клиент спрашивает «есть мойка 8102?». По смыслу «8102» не значит ничего, и поиск только по смыслу такой вопрос проваливал. Совпадение по словам находит строку каталога сразу.

«Всегда под рукой»

У каждой записи есть кнопка-булавка. Включённая, она означает: этот документ едет боту в каждом сообщении, минуя поиск.

Это для короткой шпаргалки, которую бот обязан знать всегда: пять-семь ходовых цен, условия замера, главное правило доставки. Ограничение жёсткое: не больше 3 документов и 1500 символов на все закреплённые вместе. Платформа не даст закрепить сверх лимита и скажет, сколько осталось. Так и задумано: закреплённое оплачивается в каждом сообщении, ровно как текст промпта.

Всё остальное, полный каталог, характеристики, регламенты, частые вопросы, должно искаться. Тогда за него платишь только тогда, когда оно понадобилось.

Проверь, что работает

В разделе есть «Тест поиска»: вводишь вопрос клиента → видишь, какие фрагменты база вернёт боту, из какого раздела документа они взяты и как нашлись: по словам, по смыслу или с поправкой на опечатку. Это ровно тот поиск, что бот делает на каждое сообщение. Если по важному вопросу ничего не находит, переформулируй контент или добавь похожий.

Плюс прогони реальные вопросы в Тест-чате: там в «технических деталях» видно, какие источники бот подтянул.

Управление записями

  • Фильтры: Все / Активные / Неактивные, поиск по названию;
  • Включить/выключить запись (выключенная не участвует в поиске);
  • Булавка «Всегда под рукой»: запись едет боту в каждом сообщении мимо поиска (см. выше);
  • Массовые действия: включить/выключить/удалить выбранные;
  • Большие документы система бьёт на фрагменты: их можно посмотреть и отредактировать.

Частые ошибки

СимптомПричинаЧто делать
Бот не знает то, что я загрузилЗапись выключена или вопрос непохож на текстВключи запись; проверь «Тест поиска», переформулируй контент
«Почти лимит» / не добавляетсяБлизко к 100 записямУдали ненужные, объедини мелкие
Загрузил, но бот выдумываетФакт есть в базе, но промпт не велит на неё опиратьсяВ промпте: «цены и факты бери из базы знаний, не выдумывай»
Файл не грузитсяБольше 4 МБ или не тот форматСократи / используй TXT, CSV, PDF, DOCX

Вопросы, которые обычно возникают

Это платно?
Да, чуть-чуть: и индексация документа, и каждый поиск стоят примерно по 1¢ ($0.01). Поиск идёт на каждое сообщение, это учитывается в расходе.

Бот читает весь документ каждый раз?
Нет. Только самые подходящие фрагменты под текущий вопрос: столько, сколько влезает в 8 000 символов контекста (обычно от 3 до 15, зависит от размера кусков).

Под капотом

  • RAG (Retrieval-Augmented Generation): документы режутся на чанки, для каждого считаются векторные embeddings. На каждое сообщение клиента идёт гибридный поиск: вектора (смысл) + полнотекстовый поиск с русской морфологией (точные слова) + триграммы (опечатки), результаты объединяются рангом. В контекст попадает столько лучших чанков, сколько помещается в 8 000 символов (не больше 15). Записи со «Всегда под рукой» подмешиваются без поиска, в пределах 1500 символов.
  • Лимиты: 100 записей/проект (всего), до 1 000 000 символов при вставке текстом, из файла и URL извлекается до 500 000 (MAX_EXTRACTED_LEN_KB / MAX_PAGE_SIZE), файл 4 МБ, в промпт идёт до 8 000 символов, не больше 15 чанков.
  • Форматы: TXT, CSV, URL (с глубиной до 3 и автообновлением), PDF, DOCX. URL-скан: до 20 подстраниц, каждая = отдельная запись.
  • Стоимость: ≈$0.01 индексация документа + ≈$0.01 за поиск (на каждое сообщение); минимальное списание за эмбеддинг, 1¢.
  • Обновления списка идут в реальном времени (use-realtime-kb). RAG это не функция, а внутренний шаг пайплайна; включать/вызывать не надо.

Простыми словами

База знаний это справочник твоего бизнеса для бота: цены, услуги, условия, частые вопросы. Ты загружаешь туда текст, документ или ссылку на сайт, а бот сам, на каждый вопрос клиента, достаёт оттуда нужный кусочек и отвечает точно, не выдумывая. Короткие вещи (адрес, часы работы) проще написать в поле «Информация о компании», а вот большой прайс или список услуг: сюда. Есть кнопка «Тест поиска»: вводишь вопрос и видишь, что бот найдёт, удобно проверить, что он не промахнётся.

Дальше: → Дожимы
Связано: Системный промпт · Как бот думает · Тест-чат
Не получилось? → Бот не отвечает