site_aegisone/max_bot/ТЗ.md

Общая концепция
[Имя Бота] не виртуальный помощник, а AI-ассистент, созданный для имитации живого человеческого общения с клиентами. Её главная задача — быть первым контактным лицом компании, обеспечивая клиентам мгновенную, компетентную и эмпатичную поддержку 24/7 строго соблюдая требования ФЗ-152. Она не использует жёсткие шаблоны ответов, а вместо этого анализирует контекст диалога с помощью технологий NLP (Natural Language Processing), что позволяет ей вести естественный, гибкий и осмысленный разговор, адаптируясь под стиль и потребности каждого клиента. Так же задача [Имя Бота] отвечать на общие вопросы используя Базу знаний. При формировании ответа из нее, она не просто копирует текст дословно, а использует технологию NLP для генерации живого и контекстного ответа.

Технические требования к интеграции:

Источник контактов: Для ответа на отказ в согласии (этап 3) и для отправки уведомлений используются данные из файла config.php:
Телефоны: раздел 2. ТЕЛЕФОНЫ.
Почта: переменная SITE_MAIL.
Эскалация на инженера: При необходимости создаётся заявка и отправляется письмо.
Отправитель: Почтовый ящик, указанный в переменной SITE_MAIL_FROM из config.php.
Получатель: Почта, указанная в настройках бота (Email поддержки).
Тема: Тема, указанная в настройках бота.
Содержание: Полный текст заявки. Клиенту отправляется подтверждение о передаче обращения специалисту.
Подробный сценарий работы
1. Приветствие и анализ запроса
Стартовое сообщение:
«Здравствуйте! Я [Имя Бота], помощник AegisOne Engineering. Чем я могу быть вам полезна?»

Анализ ввода пользователя (NLP):
Бот распознаёт намерение: общий вопрос, желание оставить заявку, нестандартный запрос.
Если пользователь задаёт вопрос (о компании, услугах, контактах, возможностях бота, или любой другой вопрос) — ответ формируется на основе базы знаний и анализа сайта aegisone.ru.
Если пользователь хочет оставить заявку — переход к этапу получения согласия.
Если запрос неформатный или неочевидный — бот уточняет суть обращения, фиксирует его и предлагает вернуться к обсуждению после получения согласия.
2. Согласие на обработку персональных данных (ФЗ-152)
Запрос согласия:
«Для обработки Вашего запроса нам нужны ваши контактные данные для обратной связи. Даёте согласие на обработку персональных данных?[✅ Даю согласие] [📄 Подробнее] [❌ Не даю согласие]»

Кнопка «Подробнее» ведёт на страницу политики обработки данных.
Реакция на действия пользователя:
Согласие: переход к сбору контактов.
Отказ: Бот сообщает, что без согласия обработка невозможна, и предлагает альтернативные способы связи (телефон, почта).
Иной ввод: Бот объясняет важность согласия и возвращает к этапу запроса согласия.
3. При отказе в согласии
Сообщение:
«Без вашего согласия мы не можем обработать обращение. Вы можете позвонить нам: [Телефоны из config.php, раздел "2. ТЕЛЕФОНЫ"] или написать на почту [Переменная SITE_MAIL из config.php].»

Дальнейшие действия:
Если пользователь пишет любой текст — бот объясняет, что связаться можно только по телефону или почте, и снова предлагает дать согласие.
Если пользователь выражает готовность дать согласие — возврат к этапу 2.
4. Сбор контактных данных
Варианты:
Кнопка [📱 Поделиться контактом] (автоматически передаёт номер телефона).
Ручной ввод телефона или e-mail.
Обработка данных:
Полученные контакты отправляются в статистику.
Вся переписка фиксируется для анализа и пополнения базы знаний.
5. Сбор сути обращения
Бот напоминает, что было зафиксировано на этапе анализа запроса (если был нестандартный вопрос), и просит уточнить детали или призвать к действию для понимания сути запроса.
6. Финальная обработка заявки
После сбора всех данных Бот подтверждает информацию:
«Зафиксировала: [суть обращения]. Ваша заявка отправлена инженеру. В ближайшее время он обязательно свяжется с вами».

Роль бота с учётом NLP и интеграции с CRM
Распознавание намерений (NLP)
Бот анализирует текст пользователя, определяя:

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

Дата и время обращения.
Контактные данные клиента.
Текст обращения и история переписки.
Статус заявки (новая).
Ответственный: инженер.
Эскалация на инженера
Если NLP не может однозначно определить намерение или запрос требует участия специалиста:

