为机器人配置上下文变量

项目
12/08/2023

重要提示

继在生成式人工智能的重大投资和跨 Microsoft Copilot 的增强集成之后，Power Virtual Agents 功能和特性现已成为 Microsoft Copilot Studio 的一部分。

更新文档和培训内容时，文章和屏幕截图可能会参考 Power Virtual Agents。

本文列出了 Azure 和 Copilot Studio 机器人的上下文变量，以及如何在 Customer Service 全渠道中配置这些变量。要了解如何创建上下文变量，请参阅管理上下文变量。

Azure 机器人的上下文变量

下表包含 Customer Service 全渠道中可用于配置 Azure 机器人的上下文变量列表。

上下文变量类型	上下文变量名称	说明	如何在 Azure 中映射
对话前调查	使用在 Customer Service 全渠道中创建的问题类型。	对话前答案的上下文变量存储对话前调查中问题的答案。	使用以下信息将 Customer Service 全渠道中的问题类型变量映射为 Azure 中的变量类型：单行：字符串多行：字符串选项集：字符串用户同意：布尔值
自定义上下文	使用在 Customer Service 全渠道中创建或使用 setContextProvider API 传递的变量名称。	它们是可通过实时聊天 SDK 创建和传递的自定义上下文变量。	将用户的响应映射为 JSON 以在 Customer Service 全渠道中使用自定义上下文变量。
对话	msdyn_ConversationId	使用包含持续对话的对话 ID 并且可以在 Microsoft Dataverse 中的记录上获取和执行操作的上下文变量。	字符串：字符串
联系人	msdyn_contact_msdyn_ocliveworkitem_Customer	使用包含链接到对话的客户（联系人）记录的记录 ID 的此上下文变量。	分析 JSON 以提取记录 ID
帐户	msdyn_account_msdyn_ocliveworkitem_Customer	使用包含链接到对话的帐户记录的记录 ID 的此上下文变量。	分析 JSON 以提取记录 ID
大小写	msdyn_incident_msdyn_ocliveworkitem	使用包含链接到对话的案例的记录 ID 的此上下文变量。	分析 JSON 以提取记录 ID

备注

使用符合规定的上下文变量名称，并且在 Azure 或 Copilot Studio 机器人中创作流时不更改这些名称。另外，请确保使用完全匹配将值传递给上下文变量，因为它区分大小写。如果存在不匹配的情况，不会自动识别记录。详细信息：自动识别记录

Copilot Studio 机器人的上下文变量

下表包含 Customer Service 全渠道中提供的可用于配置 Copilot Studio 机器人的上下文变量列表。

重要提示

要能够使用消息传递和语音变量，请确保首先安装扩展解决方案。

上下文变量类型	上下文变量名称	说明	如何在 Copilot Studio 中映射
对话前调查	使用在 Customer Service 全渠道中创建的问题类型。	对话前答案的上下文变量存储对话前调查中问题的答案。	使用以下信息将 Customer Service 全渠道中的问题类型变量映射为 Copilot Studio 中的变量类型：单行：用户的整个响应多行：用户的整个响应选项集：用户的整个响应用户同意：布尔值
自定义上下文	使用您在 Customer Service 全渠道中创建或使用 setContextProvider API 传递的变量名称。	它们是可通过实时聊天 SDK 创建和传递的自定义上下文变量。	使用以下信息将 Customer Service 全渠道中的自定义上下文变量映射为 Copilot Studio 中的变量类型：字符串：用户的整个响应布尔值：布尔值数字、浮点数：数字
对话	msdyn_ConversationId	使用包含持续对话的对话 ID 并且可以在 Microsoft Dataverse 中的记录上获取和执行操作的上下文变量。	字符串：用户的整个响应。
消息和语音变量	msdyn_CustomerType	使用此上下文变量包含链接到对话的客户或联系人记录的客户类型。	选择 Customer Service 全渠道扩展解决方案变量。
	msdyn_CustomerName	使用此上下文变量包含链接到对话的客户或联系人记录的客户名称。	选择 Customer Service 全渠道扩展解决方案变量。
	msdyn_CustomerId	使用此上下文变量包含链接到对话的客户或联系人记录的客户 ID。	选择 Customer Service 全渠道扩展解决方案变量。
	msdyn_CaseId	使用此上下文变量包含链接到对话的案例记录的 ID。	选择 Customer Service 全渠道扩展解决方案变量。
	msdyn_CaseTitle	使用此上下文变量包含链接到对话的案例记录的标题。	选择 Customer Service 全渠道扩展解决方案变量。
仅语音变量	CustomerPhoneNumber	将此上下文变量用于电话活动中提供的客户电话号码。	选择 Customer Service 全渠道扩展解决方案变量。
	OrganizationPhoneNumber	将此上下文变量用于电话活动中提供的组织电话号码。	选择 Customer Service 全渠道扩展解决方案变量。
扩展方法名称	va_SurveyConsent	使用此对话确定客户是否已同意在对话期间参与调查。	使用此方法将对话详细信息升级到 Customer Service 全渠道。
	va_CustomerLocale	使用此对话将当前与机器人交谈的用户转移到另一个可以使用不同语言的机器人。	通过选择输入变量并使用正确的区域设置代码来设置代码。

为 Copilot Studio 机器人配置上下文变量

在 Copilot Studio 中，执行以下操作：

在主题页上，选择新建主题。
在设置选项卡上，输入名称和说明，然后保存主题。
选择转到创作区域。
选择添加节点，选择提问操作。
编辑标识字段，在选择要标识的信息对话框中，选择将匹配上下文变量数据类型的选项。有关数据类型映射的信息，请参阅上表中的信息。
编辑将响应另存为，在变量属性对话中，使用所需的 Customer Service 全渠道上下文变量更新名称的值。确保选择机器人（任何主题均可访问）和外部源可以设置值。 外部源可以设置值选项仅适用于获取上下文变量。
保存并发布更改。

在运行时，在上下文变量中捕获所需信息，然后可用于基于您配置的工作流的进一步操作。当机器人将对话升级到代理时，机器人可以为上下文变量设置信息以链接对话和案例。详细信息：将客户和案例链接到对话

您还可以在 Copilot Studio 主题中配置传输到代理节点，以在升级过程中将包含相关上下文变量的私有消息发送给人工代理。

在升级对话时，在 Copilot Studio 中创建的全局变量可以传递到 Customer Service 全渠道。有关完整列表，请参阅转交时可用的上下文变量。

分析 JSON 对象以提取记录 ID

请确保您具有以下详细信息：

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 参考

通过