Вернуться к документации

ИИ и агенты

Личные API-ключи, базовый ИИ, анализ данных и задачи по расписанию

Для полноценной работы подключите собственные модели

«ИИ и агенты» включены в тариф Pro и выше. Для полноценной работы агентов нужен ваш API-ключ OpenRouter, OpenAI или Anthropic. Использование моделей оплачивается отдельно выбранному провайдеру. Базовый ИИ без личного ключа предназначен для простых задач и зависит от доступности бесплатных моделей.

Два режима

Базовый ИИ. MSBonus готовит выбранную сводку, а бесплатная модель OpenRouter объясняет показатели или пишет черновик. Можно продолжать диалог; для базового ИИ используется сокращённая история. Ключ клиенту не нужен; действующий лимит и остаток запросов видны в панели.

Личные подключения. Вы выбираете модель, инструкции и доступные данные. Агент может обращаться к сводкам в ходе ответа, а вы — продолжать диалог. Поддерживаются OpenAI, Anthropic и модели разных разработчиков через OpenRouter.

1

Получите API-ключ

OpenRouter позволяет использовать разные модели через одно подключение

  1. Создайте аккаунт на OpenRouter.
  2. Откройте API Keys и создайте отдельный ключ для MSBonus.
  3. Для платных моделей настройте оплату и пополните баланс в кабинете OpenRouter. Условия и доступные способы оплаты показывает сам провайдер.
  4. В панели MSBonus откройте «ИИ и агенты» / «Подключения» / «Добавить ключ». Выберите OpenRouter, введите название и ключ.
  5. Нажмите «Проверить», чтобы проверить доступ и загрузить каталог моделей.

Для прямого подключения OpenAI ключ создаётся в OpenAI Platform, для Anthropic — в Claude Console. Подписка на приложение ChatGPT или Claude не заменяет API-ключ и отдельную оплату API. Доступность сервиса зависит от условий провайдера.

2

Создайте агента

Сохраните задачу и выберите данные

Нажмите «Создать агента» или выберите заготовку на вкладке «Сценарии». Настройка состоит из пяти шагов: «Назначение», «Задание», «Модель», «Запуск», «Проверка».

Сначала выберите, для чего нужен агент: рассылки, аналитика, ответы покупателям или своя задача. Панель предложит задание и подключит доступные инструменты. Их можно изменить в блоке «Изменить доступ к данным и действиям».

На шаге «Задание» уточните цель и сведения о магазине. Необязательные поля скрыты под «Дополнительные пожелания к ответу»: кто будет читать ответ, порядок действий (до восьми шагов), формат, стиль и подробность. При подключённой аналитике здесь можно выбрать период. Можно добавить ограничения, пример желаемого ответа и поведение при нехватке данных. Необязательные поля можно пропустить. Режим «Только текст» позволяет описать задачу и инструкции самостоятельно. Читатель влияет на стиль ответа; реальные получатели рассылки выбираются при настройке отправки.

На шаге «Модель» личное подключение OpenRouter позволяет выбрать бесплатную или платную модель. Используйте фильтр «Все», «Бесплатные» или «Платные». После выбора показана стоимость из каталога OpenRouter: для платных моделей — входные и выходные токены, а также плата за запрос, если она указана. Один ключ можно использовать с разными моделями у разных агентов. Если стоимость неизвестна, модель доступна в списке «Все».

Бесплатные модели используют квоту вашего аккаунта OpenRouter, а не базового ИИ MSBonus. Их доступность и лимиты определяет OpenRouter. Для работы с данными и черновиками список учитывает поддержку инструментов. Платные модели оплачиваются с вашего баланса OpenRouter; цены в каталоге служат ориентиром, итог зависит от провайдера и параметров запроса.

Выбранный период применяется к аналитике продаж и их динамике. Бонусная сводка, RFM-сегменты, правила и акции отражают текущее состояние. На шаге «Проверка» показаны задача, итоговые инструкции и параметры запуска.

«Сохранить и открыть пробный запуск» сохраняет настройки и открывает окно задачи. Генерация начнётся только после нажатия «Запустить». Ручной запуск не отправляет рассылку; использование модели оплачивается по условиям провайдера.

Личные агенты могут использовать продажи, дневную динамику, RFM-сегменты, действующие правила и акции, готовить черновики. Доступ к инструментам зависит от прав сотрудника и подключённых модулей. В базовом режиме доступны сводка и RFM-сегменты.

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

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

Черновики акций и рассылок

Выберите сценарий «Подготовить рассылку», «Вернуть клиентов» или «Подготовить акцию» и подключите личную модель с поддержкой инструментов. В истории появятся текст и карточки черновиков. Можно подготовить до четырёх черновиков за запуск.

Нажмите «Открыть в рассылках» или «Открыть в акциях». Проверьте текст, условия, каналы и аудиторию в обычном редакторе. Пока вы не сохраните результат, запись в соответствующем разделе не создаётся. Акция открывается выключенной и скрытой от клиентов; механику и запуск выбираете вы. По умолчанию рассылка не отправляется автоматически.

