Версия: 4.12

Настройка интеграции с бот-платформой Omilia MagnetAI

Требования

Перед началом настройки убедитесь, что:

В лицензии IQChannels активирован модуль Omilia MagnetAI.
Получены параметры подключения от владельца Agent API:
- URL сервиса;
- API Key;
- системное имя агента (Agent).

После активации лицензии тип бот-платформы Omilia MagnetAI станет доступен для создания.

1. Проверка лицензии

Перейдите в Настройки → Лицензия. Убедитесь, что в разделе Бот-платформы отображается активный модуль Omilia MagnetAI.

Если модуль отсутствует, обратитесь к администратору лицензий.

2. Добавление бот-платформы

Перейдите в Сегменты → Внешние системы → Бот-платформы
Нажмите Добавить бот-платформу.
В качестве типа выберите Omilia MagnetAI Agent.
Заполните параметры подключения.

Параметр	Описание
Включен	Включает или отключает использование подключения.
Тип	Omilia MagnetAI Agent.
URL	Адрес Agent API.
API Key	Ключ авторизации для подключения к Agent API. Указывается только при создании подключения.
Agent	Системное имя агента, предоставленное владельцем Agent API.

Сохраните настройки.

После сохранения бот-платформа становится доступна для использования в сегменте.

3. Создание пользователя-бота

Перейдите во вкладку Пользователи.
Создайте нового пользователя с типом Бот.
Укажите:
- имя пользователя;
- роль, предназначенную для работы чат-ботов.

4. Добавление чат-бота

Перейдите в Сегменты → Автоматизация → Чат-боты
Создайте нового чат-бота.
В настройках укажите:
- бот-платформу Omilia MagnetAI;
- пользователя-бота, созданного ранее.

Сохраните настройки.

5. Назначение ролей

Перейдите Сегменты → Пользователи → Роли в сегменте Добавьте созданного пользователя-бота в соответствующую роль.

6. Добавление в группу распределения

Перейдите Сегменты → Распределение → Группы распределения и добавьте пользователя-бота в необходимую группу распределения.

После этого обращения смогут направляться на данного бота.

Возможности интеграции

После завершения настройки Omilia MagnetAI становится доступен для использования в качестве интеллектуального помощника операторов.

Поддерживаются следующие возможности:

Асинхронная обработка сообщений

После получения сообщения клиента IQChannels автоматически передает его в Agent API.

Ответ формируется асинхронно и отображается оператору после завершения обработки.

Автоматическое управление диалогом

Для каждого обращения автоматически создается отдельный диалог (conversation).

Во время обработки обращения система самостоятельно:

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

Дополнительная настройка данных процессов не требуется.

Использование контекста

Контекст переписки полностью хранится на стороне Omilia MagnetAI.

IQChannels передает только последнее сообщение клиента, а управление историей диалога выполняет Agent API.

Редактирование подсказок оператором

Полученную рекомендацию оператор может:

отправить без изменений;
изменить перед отправкой клиенту.

Если текст был изменен, скорректированный вариант автоматически передается обратно в Agent API. Это позволяет использовать правки операторов для дальнейшего улучшения качества ответов модели.

Одновременная обработка сообщений

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

Agent API самостоятельно определяет актуальное сообщение и формирует ответ с учетом текущего контекста.

Автоматическое завершение диалога

После закрытия обращения в IQChannels соответствующий conversation автоматически закрывается в Agent API.

При последующем новом обращении создается новый conversation.

Результат настройки

После выполнения всех этапов:

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

Требования​