Поділитися через

Налаштуйте контекстні змінні для ботів

  • Стаття

Важливо

Power Virtual Agents можливості та функції тепер є частиною значних Microsoft Copilot Studio інвестицій у генеративний штучний інтелект та розширену інтеграцію в усьому світі Microsoft Copilot.

Деякі статті та знімки екрана можуть посилатися Power Virtual Agents на оновлення, поки ми оновлюємо документацію та навчальний контент.

Нотатка

Інформація про доступність функції наведена нижче.

Dynamics 365 центр контактів — вбудований Dynamics 365 центр контактів — автономний Dynamics 365 Customer Service
No Так Так

У цій статті перелічено контекстні змінні для Azure і Copilot Studio ботів, а також способи їх налаштування в Омніканальність для Customer Service. Щоб зрозуміти, як створювати контекстні змінні, див. розділ Керування контекстними змінними.

Контекстні змінні для ботів Azure

У нижченаведеній таблиці перелічено список контекстних змінних у програмі «Омніканальність для Customer Service», які можна використовувати для налаштування ботів Azure.

Тип контекстної змінної Ім’я змінної контексту Опис Процедура зіставлення в Azure
Опитування перед розмовою Використовуйте назву запитання перед розмовою, яку ви створюєте в Омніканальності для служби підтримки. Система зберігає відповіді з опитування, проведеного перед розмовою, як контекстні змінні. Використовуйте наведену нижче інформацію, щоб зіставити ім’я запитання в Омніканальність для Customer Service з типом змінної в Azure:
  • Один рядок: рядок
  • Кілька рядків: рядок
  • Набір параметрів: рядок
  • Згода користувача: логічний
Нетиповий контекст Використайте ім'я змінної, створеної в Омніканальності для Customer Service або передайте за допомогою API setContextProvider. Створені вами користувацькі контекстні змінні можна передавати через пакет SDK чату. Зіставте відповідь користувача у форматі JSON , щоб використовувати користувацьку контекстну змінну в Омніканальність для Customer Service.
Розмова msdyn_ConversationId Скористайтеся контекстною змінною, яка містить ідентифікатор розмови для розмови, що виконується, і може виконувати операції із записом у програмі Microsoft Dataverse. Рядок: рядок
Контактна особа msdyn_contact_msdyn_ocliveworkitem_Customer Використайте цю змінну контексту, яка містить ідентифікатор запису клієнта (контактної особи), зв'язаного з розмовою. Виконайте розбір JSON, щоб отримати ідентифікатор запису
Обліковий запис msdyn_account_msdyn_ocliveworkitem_Customer Використайте цю змінну контексту, яка містить ідентифікатор запису бізнес-партнера (контактної особи), зв'язаного з розмовою. Виконайте розбір JSON, щоб отримати ідентифікатор запису
Інцидент msdyn_incident_msdyn_ocliveworkitem Використайте цю змінну контексту, яка містить ідентифікатор запису інциденту, зв’язаного з розмовою. Виконайте розбір JSON, щоб отримати ідентифікатор запису

Нотатка

Використовуйте визначені імена контекстних змінних і не змінюйте їх, коли ви створюєте потоки в Azure або Copilot Studio ботів. Також переконайтеся, що використовується точний збіг для передачі значення до контекстної змінної, оскільки значення враховують регістр. У разі невідповідності запис не буде визначено автоматично. Додаткові відомості: Автоматичне визначення записів

Контекстні змінні для Copilot Studio ботів

Наступна таблиця містить список контекстних змінних, доступних у Омніканальність для Customer Service, які можна використовувати для налаштування Copilot Studio ботів.

Важливо

Щоб використовувати повідомлення та голосові змінні, спочатку інсталюйте рішення для розширення.

Тип контекстної змінної Ім’я змінної контексту Опис Як нанести на мапу Copilot Studio
Опитування перед розмовою Використовуйте назву запитання перед розмовою, яку ви створюєте в Омніканальності для служби підтримки. Система зберігає відповіді з опитування, проведеного перед розмовою, як контекстні змінні. Використовуйте наступну інформацію, щоб зіставити назву питання в Омніканальність для Customer Service зі змінною типу в: Copilot Studio
  • Один рядок: ціла відповідь користувача
  • Кілька рядків: ціла відповідь користувача
  • Набір параметрів: повна відповідь користувача
  • Згода користувача: логічний
Нетиповий контекст Використовуйте ім’я змінної, створене в Омніканальності для Customer Service або проходьте за допомогою setContextProvider API. Створені вами користувацькі контекстні змінні можна передавати через пакет SDK чату. Використовуйте наступну інформацію, щоб зіставити користувацьку контекстну змінну в Омніканальність для Customer Service зі змінною типу в: Copilot Studio
  • Рядок: ціла відповідь користувача
    • Логічний: логічний
  • Число, число з рухомою комою: число