Черновик может содержать предложенный RFM-сегмент или период без покупок. Окончательный список получателей рассчитывается в редакторе рассылки. Результаты доступны и для запусков по расписанию. Ответ можно скачать в TXT, а настроенного агента — скопировать для другой задачи.

Авторассылки по расписанию

  1. Выберите личного агента, инструмент подготовки рассылок и ежедневное или еженедельное расписание.
  2. Включите «Отправлять по расписанию без проверки каждого текста».
  3. Отметьте нужные каналы — можно выбрать все подключённые. Задайте аудиторию: все доступные получатели, давно не покупавшие или RFM-сегмент.
  4. Укажите предел получателей на одну рассылку и нажмите «Проверить аудиторию».
  5. Проверьте инструкции агента, расписание, каналы и аудиторию. При сохранении подтвердите автоматическую отправку.

На каждом запуске ИИ готовит текст, а сервис отправляет его в выбранные вами каналы. Модель не меняет аудиторию и предел получателей. Нужны тариф Pro или выше и доступ к рассылкам; для RFM — аналитика. Ручной запуск такого агента всегда создаёт только черновик.

Если текст не подготовлен, подходящих клиентов нет или их больше лимита, отправка остановится. То же произойдёт при отзыве доступа или изменении настроек автоматики. Результат и причины остановки видны в истории агента, статус доставки — в разделе «Рассылки».

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

Чтобы остановить будущие запуски, выключите агента или автоотправку. Уже начатую рассылку останавливайте в разделе «Рассылки».

Ответы покупателям в чатах

  1. Создайте личного агента по сценарию «Шаблоны ответов», выберите модель и доступные правила/акции.
  2. Откройте переписку в разделе «Чаты» и нажмите «Ответ с ИИ».
  3. Выберите агента, при необходимости добавьте пожелания и нажмите «Подготовить ответ».
  4. Проверьте и отредактируйте результат. «Вставить в сообщение» переносит текст в поле чата; отправку выполняете отдельно.

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

Нужны тариф Pro или выше, доступ к чатам, соответствующие права сотрудника и личный API-ключ. Генерация учитывается у вашего провайдера, а результат сохраняется в истории агента. Помощник не отправляет сообщения и не меняет бонусы.

Автоответы покупателям

  1. При создании агента выберите сценарий «Автоответы покупателям».
  2. Подставьте подходящий шаблон задания, добавьте сведения о магазине и выберите модель с личным API-ключом.
  3. На шаге «Автоответы» выберите каналы, задержку ответа и длительность паузы после сообщения сотрудника. При необходимости добавьте инструкции для переписки.
  4. Проверьте настройки и нажмите «Сохранить и включить автоответы». Агент начнёт отвечать на новые сообщения покупателей в выбранных каналах.

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

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

Выключить автоответы или перейти на готовый текст можно через кнопку «Автоответы в чатах». В режиме «Шаблонный ответ» покупатель получает заданное вами сообщение без изменений.

3

Запускайте вручную или по расписанию

Для анализа и подготовки текстов результаты сохраняются в истории агента

На карточке агента нажмите «Открыть»: сохранённая задача уже заполнена, её можно уточнить перед запуском. Для автоматического выполнения задайте ежедневный или еженедельный запуск и время на шаге «Запуск». Часовой пояс берётся из общих настроек компании и показан рядом со временем. Агент выполнит задание со второго шага настройки. Результат появится в истории даже при закрытой панели.

На вкладке «История» собраны ваши запуски всех агентов с фильтром по агенту. Ответы можно копировать и скачивать, черновики — открывать в редакторах. Вкладка «Агенты» показывает состояние и ближайший запуск каждого помощника.

Лимит агентов на компанию: Pro — 3, Корпоративный — 10, Enterprise — 20. На этих тарифах доступно до 5 запросов базового ИИ в сутки и 1 незавершённая задача одновременно. За последние 24 часа допускается до 200 запусков, включая запросы с личным ключом. По умолчанию агент готовит анализ и черновики. Автоотправка рассылок включается отдельно; бонусы агенты не меняют.

Если базовый ИИ недоступен

  • «Доступен» — можно отправить запрос; панель показывает остаток квоты компании.
  • «Лимит компании исчерпан» — новые попытки ожидают следующего дня. Квота обновляется по UTC; время в панели показано в вашем часовом поясе.
  • «Модели временно заняты» — MSBonus пробует бесплатные резервные модели; если доступных нет, задача ждёт следующей попытки.
  • «Общая квота исчерпана» — смена модели не сбрасывает ограничение аккаунта. Задача ждёт восстановления квоты.
  • «Временно недоступен» или «Готовится к подключению» — используйте личный API-ключ или проверьте состояние позже.

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

У бесплатных моделей ограничена доступность. Для полноценной работы и регулярных задач подключите собственный API-ключ и выберите подходящую модель.

Нужна помощь?

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

Написать в Telegram