Настройка переменных контекста для ботов

  • Статья

Внимание

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

Некоторые статьи и снимки экрана могут ссылаться на Power Virtual Agents, пока мы обновляем документацию и учебные материалы.

В этой статье перечислены переменные контекста для ботов Azure и Copilot Studio, и рассказывается, как их настроить в Многоканальном взаимодействии для Customer Service. Чтобы понять, как создавать переменные контекста, см. раздел Управление переменными контекста.

Переменные контекста для ботов Azure

Следующая таблица содержит список переменных контекста в Многоканальном взаимодействии для Customer Service, которые можно использовать для настройки ботов Azure.

Тип переменной контекста Имя переменной контекста Description Сопоставление в Azure
Опрос перед разговором Используйте тип вопроса, который вы создаете в многоканальном взаимодействии для Customer Service. В переменных контекста для ответов перед разговором хранятся ответы клиента на вопросы в опросе перед разговором. Используйте следующую информацию, чтобы сопоставить переменную типа вопроса в Многоканальном взаимодействии для 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.

Внимание

Чтобы иметь возможность использовать переменные обмена сообщениями и голосовой связи, сначала убедитесь, что вы установили решения расширения.

Тип переменной контекста Имя переменной контекста Description Сопоставление в Copilot Studio
Опрос перед разговором Используйте тип вопроса, который вы создаете в многоканальном взаимодействии для Customer Service. В переменных контекста для ответов перед разговором хранятся ответы клиента на вопросы в опросе перед разговором. Используйте следующую информацию, чтобы сопоставить переменную типа вопроса в Многоканальном взаимодействии для Customer Service с типом переменной в Copilot Studio:
  • Одна строка: полный ответ пользователя
    • Несколько строк: полный ответ пользователя
  • Набор параметров: полный ответ пользователя
  • Согласие пользователя: логический
Пользовательский контекст Используйте имя переменной, созданное в Многоканальном взаимодействии для Customer Service, или передайте с помощью API setContextProvider. Это настраиваемые переменные контекста, которые можно создавать и передавать через 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.
Переменные только для голосовой связи CustomerPhoneNumber Используйте эту переменную контекста для номера телефона клиента, указанного в действии "Телефония". Выберите переменную решения расширения Многоканального взаимодействия для Customer Service.
OrganizationPhoneNumber Используйте эту переменную контекста для номера телефона организации, указанного в действии "Телефония". Выберите переменную решения расширения Многоканального взаимодействия для Customer Service.
Название метода расширения va_SurveyConsent Используйте это диалоговое окно, чтобы определить, согласился ли клиент участвовать в опросах во время разговора. Используйте этот метод, чтобы передать сведения о разговоре в Многоканальное взаимодействие для Customer Service.
va_CustomerLocale Используйте это диалоговое окно, чтобы передать пользователя, который в данный момент разговаривает с ботом, другому боту, который может говорить на другом языке. Установите код, выбрав входную переменную и используя правильный код языкового стандарта.

Настройка переменных контекста для бота Copilot Studio

В Copilot Studio выполните следующие действия:

  1. На странице Темы выберите Создать тему.

  2. На вкладке Настройка введите имя и описание и сохраните тему.

  3. Выберите Перейти на холст разработки.

  4. Выберите Добавить узел, выберите действие Задать вопрос.

  5. Отредактируйте поле Определить и в диалоговом окне Выберите информацию для определения выберите вариант, соответствующий типу данных контекстной переменной. Для получения информации о сопоставлении типов данных см. информацию в предыдущей таблице.

  6. Измените Сохранить ответ как, и в диалоговом окне Свойства переменной обновите значение поля Имя на требуемую контекстную переменную Многоканального взаимодействия для Customer Service. Убедитесь, что выбраны параметры Бот (любая тема имеет доступ) и Внешние источники могут задавать значения. Параметр Внешние источники могут устанавливать значения применим только для получения контекстной переменной.

    Настройка переменной контекста в теме.

  7. Сохраните и опубликуйте изменения.

Во время выполнения необходимая информация фиксируется в переменной контекста, которую затем можно использовать для дальнейших действий в зависимости от настроенного вами рабочего процесса. Бот может установить информацию для переменных контекста, чтобы связать разговор и обращение, когда бот передает разговор агенту. Больше информации: Связывание клиента и обращения с разговором

Вы также можете настроить узел Передача агенту в теме 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 чата