Розмова msdyn_ConversationId Скористайтеся контекстною змінною, яка містить ідентифікатор розмови для розмови, що виконується, і може виконувати операції із записом у програмі Microsoft Dataverse. Рядок: ціла відповідь користувача.
Змінні обміну повідомленнями та голос msdyn_CustomerType Використовуйте цю контекстну змінну, яка містить тип клієнта для облікового запису або запису контакту , пов’язаного з бесідою. Вибір змінної рішення розширення Омніканальності для Customer Service.
msdyn_CustomerName Використовуйте цю контекстну змінну, яка містить ім’я клієнта для облікового запису або запису контакту , пов’язаного з бесідою. Вибір змінної рішення розширення Омніканальності для Customer Service.
msdyn_CustomerId Використовуйте цю контекстну змінну, яка містить ідентифікатор клієнта для облікового запису або запису контакту , пов’язаного з бесідою. Вибір змінної рішення розширення Омніканальності для Customer Service.
msdyn_CaseId Використовуйте цю контекстну змінну, яка містить ідентифікатор запису інциденту, пов’язаного з бесідою. Вибір змінної рішення розширення Омніканальності для Customer Service.
msdyn_CaseTitle Використовуйте цю контекстну змінну, яка містить заголовок запису справи, пов’язаного з бесідою. Вибір змінної рішення розширення Омніканальності для Customer Service.
Лише голосові змінні Номер телефону клієнта Використовуйте цю контекстну змінну для номера телефону клієнта в активності «Телефонія». Вибір змінної рішення розширення Омніканальності для Customer Service.
Номер телефону організації Використовуйте цю контекстну змінну для номера телефону організації в активності «Телефонія». Вибір змінної рішення розширення Омніканальності для Customer Service.
Ім’я методу розширення va_SurveyConsent Цей діалог використовується для визначення, чи погодився клієнт брати участь в опитуваннях під час розмови. Цей метод використовується для масштабування даних розмови в програмі «Омніканальність для Customer Service».
va_CustomerLocale Це діалогове вікно використовується для перенесення користувача, який наразі розмовляв з ботом, до іншого бота, який може розмовляти іншою мовою. Установіть код, вибравши вхідну змінну та використовуючи правильний код локації.

Налаштування контекстних змінних для Copilot Studio бота

Щоб ваш Copilot Studio бот зчитував контекстні змінні з омніканального, виконайте наступні дії:

  1. На сторінці Теми виберіть Додати тему та з пустого місця.

  2. Введіть назву теми (наприклад, "Встановити контекстні змінні") і збережіть її.

  3. Додайте новий вузол до теми та виберіть Керування > змінними Встановити значення змінної

  4. У новому вузлі в розділі Встановити змінну виберіть Створити нову змінну.

  5. Відкрийте панель властивостей змінної, клацнувши нове ім’я змінної. На панелі встановіть ім’я змінної так, щоб воно точно відповідало імені контекстної змінної омніканальної (воно чутливе до регістру).

  6. У розділі «Довідник » виберіть три крапки (...) і виберіть «Отримати значення з цього вузла», якщо воно порожнє. Бот Copilot Studio отримує значення змінної з цього вузла під час виконання.

  7. У розділі «Використання » виберіть «Глобальні» (доступна будь-яка тема) і «Зовнішні джерела можуть встановлювати значення». Copilot Studio приймає дані від омніканальний. Закрийте панель властивостей змінної .

  8. У вузлі введіть значення в полі Кому , яке відповідає типу даних, який очікує бот. Наприклад, якщо ваш бот очікує рядок, встановіть Text(""). Copilot Studio повертається до значення, яке ви встановили тут, якщо дані не надходять у бесіду.

    Налаштуйте контекстну змінну в розділі.

  9. Збережіть та опублікуйте зміни.

Під час розмови дані з контекстної змінної омніканальний задаються в Copilot Studio змінні і можуть бути використані в логіці бота.

Бот також може встановлювати омніканальний контекстні змінні під час розмови. Щоб задати омніканальний змінну з вашої Copilot Studio логіки, переконайтеся, що ваш бот використовує правильне ім’я змінної, і встановіть значення у властивості "To value" у вашому вузлі керування змінними. Copilot Studio руки від змінної, щоб омніканальний під час переміщати агенту. Це часто використовують, щоб пов’язати розмову до випадку, коли бот передає розмову агенту. Більше інформації про те, як пов’язати записи в омніканальний з цих даних: пов’язати клієнта та звернення до розмови

Глобальні змінні, які створюються в, Copilot Studio можуть бути передані Омніканальність для Customer Service під час ескалації розмови. Повний перелік шукайте тут: Контекстні змінні, що доступні під час передачі.

Виконайте розбір об'єкту JSON, щоб отримати ідентифікатор запису

Переконайтеся, що ви маєте наведені нижче відомості.

  • Змінна контексту Омніканальності для Customer Service, наприклад, msdyn_contact_msdyn_ocliveworkitem_Customer.
  • Докладні відомості про схему

Нижче наведено копію прикладу схеми.

        Schema: 
        {
            "type": "array",
            "items": {
                "type": "object",
                "properties": {
                    "RecordId": {
                        "type": "string"
                    },
                    "PrimaryDisplayValue": {
                        "type": "string"
                    }
                },
                "required": [
                    "RecordId",
                    "PrimaryDisplayValue"
                ]
            }
        }

PrimaryDisplayValue містить значення з атрибута в Dataverse сутностях. Далі наведено зіставлення атрибутів сутності:

  • Інциденти: заголовок інциденту
  • Контакти: повне ім'я
  • Бізнес-партнери: ім'я

Далі наведено зразок контекстного запису.

{
    "msdyn_contact_msdyn_ocliveworkitem_Customer": [
        {
            "RecordId": "<GUID>",
            "PrimaryDisplayValue": "<FullName>"
        }
    ],
    "msdyn_liveworkitemid": "<GUID>"
}

Див. також

Інтегруйте Copilot Studio бота
Інтеграція бота Azure
Налаштуйте ботів для ескалації та завершення розмов
Довідка SDK для живого чату