База знаний

База знаний позволяет агенту отвечать на основе ваших материалов: документов компании, инструкций, руководств, описаний услуг, условий доставки и других документов. Агент сам находит в них нужную информацию и опирается на неё в ответе.

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

1. Вы загружаете документы — файлом или просто вставляете текст.
2. Платформа обрабатывает ваши документы: разбивает на небольшие фрагменты и переводит в числовой формат, понятный ИИ-агенту. Этот перевод называется эмбеддинг — именно благодаря ему агент умеет искать по смыслу, а не по точному совпадению слов.
3. Клиент задаёт вопрос, агент находит в ваших документах самые близкие по смыслу фрагменты и отвечает, опираясь на них, а не придумывает информацию.

Клиент может задать вопрос своими словами — «А вы до Казани возите грузы?» — и агент найдёт нужный кусок из вашего документа про доставку, даже если слова в вопросе и в документе разные.

Создание базы знаний

Пока базы нет, на вкладке есть одна кнопка — «+ Добавить базу знаний». Она открывает окно создания.

В окне нужно заполнить три вещи:

1. Название базы знаний — внутреннее имя, его видите только вы в личном кабинете
2. Модель для эмбеддинга — модель, которая переводит ваши тексты в понятный ИИ-агенту формат. По умолчанию выбрана российская модель от Яндекса, остальные помечены «скоро подключим»
3. Пакет токенов — токены используются для эмбеддинга (преобразования текстовых документов в векторный формат, понятный ИИ-агенту) текстовых файлов, которые вы загрузите в базу знаний и для эмбеддинга запросов, которые вы будете отправлять агенту для поиска по вашей базе знаний.

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

У одного агента может быть одна база знаний. Внутри одной базы знаний может быть неограниченное количество документов. Как только база создана, кнопка «+ Добавить базу знаний» пропадает. Если нужна другая база — старую можно удалить и создать новую.

Добавление документов в базу знаний

Кнопка «Добавить документ в базу» открывает окно загрузки документа.

1. Название документа — обязательное поле. Короткое имя, по которому вы найдёте документ в списке базы знаний. Например: «режим работы», «условия доставки», «прайс»
2. Ссылка на источник — необязательное поле. URL-адрес страницы, откуда взят текст документа. Если его указать, агент, ответив по этому документу, добавит ссылку в конец ответа в таком формате: «Подробнее: https://example.com/dostavka» - чтобы пользователь мог изучить подробности.
3. Загрузка файла — перенесите файл мышкой в пунктирную рамку или нажмите на неё и выберите файл. Поддерживаются форматы .txt, .md, .docx и .pdf, размер — до 10 МБ
4. Или вставьте текст документа — если файла нет, просто вставьте текст в это поле

После нажатия «Загрузить» документ появляется в списке документов со статусом «Обработка» — платформа обрабатывает его для дальнейшего использования агентом. Обычно это занимает несколько секунд, статус обновляется сам, страницу перезагружать не нужно.

Список документов

Нажмите на строку с названием базы или на стрелку справа, чтобы раскрыть «Список документов».

Напротив каждого документа есть:

1. иконка со стрелкой рядом с названием — открывает ссылку на источник, если вы её указали при загрузке документа
2. иконка глаза — «смотреть текст документа». Показывает текст ровно в том виде, в каком его прочитала платформа. Удобно, чтобы убедиться, что файл распознан правильно

3. иконка корзины — удаляет документ из базы
4. две цифры через дробь (например, 1800/250) — на фрагменты какой длины разбит этот документ и насколько соседние фрагменты перекрывают друг друга

Если с файлом что-то пошло не так, вы увидите предупреждающий значок:

1. жёлтый треугольник, «Файл распознан частично» — часть текста прочитать удалось, часть нет. Откройте документ по иконке глаза и посмотрите, всё ли на месте
2. красный треугольник, «Файл не распознан» — прочитать текст не удалось. Чаще всего так бывает с PDF-файлами, которые на самом деле являются картинками (отсканированные документы, фотографии страниц). Такой документ лучше удалить и загрузить текстом

Какие документы загружать в базу знаний

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

Чем аккуратнее и понятнее исходный текст, тем точнее агент опирается на него.

Токены базы знаний: за что вы платите

Использование «Базы знаний» для ответов ИИ-агента на вопросы клиентов - это отдельная платная опция на платформе jetAgent. Чтобы «База знаний» работала - необходимо приобретать токены для базы знаний, которые обеспечивают её работу.

Токены базы знаний — это отдельный счётчик, никак не связанный с оплатой ответов LLM-модели.

Токены базы знаний тратятся только на две вещи:

• на обработку документов, которые вы загружаете в базу знаний
• на обработку каждого вопроса клиента, если включена опция «Использовать базу знаний для ответов агента» (чтобы найти ответ в документах, вопрос клиента тоже нужно перевести в тот самый числовой формат — так же, как при загрузке документа)

Доступны два пакета:

