Створіть і налаштуйте агентів ШІ

Для отримання додаткової інформації дивіться розділи «Налаштувати сценарного агента ШІ» та «Налаштувати автономні AI агенти » в посібнику Webex AI Agent Studio Administration.

Налаштуйте агентів ШІ у flow

Ви можете використовувати вузол AI Agent, щоб відповідати на конкретні запити з корпусу або бази знань. Ви також можете увімкнути багатоповоротні розмови. Агент ШІ може ставити додаткові запитання, розуміти контекст і надавати персоналізовані відповіді.

Просто перетягніть вузол AI Agent на ваш візуальний конструктор потоків, щоб почати. Цей вузол допомагає використовувати скриптовані та автономні AI-агенти, налаштовані в Webex AI Agent Studio.

Налаштуйте вхідні та вихідні змінні в вузлі AI агента

Вузол AI Agent містить два методи:

• Process Message: Дозволяє надсилати користувацькі повідомлення обраному агенту та отримувати відповіді агента у відповідь.

• Закриття сесії: Дозволяє закрити сесію в AI-агенті. У певних ситуаціях може знадобитися закрити існуючу сесію агента ШІ та розпочати нову. Це можна досягти за допомогою спеціального методу в вузлі AI Agent. Наприклад, якщо сесія залишається неактивною протягом певного періоду, система автоматично закриває її для оптимізації ресурсів.

1. У методі Process Message налаштуйте такі вхідні змінні:

   • Тип агента: тип агента, що використовується у потоці, наприклад, скриптований або автономний.

   • Агент: Агент, який обробляє повідомлення користувача і отримує відповідь.

     Ви можете побачити AI-агентів, до яких маєте доступ, у студії Webex AI Agent Studio. Для отримання додаткової інформації про управління користувачами та агентами в Webex AI Agent Studio дивіться розділ Ролі користувачів.

   • Повідомлення: Ім'я змінної, що містить вхідне повідомлення клієнта, надіслане обраному AI-агенту

   • Мова: Якщо обраний агент ШІ багатомовний, ви можете вибрати мову вхідного повідомлення у випадаючому списку Мова. Ми заповнюємо випадаючий список на основі мов у налаштуваннях AI агентів.

     Примітка: Ми вимикаємо цей випадаючий список для агентів з однією мовою.

   • Канал: Назва каналу, з якого система отримує повідомлення клієнта.

   • Ідентифікатор користувача: Вкажіть унікальний ідентифікатор користувача для обраного каналу.

   • Власні параметри (опціонально): Ви можете передати додаткову інформацію про клієнта до Webex AI Agent Studio як пару ключових значень. Ми пов'язуємо цю інформацію з профілем користувача і використовуємо її для подальших розмов. Наприклад, ви можете вказати, чи є користувач новим клієнтом чи вже існуючим клієнтом.

     Ключі, передані як користувацькі параметри, доступні як ${consumerData.extra_params.<your_key>} у відповідях агентів.

     Наразі користувацькі параметри підтримуються лише для скриптованих AI-агентів через цифрові канали.

   • Параметри повідомлення (необов'язково): Ви можете передати додаткову інформацію про поточний обмін до AI Agent Studio Webex як пару ключових значень.

     Ми не зберігаємо це повідомлення, і воно доступне лише для використання у наступній відповіді агента. Ключі, передані як параметри повідомлення, доступні як ${extra_params.<your_key>} у відповідях агентів.

2. Налаштуйте такі вихідні змінні у методі Process Message:

   • TextResponse: Текстовий вихід, налаштований у AI-агенті; працює лише якщо немає інших багатих або спеціальних елементів. Також, для кількох текстових елементів у відповіді повертається перший текстовий елемент.

   • FullResponse: Повна відповідь з усіма багатими елементами та кількома повідомленнями, присутніми у вихідному результаті агента.

   • Сховище даних: JSON/dict усіх змінних, визначених користувачем сесій у агенті

   • TransactionId: ідентифікатор транзакції для запиту в Webex AI Agent Studio

   • SessionId: ID сесії/розмови в Webex AI Agent Studio

   • ConsumerId: ID клієнта в Webex AI Agent Studio

   • MessageMetadata: Метадані, пов'язані з поточною відповіддю від налаштованого агента

   • SessionMetadata: Метадані, пов'язані з сесією для поточної відповіді від налаштованого агента

     Наразі MessageMetadata та SessionMetadata підтримуються лише для скриптованих AI-агентів через цифрові канали.

   • ResponsePayload: Повне корисне навантаження відповіді від Webex AI Agent Studio

3. Налаштуйте наступні вхідні змінні у методі Close Session:

   • Агент: Агент, який обробляє повідомлення користувача і отримує відповідь.

     Ви можете побачити AI-агентів, до яких маєте доступ, у студії Webex AI Agent Studio. Для отримання додаткової інформації про управління користувачами та агентами в Webex AI Agent Studio дивіться розділ Ролі користувачів.

   • Ідентифікатор сесії: Ми закриваємо сесію агента ШІ. Session ID доступний як вихідна змінна методу повідомлення Process.

Результати вузлів

Ви можете побачити список можливих результатів вузлів для цього вузла. Ви можете налаштувати мітки вузлів за допомогою іконки Edit (олівець). Вузол виходить через одне з ребер вузла, що відповідає результату вузла. Кожен вузол AI Agent відповідає результату вузла. Ось список результатів вузлів.

• Помилка (червоний): означає наступне:

  • onError: коли агент не відповів повідомленням.

  • onInvalidCustomerID: коли ідентифікатор клієнта відсутній.

  • onInvalidMessage: коли значення повідомлення відсутнє.

• Успіх (зелений): означає наступне:

  • onSuccess: коли агент відповідає повідомленням.

  • onAgentHandover: коли агент подає запит на передачу агентам.

• Тайм-аут (жовтий/бурштиновий колір): означає наступне:

  • onTimeOut: коли агент не відповів не більше 15 секунд.