Налаштування користувацьких даних та користувацьких подій для агентів AI
Користувальницькі дані на початку сеансу
Користувальницькі дані дозволяють розробникам виконувати наступні завдання:
- Передайте дані від клієнта для оновлення параметрів часу проектування автономного агента. Наприклад, передача імені клієнта для персоналізованого вітального повідомлення.
- Оновіть змінні часу проектування автономного агента AI. Наприклад, оптимізуйте цілі та інструкції для конкретних клієнтів, оновіть опис дій та сло ти інформацією, доступною для клієнта, щоб користувачі не отримували запит на це повторно .
Наразі користувацькі дані для автономних агентів штучного інтелекту підтримуються лише через голосовий канал.
Налаштування користувацьких даних
- У Конструкторі потоків контактного центру Webex налаштуйте активність віртуального агента V2 у потоці.
- У налашт уваннях State Event вкажіть наступні дані у стовп цях
Ім'я події - Дані події:
- Залиште поле назви події порожнім.
- Введіть власні дані, які потрібно передати від Flow Designer до автономного агента AI.

Доступ до користувацьких даних в AI Agent Studio
Ви можете отримати доступ до даних подій (налаштованих у конструкторі потоків) за допомогою синтакси
{{variable name}}су в різних розділах автономного агента. Змін
ні, передані у користувацьких даних, можуть бути доступні в цілі агента, вітальному повідомленні,
інструкціях, описі дій та описі слота.

У цьому прикладі розробник використовує {{customer_name}}у вітальному повідом
ленні та {{calling_number}}в інструкціях агента.
Спеціальні події для виконання
Спеціальна подія дозволяє розробникам виконувати наступні завдання
- Визначте спеціальний вихід з агента AI, щоб повернути контроль до конструктора потоків wxCC. Наприклад, виконати виконання всередині потоку.
- Відновіть розмову з агентом штучного інтелекту, передаючи результати виконання назад агенту AI з потоку. Обмеження часу очікування виконання виконання на основі потоку Webex connect тут не застосовується.
- Підтримка випадків використання PCI для автономних агентів, оскільки інформація PCI залишається в межах конструктора пото ків wxCC.
Наразі спеціальні події для автономних агентів штучного інтелекту підтримуються лише через голосовий канал.
Налаштування власної реалізації на основі подій у AI Agent Studio
- У діях автономного агента створіть нову дію, де потрібне виконання на основі власних подій.
- У розділі виконання виберіть опцію «Встановити власну логіку виконання».
Доступ до користувацьких даних подій у Flow Designer
Ви можете отримати доступ до власної назви події та корисного навантаження з розділу Вихідні змінні активності Virtual Agent V2.
Назва дії повертається під змінною stateEventName, а зібрані слоти з дії повертаються як MetaData:

Викликати користувацьку подію з Flow Designer
- Виконати логіку виконання в потоці на основі назви дії або події, отриманої у виході діяльності Virtual Agent V2.
- Створюйте та використовуйте змінні потоку для динамічного оновлення назви події та даних події, які потрібно
надіслати назад. У наведеному нижче прикладі змінна event_name потоку встановлена так само, як і назва
події, передана активністю Virtual Agent V2, і event_data_string змінна
оновлюється, щоб містити вихід з активності http, що використовується для спілкування з
сторонніми системами для отримання відомостей про доступність зустрічей.

У налаштуваннях «Подія стану» активності «Віртуальний агент V2» вкажіть наступні дані в полях Ім'я події - Дані події:
- Змінна, яка містить назву події, за допомогою якої завершено діяльність Virtual Agent V2.
- Змінна, яка містить дані виконання, які необхідно передати назад у по тік.