• Тестовый пакет — 10 000 токенов за 100 ₽ на 30 дней. Даётся один раз за всё время, чтобы попробовать, как работает база знаний. Этого хватит примерно на 10 страниц А4
• Основной пакет — 10 млн токенов за 500 ₽ на 30 дней. Этого хватит примерно на 10 000 страниц А4

В карточке базы знаний всегда видно две цифры:

1. сколько токенов из пакета уже израсходовано и сколько всего было в пакете.
2. дата «Тариф до …», до которой пакет действует.

Когда токены почти закончились или срок подходит к концу, цифры подсвечиваются оранжевым.

Умное управление токенами

Рядом с названием базы знаний есть переключатель «Умное управление токенами». Он включён по умолчанию и нужен, чтобы база не выключилась в самый неподходящий момент.

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

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

Включение и отключение базы знаний

Вы можете самостоятельно управлять тем, должен ли агент использовать «Базу знаний» для поиска ответов на вопросы клиентов или нет. Для этого используется переключатель «Использовать базу знаний для ответов агента».

Если вам временно требуется отключить использование «Базы знаний», то просто переведите переключатель в положение выключено

• Включено — агент при каждом вопросе клиента сначала ищет ответ в вашей базе знаний
• Выключено — база знаний остаётся в кабинете вместе со всеми документами, но агент её не использует и отвечает только по промпту

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

• «База знаний не используется» — переключатель «Использовать базу знаний для ответов агента» выключен, агент базу не использует
• «Документы для базы знаний не добавлены» — ни один документ не загружен, агенту пока нечего использовать для поиска
• «Токены базы знаний закончились — база не работает» — пакет израсходован или истёк его срок. Пока это так, переключатель наверху заблокирован: сначала нужно купить новый пакет. Рядом с текстом стоит синяя кнопка с корзиной — она сразу открывает окно покупки
• «Токены базы знаний почти закончились — осталось меньше 1% пакета» — всё настроено и работает, но пакет подходит к концу. Самое время докупить токены или проверить, что на балансе платформы хватит денег на автоматическое продление

У каждой плашки справа есть значок «?» — наведите на него, чтобы увидеть, что именно нужно сделать.

Настройки базы знаний

Иконка с ключом в карточке базы открывает окно «Настройки базы знаний».

Общие настройки Базы знаний

Здесь собрано всё про саму базу и её оплату:

1. Название базы знаний — можно переименовать в любой момент, сохраняется автоматически
2. Модель эмбеддинга — показывает, какая модель обрабатывает ваши тексты. Она выбирается при создании базы и потом не меняется
3. Токены — сколько израсходовано из пакета и сколько всего было
4. Пакет токенов действует до — дата окончания текущего пакета
5. Умное управление токенами — тот же переключатель, что и в карточке базы
6. Кнопка покупки пакета — докупить 10 млн токенов на 30 дней, не дожидаясь, пока закончатся текущие

Расширенные настройки

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

Текст ответа агента, если информация не найдена в базе. То, что агент скажет клиенту, когда в документах нет ничего подходящего. Заполните это поле своими словами, в стиле вашей компании. Например: «К сожалению, у меня нет информации по этому вопросу. Давайте я передам его менеджеру?».

Сколько фрагментов брать для ответа (Top K) — сколько фрагментов базы знаний агент возьмёт для ответа на один вопрос. По умолчанию — 5, можно поставить от 1 до 20.

• меньше значение — ответы короче и точнее, но агент может не увидеть нужный кусок
• больше значение — агент видит больше материала, но ответы становятся расплывчатее, а каждый запрос обходится дороже

Размер фрагмента (Chunk Size) — на фрагменты какой длины (в символах) режется текст при загрузке документа. По умолчанию — 1800, можно поставить от 200 до 4000.

• меньше значение — поиск точнее попадает в конкретный факт (подходит для прайсов и списков вопрос-ответ)
• больше значение — в каждом фрагменте сохраняется больше контекста (подходит для статей и регламентов)

Наложение фрагментов (Chunk Overlap) — сколько символов соседние фрагменты делят между собой, чтобы мысль не обрывалась на стыке. По умолчанию — 250, можно поставить от 0 до 500. Наложение всегда меньше размера фрагмента (Chunk Size): если вы уменьшите размер фрагмента, наложение уменьшится следом автоматически.

Удаление базы знаний

Красная иконка корзины справа в карточке базы удаляет базу знаний целиком — вместе со всеми загруженными документами.

Как проверить, что всё работает

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

Если агент отвечает не то, что нужно:

• убедитесь, что переключатель «Использовать базу знаний для ответов агента» включён, а документы в списке — в обычном состоянии, без предупреждающих значков
• откройте документ по иконке глаза и проверьте, что текст распознался целиком
• попробуйте увеличить «Сколько фрагментов брать для ответа (Top K)» в расширенных настройках
• добавьте в промпт агента указание опираться на базу знаний и не придумывать ответ, если в ней ничего не нашлось