# Наполнение Справочника

**Справочник** — это хранилище информации (как «умная» записная книжка. В этой книжке хранится проверенная и нужная информация, разложенная по полочкам, как закладки в браузере), которое используется для ответов на запросы. Она помогает ИИ-агенту быстрее и точнее находить наиболее подходящие реальные данные.

### **Для чего нужен Справочник и в чём его преимущество?**

Зачем выносить данные в Справочник? Большой объём несвязанных данных в инструкции агента (промпте) может:

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

**Решение** — вынести ситуативную информацию (адреса, графики, каталог товаров) в **Справочник.**

**Как это работает?**

1. **Инструкция ИИ-агента** ([промпт](https://doc.nextbot.ru/functional/setting-up-agent/system-prompt)) содержит только **основные правила** поведения агента (роль, стиль общения, ограничения).
2. **Справочник** хранит факты (цены, контакты, акции) **отдельными блоками**.
3. ИИ подгружает данные из Справочника **только когда они нужны**.

**Пример:**

* Клиент спрашивает *«Сколько стоит килограмм говяжьего фарша?»* -> ИИ-агент ищет ответ в определённом блоке Справочника (**не анализируя** адрес или другую информацию магазина из другого блока справочника).
* Клиент уточняет *«Где ваш магазин?»* -> ИИ-агент подтягивает адрес из Справочника, игнорируя ненужные сейчас цены.

Справочник — это «внешний жёсткий диск» для агента. Промпт — его «мозг». Разделение делает систему **быстрее, точнее и дешевле**.

### Примеры заполнения Справочника

#### Категория Вопрос - ответ:

* **Вопрос: Расположение магазина**\
  В **Ответ** добави&#x43C;**:**
  * Наш адрес: г. Москва, ул. Сочная, д. 10, ТЦ "Мясной стиль", 1 этаж.
  * Часы работы: ежедневно с 9:00 до 21:00.
  * Телефон: +7 (495) 123-45-67.
* **Вопрос: Цены на продукцию.**\
  В **Ответ** добави&#x43C;**:**
  * Стейк Рибай: 2000 руб./кг.
  * Филе Миньон: 2500 руб./кг.
  * Томагавк: 3000 руб./кг.
  * Говяжий фарш: 800 руб./кг.
* **Вопрос: Условия доставки**\
  В **Ответ** добави&#x43C;**:**
  * Бесплатная доставка при заказе от 5000 руб.
  * Стоимость доставки по Москве: 300 руб.
  * Доставка в течение 1-2 дней после оформления заказа.
* **Вопрос: Состав продуктов**\
  В **Ответ** добави&#x43C;**:**
  * Мраморная говядина: высший сорт, откормленных исключительно травой.
  * Фарш: приготовлен из чистой говядины, без добавок.
* **Вопрос: Акции и скидки**\
  В **Ответ** добави&#x43C;**:**
  * Скидка 10% на первый заказ.
  * Каждый пятый заказ — подарок (на выбор: 1 кг фарша или 500 г Рибай).
* **Вопрос: Способы оплаты**\
  В **Ответ** добави&#x43C;**:**
  * Наличный расчёт курьеру.
  * Онлайн-оплата на сайте.
  * Оплата через банковский перевод.
* **Вопрос: Сертификаты и стандарты качества**\
  В **Ответ** добави&#x43C;**:**
  * Продукция сертифицирована по стандартам ГОСТ.
  * Все мясные изделия проходят обязательный контроль на соответствие санитарным нормам.
  * Наша компания сотрудничает только с фермами, использующими органическое кормление.
* **Вопрос: Контакты для партнёров**\
  В **Ответ** добави&#x43C;**:**
  * Электронная почта для сотрудничества: <partners@meatstyle.ru>.
  * Телефон отдела оптовых продаж: +7 (495) 987-65-43.
* **Вопрос: Поставщики**\
  В **Ответ** добави&#x43C;**:**
  * Ферма "Зелёный луг" (Воронежская область) — мраморная говядина.
  * Фермерское хозяйство "Травяной край" (Калужская область) — экологически чистая продукция.
* **Вопрос: Способы сотрудничества**\
  В **Ответ** добави&#x43C;**:**
  * Оптовые поставки говядины для ресторанов.
  * Специальные предложения для корпоративных клиентов.
  * Индивидуальные условия для постоянных заказчиков.
* **Вопрос: Отличия от конкурентов**\
  В **Ответ** добави&#x43C;**:**
  * Мы предлагаем только охлаждённое мясо, без заморозки.
  * Работаем напрямую с фермами, минуя посредников.
  * Возможность заказать эксклюзивные отрубы под индивидуальные потребности.
* **Вопрос: Физическая инфраструктура**\
  В **Ответ** добави&#x43C;**:**
  * Основной склад: г. Москва, промзона Северная, ул. Производственная, д. 5.
  * Логистический центр: Московская область, Люберцы, ул. Логистическая, д. 12.
* **Вопрос: Политика возвратов и замен**\
  В **Ответ** добави&#x43C;**:**
  * Возврат возможен в течение 24 часов после получения заказа при наличии брака.
  * В случае недовеса или повреждения упаковки заменяем товар бесплатно.

#### Далее на [странице](https://app.nextbot.ru/embeddings?tab=FaqKnowledge) Справочник добавляем категорию Вопрос - ответ и заполняем ее.

Кнопка **"Добавить запись"** — создает одну пару "вопрос-ответ".

Кнопка **"Добавить несколько"** — вносит сразу несколько "вопросов и ответов" списком. Также можно загружать данные из **Excel** или **Google Sheets** (следуйте инструкции в форме). Поддерживаются ячейки, в которых информация размещена на нескольких строках.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FcPIR3cpjMnP1mRiAsUWG%2F%7BD1EDB70C-54FA-405D-A20E-FA0B2058ACA8%7D.png?alt=media&#x26;token=a1164c04-b094-40c0-80b8-a2b3018c3149" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Не забудьте удалить из инструкции повторяющиеся данные, которые вы вынесли в Справочник**
{% endhint %}

[**Пробуем**](https://app.nextbot.ru/chat)**:**

Если пользователь спросит: *"Как к вам добраться?"*\
ИИ-агент ответит как из блока Ответ. Т.е он откроет закладку "Расположение магазина" и выдаст точный ответ.

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FeyqdnOy0K37NgirINACs%2F%7B90F922E1-F109-49FB-A475-5EBC4D73E105%7D.png?alt=media&#x26;token=47f845bc-06df-4266-9a73-c5978acee8fd" alt=""><figcaption></figcaption></figure>