Бот создаёт заявку в системе со статусом «новая».
Система автоматически отправляет письмо с почтового ящика SITE_MAIL_FROM (из config.php) на Email поддержки с темой из настроек бота. В письме дублируется полный текст заявки.
Бот сообщает пользователю:
«Я передала ваш запрос специалисту. Он уже получил уведомление и обязательно свяжется с вами в ближайшее время».

Диалог завершается.

---

Настройка сервисной части (Настройки — Чат-бот Max)
Для корректной работы бота необходимо выполнить следующие настройки:

Настройки — Чат-бот Max — Общие
Имя ассистента: [указать Имя Бота].
Роль ассистента: [указать роль Бота].
MAX-бот ID: [указать ID Бота].
Email поддержки: [указать почту для получения заявок].
Тема письма: [указать тему для уведомлений об эскалации].

Настройки — Чат-бот Max — База знаний
Заполнить максимально возможными вопросами (придумать 40шт) ориентируясь на публичную часть сайта (aegisone.ru).
Если есть вопрос, но нет ответа на публичной части сайта — создать карточку вопроса с ключевыми словами, категорией, но не активной карточкой. Сам ответ будет добавлен позже.
При формировании ответа бот не копирует текст из базы знаний дословно, а использует технологию NLP для генерации живого и контекстного ответа.

Настройки — Чат-бот Max — Тестовый прогон
Настроить функционал для полного тестирования всех веток сценария перед открытием доступа клиентам.

Настройки — Общие
Ключ YandexGPT: [указать ключ API]. Так же будет использоваться в другом функционале сервисной части.
Ключ Yandex Folder ID: [указать ключ ID]. Так же будет использоваться в другом функционале сервисной части.
Если поле «Ключ YandexGPT» пусто, то бот работает в ограниченном режиме: он не отвечает на вопросы из базы знаний через NLP, а только предоставляет контактные данные для связи:
«Вы можете позвонить нам: [Телефоны из config.php] или написать на почту [Переменная SITE_MAIL из config.php].» Контактные данные с активными ссылками.

Промпт агента (Роль ассистента)

Ты не виртуальный помощник, а AI-ассистент, созданный для имитации живого человеческого общения с клиентами. Твоя главная задача — быть первым контактным лицом компании, обеспечивая клиентам мгновенную, компетентную и эмпатичную поддержку 24/7 строго соблюдая требования ФЗ-152. Ты не используешь жёсткие шаблоны ответов. Вместо этого ты анализируешь контекст диалога с помощью технологий NLP (Natural Language Processing), что позволяет тебе вести естественный, гибкий и осмысленный разговор, адаптируясь под стиль и потребности каждого клиента. Твоя задача — отвечать на общие вопросы, используя базу знаний. При формировании ответа из неё ты не просто копируешь текст дословно, а используешь технологию NLP для генерации живого и контекстного ответа.

Статусы заявок
В системе заявок предусмотреть статусы:
Новая (создаётся ботом).
В работе (меняет инженер).
Закрыта (меняет инженер после решения вопроса).

API YandexGPT: AQVN1--hm2P-RmtTpsq0GZ4aCVFqeeZl39OTYR3w
Yandex Folder ID: b1gl51d91s6tchaghp0v
MAX-бот ID: f9LHodD0cOKkk03DYXj906MdIeRs3HdDo0BC5H2fLMVCMz3PA_Vx4aJqt2l2qPLM5zd5EQ1Zh6APxzpw2UYE
API Gemini: AIzaSyBpg-FjHGGPjyVRbRhVdgs4KfRmoTnGClo

user_id=294913992 — это ID бота

Роль: Ты не просто виртуальный помощник, а AI-ассистент, созданный для имитации живого человеческого общения с клиентами. Твоя главная задача — быть первым контактным лицом компании, обеспечивая клиентам мгновенную, компетентную и эмпатичную поддержку 24/7 строго соблюдаея требования ФЗ-152. Ты не использует жёсткие шаблоны ответов, а вместо этого анализируешь контекст диалога с помощью технологий NLP (Natural Language Processing), что позволяет тебе вести естественный, гибкий и осмысленный разговор, адаптируясь под стиль и потребности каждого клиента. Так же твоя задача отвечать на общие вопросы используя Базу знаний. При формировании ответа из неё, ты не просто копируешь текст дословно, а используешь технологию NLP для генерации живого и контекстного ответа.