Пользовательские события позволяют администраторам выполнять следующие задачи:

  • Передача данных от клиента для создания динамических ответов. Например, передача имени клиента для персонализированного приветствия.

  • Определите пользовательский выход из агента ИИ, чтобы вернуть управление конструктору потока. Например, для выполнения выполнения в рамках потока.

  • Настройте ИИ-агента так, чтобы он начинал работу с пользовательской начальной точки, а не с приветственного приглашения, используя пользовательское событие.

  • Обновление переменных состояния агента ИИ. Например, предварительное заполнение контекста или слотов с использованием пользовательских данных, переданных от конструктора потока.

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

Настройка входящего пользовательского события в AI Agent Studio

  1. На странице конфигурации агента ИИ создайте новый ответ на вкладке Ответы .
  2. В разделе «Ответ по умолчанию» нажмите + рядом с каналом По умолчанию (Веб) , чтобы добавить канал Голосовой
  3. В поле Имя входящего события укажите имя события, которое получает агент.

Вызов пользовательского события из Flow Designer

  1. В конструкторе потоков контакт-центра Webex настройте действие Virtual Agent V2 в потоке.
  2. В настройках Событие состояния укажите следующие данные в столбцах Имя события - Данные события :

    1. Введите имя пользовательского события, которое вы настроили на вкладке Ответ страницы конфигурации агента AI в AI Agent Studio.

    2. Введите пользовательские данные, которые вы хотите передать из Flow Designer в скриптовый агент ИИ.

Доступ к данным пользовательских событий в AI Agent Studio

Доступ к данным о событиях (настроенным в Flow Designer) можно получить в разделе Ответ по умолчанию , где вы настроили входящее событие. На следующем рисунке вы можете видеть, что имя пользовательского события «custom_welcome» и данные события «store name» передаются из Flow Designer в AI Agent Studio.

Настройте пользовательское событие выхода и полезную нагрузку в AI Agent Studio

  1. В AI Agent Studio перейдите на страницу конфигурации скриптового AI-агента и выберите Response , где вы хотите, чтобы управление было передано обратно конструктору потока.

  2. Добавьте пользовательское событие в раздел Ответ по умолчанию .

  3. Введите имя события и данные полезной нагрузки события в формате JSON, которые вы хотите вернуть в поток.

В этом примере собранные слоты возвращаются в поток с помощью настраиваемого события выхода "order_details".

Доступ к данным пользовательских событий в Flow Designer

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

Имя события возвращается в переменной StateEventName , а полезная нагрузка события возвращается в виде метаданные , как показано на следующем рисунке:

Обновление системных значений в AI Agent Studio

Вы можете обновить системные значения, такие как контекст, намерение и слот, используя специальное событие state_update и полезную нагрузку события со значениями, как показано в следующем примере:

{ "intent": "order_status", "slots": { "first_name": "Джон" } }