Користувацькі події дозволяють адміністраторам виконувати такі завдання:
-
Передайте дані від клієнта для створення динамічних відповідей. Наприклад, передача імені клієнта для персоналізованого привітання.
-
Визначте спеціальний вихід з агента AI, щоб повернути контроль дизайнеру потоку. Наприклад, виконати виконання всередині потоку.
-
За допомогою спеціальної події встановіть, щоб агент штучного інтелекту починався з власної початкової точки, а не із запрошення.
-
Оновлення змінних стану агента AI. Наприклад, попереднє заповнення контексту або слотів за допомогою користува цьких даних, переданих від конструктора потоків.
Наразі користувацькі події для агентів AI зі сценаріями підтримуються лише через голосовий канал.
Налаштування вхідної користувацької події в AI Agent Studio
- На сторінці конфігурації агента AI створіть нову відповідь на вкладці Відповід і.
- У розділі Відповідь за замовчуванням натисніть + поруч із каналом за замовчуванням (веб-канал), щоб додати голо совий канал
- У полі Назва вхід ної події визначте ім'я події, яку отримує агент.
Викликати користувацьку подію з Flow Designer
- У Конструкторі потоків контактного центру Webex налаштуйте активність віртуального агента V2 у потоці.
- У налашт уваннях State Event вкажіть наступні дані у стовп цях Ім
'я події - Дані події:
-
Введіть власну назву події, яку ви налаштували на вкладці Відповід ь на сторінці конфігурації агента AI в AI Agent Studio.
- Введіть власні дані, які потрібно передати від Flow Designer до агента AI зі сценарієм.
-
Доступ до користувацьких даних подій у AI Agent Studio
Ви можете отримати доступ до даних події (налаштованих у конструкторі потоків) у розділі Відповідь за
замовчуванням, де ви налаштували вхідну подію. На наступному
малюнку ви можете побачити, що користувацьке ім'я події custom_welcome«" та
дані події store name"" передаються з Flow Designer до AI Agent
Studio.
Налаштуйте користувацьку подію виходу та корисне навантаження в AI Agent Studio
-
У студії AI Agent перейдіть на сторінку конфігурації агента AI зі сценарієм та перейдіть до розді лу Відповід ь, де ви хочете, щоб елемент керування був переданий конструктору потоку.
-
Додайте користувацьку подію до розділу Відповідь за замовчуванням.
-
Введіть назву події та дані корисного навантаження події в JSON, які потрібно повернути до пото ку.
У цьому прикладі зібрані слоти
повертаються до потоку за допомогою спеціальної події exit
“order_details”.
Доступ до користувацьких даних подій у Flow Designer
Ви можете отримати доступ до власної події та корисного навантаження з розділу Вихідні змінні активності Virtual Agent V2.
Повер Event nameтається під StateEventName
змінною, а Event payload повертається, Metadataяк
показано на наступному малюнку:

Оновлення системних значень в AI Agent Studio
Ви можете оновити системні значення, такі як контекст, намір та слот, використовуючи спеціальну поді Event payloadю
state_updateта значення, як показано
в наступному прикладі:
{
"intent": "order_status",
"slots": {
"first_name": "John"
}
"context": {
"track": 1
}
}
У наведеному вище прикладі намір скриптового агента встановлено на
order_status, слот «first_name» у цьому намірі встановлюється на «John»,
а до сеансу додається контекст під назвою «track».
Ця подія корисна для випадків використання, коли розмова зі сценарієм агента повинна контро люватися логікою потоку. Деякі випадки використання, коли це особливо корисно, включають:
-
Повторно запропонуйте користувачеві інформацію, якщо виконання в потоці не вдається
Розглянемо сценарій, коли агент замовляє зустріч для користувача. Після збору дати та часу ця інформація надсилається потоку через спеціальну подію, яка потім намагається забронювати зустріч за допомогою активності запиту HTTPS. Якщо зустріч відхилена через конфлікт планування, агенту AI потрібно запросити альтернативний часовий проміжок. Щоб впоратися з цим, розробник може використовувати наступне корисне навантаження події:
{ "intent": "book appointment", "slots": { "time": "" } }У цьому випадку значення, зібране за час, очищається, і агент AI за пропонує користувачеві надати нове. Розробники можуть налаштувати умовні відповіді, щоб повідом ити користувачам, що попередній слот був недоступний, і запросити новий час.
-
Перейти до іншого наміру
Розглянемо сценарій, коли користувач просить перевірити свій баланс, але як обов'язкова умов а користувач повинен спочатку підтвердити свою особу. В рамках процесу запиту балансу розробники можуть надіслати корисне навантаження події, щоб повідомити потоку, чи користувач вже перевірений. Якщо підтверджено, система може перейти до отримання балансу; якщо ні, по тік може запропонувати агенту AI ініціювати процес перевірки користувача, використовуючи наступне корисне навантаження події:
{ "intent": "verify user", }У цьому ж прикладі скажімо, що для перевірки потрібна дата народження користувача та пін-код. З потоку вже є інформація про дату народження користувача через CJDS, яку можна передати як слот і збирати тільки пін-код. Корисне навантаження події для цього буде виглядати так:
{ "intent": "verify user", "slots": { "date of birth": "06/26/1993" } } - Введення або скидання контексту в розмові
Коли контекст розмови потрібно оновити, розробники можуть включити його до корисного навантаження події для
state_updateподії. Наприклад, після того, як агент AI збирає слоти для наміру «перевірити користувача», він встановлює контекст розмови на «перевірити». Якщо перевірка не вдається в потоці, контекст слід скинути, щоб користувач не мав доступу до намірів, які потребують контексту «перевірити». Корисне навантаження події для цього сценарію буде виглядати так:{ "intent": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }