База знаний

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

• Страница сайта – по адресу.
• Файл – txt, md, pdf, docx, xlsx, csv, до 10 МБ. Прайс в Excel или CSV подходит как есть.
• Текст – короткий FAQ или условия можно просто вставить, без файла.
• Папка – целиком, с подпапками (на компьютере).

1. Откройте агента и нажмите «Добавить материалы» в блоке «Откуда знает».
2. Внизу раскроется «База знаний» – там все способы добавления.

1. В поле «https://пример.рф/страница» введите адрес нужной страницы и нажмите «Добавить страницу».
2. Платформа прочитает текст страницы. Статус сменится с «Обрабатываю…» на число символов.

Добавляйте конкретные страницы (с ценами, условиями, контактами), а не только главную – так агент найдёт нужное точнее. Страница читается один раз, в момент добавления: если на сайте что-то изменилось, удалите источник и добавьте страницу заново. Если страница не читается (сайт целиком собирается скриптами), скопируйте нужный текст и вставьте его в поле «Вставить текст».

1. Нажмите на область «Перетащите файл сюда» и выберите файл или перетащите его туда. На телефоне область называется «Выбрать файл».
2. Подходят: txt, md, pdf, docx, xlsx, csv. Размер файла – до 10 МБ.
3. Файл загрузится и прочитается сам. Когда статус сменится на число символов, агент уже опирается на него.

PDF должен быть с текстом: отсканированные страницы (картинки) платформа читать не умеет. Откройте PDF и попробуйте выделить текст мышью – если не выделяется, это скан. В таком случае перепечатайте нужное и вставьте в «Вставить текст». Презентации (.ppt, .pptx) и старые таблицы (.xls) не читаются: сохраните таблицу как .xlsx или .csv, а из презентации скопируйте текст.

Таблица читается построчно: первая заполненная ячейка строки – это позиция (название товара или услуги), остальные значения подписываются заголовком столбца. Например, строка «Женская стрижка | 1500 | 60» с заголовками «Услуга | Цена | Время» превращается в «Женская стрижка: Цена = 1500; Время = 60».

• Заголовки столбцов в первой строке (можно под названием прайса) – так агент поймёт, что значит каждое число.
• Название раздела («Стрижки», «Окрашивание») пишите в строке из одной ячейки и отделяйте пустой строкой от предыдущего раздела: тогда оно добавится к позициям под ним. Строка из одной ячейки без этого остаётся отдельной позицией, например «Консультация» без цены.
• Даты и проценты читаются как даты и проценты. Формулы – по последнему сохранённому результату: перед загрузкой откройте и сохраните файл в Excel.
• Скрытые листы не читаются. Если в файле несколько листов, каждый подписывается своим названием.
• Картинки, цвета и объединённые ячейки платформа не учитывает: держите данные в обычных строках и столбцах.

1. Нажмите «Вставить текст».
2. Введите название (например, «Частые вопросы»; можно не писать – возьмётся начало текста) и вставьте сам текст.
3. Нажмите «Добавить текст». Он появится в списке источников и сразу готов.

За один раз – до 50 000 знаков. Длиннее – разделите текст на части и добавьте их отдельными источниками.

1. Перетащите папку в область «Перетащите папку сюда» или нажмите на неё и выберите папку.
2. Браузер покажет предпросмотр: сколько подходящих файлов найдено и их общий объём. Нажмите «Импортировать».
3. Папка отображается группой в списке источников: её можно свернуть или удалить целиком.

Если содержимое папки изменилось, нажмите «Обновить из папки» в заголовке группы: платформа сравнит файлы и предложит добавить новые, обновить изменённые и убрать удалённые. Выбор папки работает только на компьютере: на телефоне и планшете эта область не показывается, загружайте файлы по одному.

Из одного источника читается не больше 50 000 знаков – это примерно 30 страниц текста. Всё, что дальше, агент не знает. Платформа не скрывает этого: у такого источника в списке появится жёлтая строка вроде «Прочитано 50 000 знаков из 120 000» и совет.

Разделите длинный документ или прайс на несколько файлов (по разделам или по категориям товаров) и загрузите их отдельными источниками – тогда в базу попадёт всё. Источников на одного агента – до 50.

Если закрыть страницу прямо во время загрузки, источник может остаться в состоянии «Обрабатываю…». Через 5 минут вместо этого появится «Не обработался» и кнопка «Повторить»: нажмите её, и платформа прочитает файл заново. Не помогло – удалите источник и загрузите файл снова.

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

• «Экономно» – до 2 000 знаков.
• «Обычно» – до 3 000 знаков.
• «Максимум» – до 8 000 знаков.

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

1. В списке источников нажмите корзину справа от нужного.
2. Чтобы убрать папку целиком, нажмите корзину в заголовке группы.