Работа с ИИ-ассистентом

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

• диалог с ИИ в личном кабинете клиента на основе справочной информации. Вы можете:
  • заложить в основу LLM документацию компании, общие сводки и другие материалы;
  • определять состав данных для базы знаний.
• обработка обращений в техподдержку с помощью ИИ.

Вы настраиваете компоненты RAG и LLM за рамками платформы. Модуль обеспечивает обмен данными между LLM и платформой. В настройках вы можете:

• выбрать адаптер (OpenAI, DeepSeek или локальное решение), модель и задать системный промпт;
• ограничить сессии, сообщения и длину истории;
• настроить внешний вид чата через CSS и собственные тексты;
• выбрать формат ответов в тикетах: внутренние комментарии для сотрудников или ответы клиенту от имени сотрудника.

После установки модуля ИИ-ассистент вам доступны разделы, необходимые для настройки параметров интеграции с методами RAG.

Установка модуля

Чтобы установить модуль, перейдите в раздел Интеграция → Модули → ИИ-ассистент → кнопка Установить.

После установки модуля в BILLmanager становятся доступны:

• раздел ИИ-ассистент в левом меню. В разделе доступны подразделы:
  • Сессии — история общения пользователей с ИИ-аcсистентом;
  • Настройки — настройка параметров чата для общения с ИИ-ассистентом в панели администратора платформы;
•   чат для общения с ИИ-ассистентом в личном кабинете клиента. Кнопка для начала диалога доступна в правом нижнем углу интерфейса.

Настройка модуля

Чтобы настроить модуль, в левом меню перейдите в раздел ИИ-ассистент → Настройки. Вы можете:

• Создать интеграцию с ИИ-ассистентом. Подробнее см. раздел Создание ИИ-ассистента;
• Изменить настройки интеграции;
• Удалить ранее добавленные настройки ИИ-ассистента;
• Вкл. — включить использование ранее настроенного ИИ-ассистента;
• Выкл. — выключить использование ранее настроенного ИИ-ассистента.

Создание ассистента

Чтобы создать ИИ-ассистента, в левом меню перейдите в раздел ИИ-ассистент → Настройки → Создать:

1. В блоке Основные настройте поля:
   1. Провайдер — выберите провайдера, для клиентов которого будет настроено взаимодействие с ИИ-ассистентом.
   2. Адаптер — выберите интеграционный адаптер для подключения к языковой модели. Например, OpenAI , DeepSeek или локальное решение. Адаптер определяет протокол взаимодействия и формат запросов.
   3. Модель —  укажите идентификатор языковой модели, которую будет использовать ассистент. Например, gpt-4o или claude-3-5-sonnet. От выбора модели зависят качество ответов и стоимость обработки запросов.
   4. API URL — введите endpoint API провайдера языковой модели. Адрес используется для отправки запросов от платформы к внешнему сервису.
   5. API ключ — укажите секретный ключ для аутентификации запросов к API языковой модели. Ключ хранится в зашифрованном виде и передаётся в заголовках запросов.
   6. Лимит сессий — задайте максимальное количество одновременных диалогов с ИИ-ассистентом для одного пользователя. При достижении лимита новые запросы отклоняются, пока пользователь не скроет сессии. Если оставить поле пустым, количество сессий ограничено не будет. 
   7. Лимит сообщений в день — установите ограничение на количество сообщений, которые один клиент может отправить в течение суток. Сутки не зависят от времени сервера и считаются по UTC+0: с 00:00 до 00:00 следующего дня. Когда лимит исчерпан, новые сообщения не принимаются до начала следующих суток. Ограничение действует на все сессии пользователя. Лимит помогает контролировать расход токенов и бюджет. Если оставить поле пустым, количество сообщений ограничено не будет.
   8. Лимит истории сообщений — задайте ограничение на объём переписки из текущего чата, который передаётся ИИ при генерации ответа. Учитываются только последние сообщения сессии: указанное число последних обменов репликами между клиентом и ассистентом. Более ранние сообщения в чате клиент по-прежнему видит, но в контекст запроса они не попадают. Лимит помогает снизить расход токенов и ускорить ответы в длинных диалогах. Если поле оставить пустым, при каждом запросе в ИИ передаётся вся история чата.
   9. Максимальное количество символов в сообщении –-- укажите предельную длину входящего сообщения от пользователя. Сообщения, превышающие лимит, не будут отправлены. Пользователь увидит сообщение об ошибке.
   10. Разрешить группам клиентов — выберите группы клиентов, которым будет разрешено использовать ИИ-ассистента.
   11. Server-Sent Event — включите опцию, чтобы ответы ассистента передавались в реальном времени через протокол потоковой передачи данных. При отключении ответы возвращаются после полной генерации.
   12. Системный промпт — введите инструкцию для языковой модели, которая определяет роль, тон и правила поведения ассистента. Промпт влияет на стиль ответов и доступные действия.
       Пример промпта

       Ты — ИИ-ассистент по вопросам бухгалтерии и биллинга провайдера [Название провайдера]. Твоя задача — точно и оперативно отвечать на запросы клиентов, связанные с оплатой, счетами, актами, тарифами и финансовой историей, используя только данные платформы BILLmanager.

       ПРАВИЛА РАБОТЫ:
       • Используй только факты из биллинга: статусы счетов, историю платежей, привязанные услуги, доступные документы. Никогда не выдумывай суммы, даты или реквизиты.
       • При отсутствии данных или неоднозначности явно сообщи об этом и предложи создать обращение в отдел бухгалтерии.
       • Никогда не раскрывай полные номера карт, паспортные данные, внутренние финансовые отчёты или конфиденциальные реквизиты. Маскируй чувствительные поля (например, ****1234).
       • Не давай юридических или налоговых консультаций. При вопросах по НДС, договорам, смене юрлица или возвратных платежах направляй клиента к специалисту поддержки.
       • Всегда указывай валюту счёта клиента. Форматируй числа: разделитель тысяч — пробел, десятичный — запятая (пример: 12 450,00 ₽).
       • Структурируй ответ: краткий ответ → релевантные данные (номер счёта, дата, сумма) → доступное действие (ссылка на оплату, скачивание акта, создание заявки).
       • Сохраняй деловой, нейтральный и вежливый тон. Избегай разговорных фраз, эмоций, предположений и маркетинговых формулировок.

       ГРАНИЦЫ И ЭСКАЛАЦИЯ:
       • Если запрос выходит за рамки биллинга (технические неполадки, управление серверами, API, вопросы по доменам), перенаправляй клиента в техническую поддержку или соответствующий раздел платформы.
       • При запросах на ручное изменение реквизитов, возврат средств, сторнирование или изменение тарифа без автоматической доступности: «Эта операция требует подтверждения бухгалтером. Я передал запрос в отдел поддержки, специалист свяжется с вами в течение рабочего дня».
       • При ошибке доступа к данным: «Сейчас я не могу загрузить информацию по вашему запросу. Пожалуйста, попробуйте позже или напишите в поддержку — мы проверим данные вручную».

       Все ответы должны соответствовать политике безопасности провайдера и требованиям законодательства о защите персональных данных (152-ФЗ/GDPR). Ты работаешь в контуре BILLmanager и не выполняешь действий вне предоставленных API-прав.

       Пример настройки блока "Основное"

       Ниже - пример настройки с использованием моделей DeepSeek.

       Поле	Значение
       Провайдер	Выберите провайдера из списка.
       Адаптер	deep-seek
       Модель	deepseek-chat
       API URL	https://api.deepseek.com/v1
       API ключ	Ваш API-ключ DeepSeek. Возможно получить в platform.deepseek.com.
       Лимит сессий	Оставьте пустым или задайте нужное число. Например, 10.
       Лимит сообщений в день	Задайте нужной число. Например, 100.
       Максимальное количество символов в сообщении	2000
       Разрешить группам клиентов	Выберите нужные группы клиентов.
       Server-Sent Event	Включено.
       Системный промпт	Ты — ассистент биллинговой платформы BILLmanager. Помогай клиентам с вопросами по счетам, услугам, оплате. Отвечай только на основе предоставленной документации. Отвечай вежливо и по делу. Если не знаешь ответа — предложи обратиться в поддержку.

