Справочники

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

Когда клиент задаёт вопросы вашему Агенту, например "какой у вас юридический адрес?", "доставляете ли вы за пределы города?" или "сколько стоит букет красных роз?", Справочники — это отличное решение для того, чтобы предоставить ему чёткий и заранее заготовленный вами ответ, не прибегая к использованию Таблиц или добавлению этой информации в промпт (инструкцию).

Каждый Справочник построен по схеме пара "вопрос-ответ" (или "ключ-значение"), где любая пара соответствует определённой информации. Они работают быстро и безошибочно, практически не нуждаясь в настройке. Такой формат идеален для типовых запросов клиентов, предоставлении информации по услугам, хранения ссылок и многих других стандартных задач.

Справочники или База Знаний?

Давайте разберём, в чём преимущество Справочников над Базой знаний на примере студента на экзамене.

База знаний

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

База знаний — это поиск вслепую. Семантический поиск по всем конспектам сразу.

Преподаватель задаёт вопрос: "Чему равна производная функции x²?"

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

Проблемы:

• Перегрузка памяти — студент держит в голове огромное количество информации, используя весь свой "ментальный ресурс" (токены)

• "Иголка в стоге сена" — нужная формула теряется среди массы других

• Путаница — студент начинает мешать конспекты по производным с конспектами по интегралам, а значит может применить не ту формулу

• Постоянная нагрузка — при каждом новом вопросе он снова перелопачивает все конспекты, даже когда это не нужно

Справочники

Справочники работают по-другому.

Студент заранее подготовился: создал шпаргалку, где записал, в какой тетради что лежит: "Производные — синяя тетрадь", "Интегралы — красная тетрадь", "Тригонометрия — белая тетрадь". Саму шпаргалку он держит перед глазами, а тетради лежат рядом.

Теперь при вопросе про производную:

1. Смотрит в шпаргалку — нужна синяя тетрадь

2. Берёт только эту тетрадь — не все конспекты сразу

3. Открывает нужную формулу и читает: производная x² = 2x

4. Отвечает точно, не путаясь с интегралами или другими темами

Плюсы:

• Экономия ресурсов — в голове только шпаргалка-оглавление, а не все конспекты

• Обращение только когда нужно — берёт тетрадь, только если вопрос этого требует

• Нет путаницы — работает только с одной темой, не смешивает формулы

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

Итого: почему Справочники лучше

Если отбросить метафоры, использование Справочников удобнее и правильнее по нескольким причинам:

✓ Значительная экономия токенов — контекст многократно меньше, что напрямую снижает стоимость работы агента

✓ Меньше ошибок и глюков — большой контекст из Базы знаний приводит к "галлюцинациям", путанице и неправильным ответам. Справочники решают эту проблему, ограничивая содержание контекста

✓ Предсказуемость — вы точно знаете, какой ответ получит клиент, без искажений от нейросети

✓ Контроль использования — справочник вызывается только когда действительно нужен, в отличие от БЗ, которая загружается при каждом сообщении

Создание справочника

Зайдите в меню Источники знаний, раздел "Справочники". Нажмите кнопку "Добавить категорию", чтобы выбрать тип справочника.

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

Вы можете воспользоваться готовыми шаблонами или создать свой справочник с помощью ИИ* (*инструкция находится ниже на этой же странице).

Существуют готовые шаблоны разных категорий:

1. Вопрос-ответ Универсальный шаблон для создания собственных пар вопросов и ответов

2. Информация о компании Шаблон для ответов на вопросы о компании (почта, адрес, доставка, цены)

3. Каталог услуг Шаблон для информации об услугах с описанием и стоимостью

4. Каталог тем Универсальный шаблон: тема → краткая информация (текст, ссылка или список)

5. Каталог товаров Шаблон для информации о товарах с ценами и характеристиками

6. Каталог мед. курсов Шаблон для информации об образовательных медицинских программах

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

Создайте справочник нужной вам категории, например, Вопрос-ответ. После создания, вы окажетесь внутри шаблона нового Справочника.

Давайте разберём каждый блок по отдельности:

Блок Техническое имя функции

В этом блоке мы видим Техническое имя функции — get_question_answer Оно нужно для более точной работы со справочником. Чтобы ИИ-агент правильнее использовал справочник и реже ошибался, рекомендуется добавить текст из поля "Пример использования в промпте" внутрь вашей инструкции для агента.

Блок Использование ответа

Здесь мы задаём, как ИИ-агент будет использовать найденный ответ:

• в виде Результата функции — тогда ИИ-агент получает найденный результат и генерирует на его основе свой ответ.

