> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/getting-started/kak-nachat/napolnenie-bazy-znanii.md). # Наполнение Справочника **Справочник** — это хранилище информации (как «умная» записная книжка. В этой книжке хранится проверенная и нужная информация, разложенная по полочкам, как закладки в браузере), которое используется для ответов на запросы. Она помогает ИИ-агенту быстрее и точнее находить наиболее подходящие реальные данные. ### **Для чего нужен Справочник и в чём его преимущество?** Зачем выносить данные в Справочник? Большой объём несвязанных данных в инструкции агента (промпте) может: * Перегружать ИИ-агента — лишняя информация мешает фокусироваться на запросе * Снижать скорость обработки — каждый лишний символ в промпте увеличивает время и стоимость ответа **Решение** — вынести ситуативную информацию (адреса, графики, каталог товаров) в **Справочник.** **Как это работает?** 1. **Инструкция ИИ-агента** ([промпт](/functional/setting-up-agent/system-prompt.md)) содержит только **основные правила** поведения агента (роль, стиль общения, ограничения). 2. **Справочник** хранит факты (цены, контакты, акции) **отдельными блоками**. 3. ИИ подгружает данные из Справочника **только когда они нужны**. **Пример:** * Клиент спрашивает *«Сколько стоит килограмм говяжьего фарша?»* -> ИИ-агент ищет ответ в определённом блоке Справочника (**не анализируя** адрес или другую информацию магазина из другого блока справочника). * Клиент уточняет *«Где ваш магазин?»* -> ИИ-агент подтягивает адрес из Справочника, игнорируя ненужные сейчас цены. Справочник — это «внешний жёсткий диск» для агента. Промпт — его «мозг». Разделение делает систему **быстрее, точнее и дешевле**. ### Примеры заполнения Справочника #### Категория Вопрос - ответ: * **Вопрос: Расположение магазина**\ В **Ответ** добавим**:** * Наш адрес: г. Москва, ул. Сочная, д. 10, ТЦ "Мясной стиль", 1 этаж. * Часы работы: ежедневно с 9:00 до 21:00. * Телефон: +7 (495) 123-45-67. * **Вопрос: Цены на продукцию.**\ В **Ответ** добавим**:** * Стейк Рибай: 2000 руб./кг. * Филе Миньон: 2500 руб./кг. * Томагавк: 3000 руб./кг. * Говяжий фарш: 800 руб./кг. * **Вопрос: Условия доставки**\ В **Ответ** добавим**:** * Бесплатная доставка при заказе от 5000 руб. * Стоимость доставки по Москве: 300 руб. * Доставка в течение 1-2 дней после оформления заказа. * **Вопрос: Состав продуктов**\ В **Ответ** добавим**:** * Мраморная говядина: высший сорт, откормленных исключительно травой. * Фарш: приготовлен из чистой говядины, без добавок. * **Вопрос: Акции и скидки**\ В **Ответ** добавим**:** * Скидка 10% на первый заказ. * Каждый пятый заказ — подарок (на выбор: 1 кг фарша или 500 г Рибай). * **Вопрос: Способы оплаты**\ В **Ответ** добавим**:** * Наличный расчёт курьеру. * Онлайн-оплата на сайте. * Оплата через банковский перевод. * **Вопрос: Сертификаты и стандарты качества**\ В **Ответ** добавим**:** * Продукция сертифицирована по стандартам ГОСТ. * Все мясные изделия проходят обязательный контроль на соответствие санитарным нормам. * Наша компания сотрудничает только с фермами, использующими органическое кормление. * **Вопрос: Контакты для партнёров**\ В **Ответ** добавим**:** * Электронная почта для сотрудничества: . * Телефон отдела оптовых продаж: +7 (495) 987-65-43. * **Вопрос: Поставщики**\ В **Ответ** добавим**:** * Ферма "Зелёный луг" (Воронежская область) — мраморная говядина. * Фермерское хозяйство "Травяной край" (Калужская область) — экологически чистая продукция. * **Вопрос: Способы сотрудничества**\ В **Ответ** добавим**:** * Оптовые поставки говядины для ресторанов. * Специальные предложения для корпоративных клиентов. * Индивидуальные условия для постоянных заказчиков. * **Вопрос: Отличия от конкурентов**\ В **Ответ** добавим**:** * Мы предлагаем только охлаждённое мясо, без заморозки. * Работаем напрямую с фермами, минуя посредников. * Возможность заказать эксклюзивные отрубы под индивидуальные потребности. * **Вопрос: Физическая инфраструктура**\ В **Ответ** добавим**:** * Основной склад: г. Москва, промзона Северная, ул. Производственная, д. 5. * Логистический центр: Московская область, Люберцы, ул. Логистическая, д. 12. * **Вопрос: Политика возвратов и замен**\ В **Ответ** добавим**:** * Возврат возможен в течение 24 часов после получения заказа при наличии брака. * В случае недовеса или повреждения упаковки заменяем товар бесплатно. #### Далее на [странице](https://app.nextbot.ru/embeddings?tab=FaqKnowledge) Справочник добавляем категорию Вопрос - ответ и заполняем ее. Кнопка **"Добавить запись"** — создает одну пару "вопрос-ответ". Кнопка **"Добавить несколько"** — вносит сразу несколько "вопросов и ответов" списком. Также можно загружать данные из **Excel** или **Google Sheets** (следуйте инструкции в форме). Поддерживаются ячейки, в которых информация размещена на нескольких строках.
{% hint style="warning" %} **Не забудьте удалить из инструкции повторяющиеся данные, которые вы вынесли в Справочник** {% endhint %} [**Пробуем**](https://app.nextbot.ru/chat)**:** Если пользователь спросит: *"Как к вам добраться?"*\ ИИ-агент ответит как из блока Ответ. Т.е он откроет закладку "Расположение магазина" и выдаст точный ответ.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.nextbot.ru/getting-started/kak-nachat/napolnenie-bazy-znanii.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.