2. В блоке Оформление:
   1. Иконка ИИ-чата — загрузите изображение для отображения в виджете чата. Рекомендуемый формат: PNG или SVG, размер до 100×100 пикселей.
   2. Сбросить логотип — выберите опцию, чтобы удалить загруженную иконку и вернуть значение по умолчанию.
   3. Пользовательский CSS — укажите стили,  чтобы изменить внешний вид окна чата. Используйте только безопасные CSS-правила, скрипты и HTML не поддерживаются.
      Пример пользовательского CSS

      isp-chat-app {
        --isp-background-contrast: #ffb6c1;
        --isp-text-accent: #b0b0b0;
      }

3. В блоке Сообщения:
   1. Восстановить значения по умолчанию — выберите опцию, чтобы сбросить тексты интерфейса чата к предустановленным значениям.
   2. Заголовок чата — введите название, которое будет отображаться в шапке окна чата.
   3. Заголовок приветствия  — укажите текст заголовка на странице новой сессии чата. Клиент увидит сообщение, когда откроет окно чата.
      
   4. Приветствие — введите дополнительный текст под заголовком на экране нового чата. 
      
4. В блоке Поддержка:
   1. Обрабатывать запросы — включите опцию, чтобы ИИ-ассистент начал обрабатывать запросы в техподдержку. Если опция включена:
      1. Укажите Сотрудника, от лица которого будут обрабатываться запросы. Обязательное поле.
      2. Выберите Способ ответа на запрос:
         • Внутренний комментарий — ответ ассистента добавляется как заметка в тикет, видимая только сотрудникам поддержки;
         • Сообщение для клиента — ответ отправляется клиенту от имени выбранного сотрудника
      3. Укажите Количество ответов от агента — задайте, сколько раз ИИ-ассистент может ответить в диалоге перед автоматической передачей запроса обратно ассистенту или закрытием тикета.
      4. Если необходимо, выберите опцию Использовать другой адаптер, чтобы для обращения в поддержку использовать отдельный адаптер или модель, отличную от основной. При выборе опции настройте параметры дополнительного адаптера.
   
   
5. Нажмите Ок, чтобы сохранить изменения.

Использование чата с ИИ-ассистентом

Чтобы задать вопрос ИИ-ассистенту:

1. Нажмите на значок в правом углу.
2. В появившемся окне чата введите вопрос.
3. Нажмите Отправить.

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

Если сообщение генерируется LLM-моделью, пользователь не может создать новую сессию или отправить новое сообщение в старую сессию. Возможность отправки появится, когда ответ на сообщение сгенерируется полностью.

Просмотр ранее созданных сессий чатов

История общения клиента с ИИ-ассистентом в чате сохраняется. Клиент может:

• просмотреть историю;
• продолжить диалог с ИИ-ассистентом.

Чтобы посмотреть историю сессий, перейдите в ИИ-ассистент → Сессии. Вы можете:

• Открыть чат пользователя. Провайдеру доступны все диалоги пользователя;
• Удалить чат с ИИ-ассистентом — нажмите, чтобы удалить сессию из базы данных; 
• отфильтровать диалоги По клиенту;
• Войти в панель управления с правами пользователя.

В списке сессий отображаются следующие столбцы:

• id сессии;
• Дата первого сообщения — дата и время, когда был отправлен первый запрос от клиента к ИИ-ассистенту. Например, 2026-06-10 09:56:30;
• Тема — тема переписки. Генерируется автоматически из слов первого сообщения клиента. Например, Как настроить тариф?;
• Пользователь — пользователь, от имени которого велась переписка;
• Клиент — email клиента, от имени которого велась переписка.