• или в виде готового Сообщения пользователю — в этом случае найденный результат передаётся напрямую из ячейки ответа, без изменений и обработки ИИ-агентом.

Блок Записи

Именно здесь находятся пары вопрос-ответ (ключ-значение).

Изначально, в зависимости от выбранного вами шаблона, они будут заполнены определённой информацией. Например, вопросом Как мне отменить заказ? и ответом на этот вопрос.

• Кнопка ДОБАВИТЬ ЗАПИСЬ позволяет добавить свою пару вопрос-ответ.

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

• Чтобы удалить любую пару, нажмите на иконку красной мусорной корзины у правой стороны поля. Для удаления нескольких записей выберете их с помощью чекбоксов и нажмите на красную кнопку УДАЛИТЬ ВЫБРАННЫЕ

• Кнопка ДОБАВИТЬ НЕСКОЛЬКО позволяет начать Массовое добавление записей.

Массовое добавление записей

С помощью массового добавления вы можете добавлять больше одной записи за раз, вводя их вручную или, например, воспользовавшись готовыми парами вопрос-ответ из Excel.

Нажмите на кнопку ДОБАВИТЬ НЕСКОЛЬКО — откроется мастер добавления записей.

Выберите пары вопрос-ответ, например, из Excel-файла или Google Sheets и вставьте их в окно. Убедитесь, что у вас есть две колонки:

• Первая колонка — вопросы

• Вторая колонка — ответы на эти вопросы

Внизу вы увидите предпросмотр добавленных пар. Если попадутся дублирующиеся пары, они будут игнорироваться. Разделителем для ключевых пар также может выступать точка с запятой или запятая.

Если вас устраивает результат, жмём кнопку добавить. И вот, пары уже добавлены.

Если вы испытываете трудности с мастером Массового добавления записей, нажмите на кнопку КАК ЭТО РАБОТАЕТ? и следуйте подробным инструкциям

Создание справочника с помощью ИИ

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

Для этого нажмите кнопку СОЗДАТЬ С ПОМОЩЬЮ ИИ. Откроется окно создания справочника с помощью ИИ:

1. Необходимо дать описание справочника, например: Каталог мороженого с информацией о составе, цене и весе

2. В блоке пример данных опишите как должны выглядеть данные в вашем справочнике (опционально):

   • Наименование

   • Состав

   • Цена

   • Производитель

   • Вес

   

Нажимаем СОЗДАТЬ СПРАВОЧНИК.

ИИ сгенерирует готовый вариант, вы можете проверить его, и, если необходимо, что-то поменять с помощью кнопки ИЗМЕНИТЬ И СОЗДАТЬ ЗАНОВО. Если же нас всё устраивает, нажмём СОЗДАТЬ СПРАВОЧНИК.

Итак, ваш Справочник, сгенерированный с помощью ИИ, готов! Как обычно, рекомендуем добавить инструкцию из блока Техническое имя функции и добавить её в промпт, чтобы ИИ-агент лучше ориентировался в том, когда ему использовать именно этот Справочник.

Тестирование справочника

Давайте проверим, как ИИ-агент пользуется новыми справочниками.

Откроем Тестовый чат в NEXTBOT и зададим типичные вопросы из вашего справочника. Например:

— Сколько стоит шоколадное мороженое? или Есть ли молоко в составе орехового мороженого?

Агент будет искать совпадения в полях «Вопрос» сразу во всех ваших справочниках. Если найдёт точный или близкий вариант — вернёт подготовленный ответ.

Проверьте также, как влияет настройка Использование ответа.

Если мы установим Результат функции — агент сформулирует ответ своими словами на основе найденного результата. Но, если установить Сообщение пользователю, то ответ будет отправлен шаблоном напрямую и без изменений.

Мы рекомендуем практически всегда выбирать опцию Результат функции, чтобы ИИ-агент отвечал как живой человек и подстраивался под контекст общения, а не просто выдавал справочную информацию, как работ (см. скриншот ниже)

Важный момент

При необходимости, вы можете добавить множество справочников. Например, первый — это каталог мороженого с описанием состава, цен и так далее, а второй - справочник типа вопрос-ответ, где вы будете хранить информацию о сроках доставки, о её стоимости или о чём угодно. В таком случае, ИИ-агент сможет искать информацию сразу в нескольких справочниках. Например, если клиент спросит состав определённого мороженого и условия доставки по городу (одним сообщением), ИИ-агент проверит и выдаст клиенту информацию сразу из двух справочников и всё это в рамках одного ответа, что очень удобно. Вот пример ответа сразу на два вопроса из двух разных справочников: