为 AI 智能体配置上下文变量

适用范围：仅限 Dynamics 365 Contact Center—独立版和 Dynamics 365 Customer Service

本文列出了 Azure 和 Copilot 代理的上下文变量，以及如何在 Dynamics 365 Contact Center 中配置它们。 要了解如何创建上下文变量，请参阅管理上下文变量。

Copilot 智能体的上下文变量

下表包含 Dynamics 365 Contact Center 中可用的上下文变量列表，可用于 配置 Copilot 代理。

¹ 要将其他上下文变量用于语音，可以从 Copilot Studio 获取这些变量。 有关详细信息，请参阅使用变量。

为 Copilot 智能体配置上下文变量

若要让 Copilot 代理从 Dynamics 365 Contact Center 读取上下文变量，请执行以下步骤：

1. 在主题页上，选择从空白>添加主题。 使用未调用或已存在的主题，否则上下文变量将不起作用。

2. 为主题输入名称，例如设置上下文变量，然后保存。

3. 向主题添加新节点，然后选择变量管理 > 设置变量值。

4. 在新节点中，在设置变量下，选择创建新变量。

5. 通过选择新的变量名称打开变量属性窗格。 在窗格中，将变量名称设置为与全渠道上下文变量名称完全匹配（区分大小写）。

6. 在引用部分，选择垂直省略号，然后选择从此节点获取值（如果为空）。 Copilot Studio 智能体会在运行时从此节点获取变量值。

7. 在使用情况部分，选择全局（任何主题可以访问）和外部源可以设置值，让 Copilot Studio 智能体接受来自全渠道的数据，此变量可在任何主题中使用。

8. 如果您在变量中使用工作分类规则中的数据，请确保在变量定义中设置超时长度。 在从外部源设置全局变量中了解详细信息。

9. 关闭变量属性窗格。

10. 在您的节点中，在目标值中输入一个与智能体期望的数据类型相匹配的值。

    

11. 保存并发布更改。

在对话期间，联系中心上下文变量中的数据在 Copilot Studio 变量中设置，可用于智能体的逻辑。

智能体还可以在对话期间设置全渠道上下文变量。 要在 Copilot Studio 逻辑中设置全渠道变量，请确保您的智能体使用正确的变量名，并在变量管理节点的“目标值”属性中设置值。 Copilot Studio 会在转给客户服务代表时将变量移给全渠道。 当智能体将对话升级到服务代表时，这通常用于将对话链接到案例。 有关如何从这些数据链接全渠道中的记录的更多信息：将客户和案例链接到对话

在 Copilot Studio 中创建的全局变量可以在升级对话时传递给 Dynamics 365 Contact Center。 有关完整列表，请参阅转交时可用的上下文变量。

分析 JSON 对象以提取记录 ID

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

• Dynamics 365 Contact Center 上下文变量，例如 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>"
}

Azure 智能体的上下文变量

下表包含 Dynamics 365 Contact Center 中可用于 配置 Azure 代理的上下文变量列表。

相关信息

集成 Copilot Studio 智能体
集成 Azure 智能体
配置智能体以升级和结束对话
实时聊天 SDK 参考