为 Smart Assist 代理实现自定义方案

注释

Copilot Studio 机器人重命名为 Copilot 代理(代理或 AI 代理)。 人工代理现在更名为客户服务代表(服务代表或代表)。 在我们更新产品 UI、文档和培训内容时,您可能会遇到对新旧术语的引用。

本主题提供有关如何在 Smart assist AI 代理中启用相似案例建议的信息。

先决条件

重要

有关如何开始构建自定义智能助手代理的信息,请参阅 构建智能助手代理 主题。

情境:相似案例建议

此方案使您能够使用打开案例作按钮建议相似案例。 客户服务代表(服务代表或代表)将获得相似案例的列表作为建议。 代表单击他们认为最相似和最相关的案例,然后转到案例说明并查看注释中的解决方法。 代表通过聊天向客户建议相同的解决方案。

生成 intent 以解释对话的上下文

在向代表推荐行动之前,有必要分析对话并了解其背景。 使用 语言理解 (LUIS) 查找正在进行的对话的意图。 下面是有关如何创建 LUIS 应用以从给定文本中查找意向的示例: 快速入门:使用预生成的家庭自动化应用

您可以为要针对来自客户的传入请求或正在讨论的最常见主题的每种问题类型或主题创建目的。

有关“打印机噪音”问题的相似案例建议示例场景,请创建一个同名的意图,并添加 10-15 个示例,例如“打印机噪音、打印机发出的巨大噪音、打印机发出磨擦声、响亮的咔嗒声和响亮的声音”。 然后,需要针对此意向训练 LUIS 应用。

创作自适应卡片以在智能助手 UI 中显示建议

自适应卡片 是一种开源标准,可帮助应用和服务交换本机 UI 的丰富片段。 智能助手代理实时解释对话上下文并向代表提供建议。

用于实现自定义功能的自定义作

自定义作可以帮助您在 Smart Assist 代理中实现自定义功能。

启用相似案例场景的步骤如下:

  1. 设置相似性规则

按照此处提到的步骤 1 到 7 设置相似性规则: 创建新的相似性规则以查看相似案例

  1. 启用相关性搜索

在 Administrator (管理员) 部分中打开 Relevance Search (相关性搜索)。 有关更多信息,请参阅 启用字段以精确匹配相似案例

  1. 相似案例 API

可以使用 该 GetSimilarRecords 函数获取类似的情况。 但在使用此函数执行 Web API 查询之前,请确保设置相似性规则。 详细信息:使用高级相似性规则查看类似案例建议。 此外,请确保 启用 相关性搜索 在管理员部分,以确保相似性规则按预期方式工作。 此外,在 Match Field (匹配字段 ) 部分中,添加一些条件,如案例标题和案例类型。

请求

GET [Organization URI]/api/data/v9.1/GetSimilarRecords(Id=@Id,Filter=@Filter,ReturnFields=@ReturnFields)?@Id={"@odata.id":"incidents(<incident id>)"}&@Filter=null&@ReturnFields={"AllColumns":false,"Columns":["title","description"]}
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0 

将上面的 Web API 请求中的 替换为 incident id 要查找相似案例的案例的唯一标识符。

响应

{
    "@odata.context": "[Organization URI]/api/data/v9.1/$metadata#incidents",
    "value": [
        {
            "@odata.type": "#Microsoft.Dynamics.CRM.incident",
            "@odata.etag": "W/\"1571835\"",
            "title": "Product question re warranty",
            "modifiedon": "2019-03-03T12:58:25Z",
            "incidentid": "f69e62a8-90df-e311-9565-a45d36fc5fe8"
        },
        {
            "@odata.type": "#Microsoft.Dynamics.CRM.incident",
            "@odata.etag": "W/\"1572750\"",
            "title": "Shipment question re order",
            "modifiedon": "2019-03-03T12:58:27Z",
            "incidentid": "129f62a8-90df-e311-9565-a45d36fc5fe8"
        }
    ]
}

使用自适应卡片调用自定义作

如果要在建议中使用 embed a custom action,请创建 Web 资源。 有关如何构建自定义作的信息,请参阅 有关创建自己的作 的 Power Apps 主题。 有关如何创建 Web 资源的信息,请参阅 模型驱动应用中的 Web 资源 主题。 在 Active Conversation 表单下上传这些 Web 资源。 支持的自定义作如下。

OpenForm 自定义作

此自定义作使您能够打开任何实体记录。

{
              "type": "Action.Submit",
              "title": "Open",
              "data": {
                             "CustomAction": "OpenForm",
                             "CustomParameters": {
                                           "entityName": "incident",
                                           "entityId": "c3356c37-bba6-4067-b1a1-8c66e1c203a1",
                                           "data": {}
                             }
              }
}

SendKB 自定义作

通过此自定义作,您可以发送知识库文章。

注释

key CustomAction 应包含 SendKB key 且 kbLink key 应包含知识库文章的链接。 您不能拥有与 同名 SendKB的其他自定义作。

{

          "type": "Action.Submit",
          "title": "Send",
          "data": {
                          "CustomAction": "SendKB",
                          "CustomParameters": {
                          "kbLink": "https://ocddemoebc.powerappsportals.com/knowledgebase/article/KA-01011/en-us"
                  }
          }
}

您可以使用客户端 API 打开知识库文章。 有关更多信息,请参阅 模型驱动应用的客户端 API 参考

构建智能助手代理
示例代码:代理的 Smart Assist
代表的智能助手