通过

使用应用程序的见解扩充 CRM 记录摘要（预览）

  • 项目

重要提示

[本文为预发布文档，可能会发生变化。]

要更好地了解正在准备的会议或正在阅读的电子邮件的背景，销售人员需要相关的客户关系管理 (CRM) 信息，如客户查询、担忧和注释。 销售用 Copilot 使用 AI 生成每个 CRM 记录的摘要。 此摘要会突出显示关键详细信息，如销售阶段、预算和预计结束日期。 您可以利用您自己的应用程序的见解来扩展销售用 Copilot 提供的 CRM 记录摘要功能。

API 描述

您必须将以下 API 说明添加到操作中。 这样，销售用 Copilot 可以识别必须调用来扩充功能的正确 API。

此操作将获得与 CRM 记录相关的其他销售见解，这些见解将显示在 C4S 记录摘要卡中。 操作增强了销售用 Copilot 的现有技能。

输入参数

销售用 Copilot 设计为向您的 API 提供以下输入参数。

客户 数据类型/格式 必需 详情 要在操作中添加的说明
recordType String 可以 CRM 中请求相关见解（如活动）的实体或对象的类型。 此值包括实体或对象类型与语言无关的唯一名称，不是可以本地化的显示名称。 示例包括客户和商机。 此输入指示 CRM 中为其请求见解的实体或对象类型。
recordId String 可以 CRM 记录的唯一标识符。 此输入指示为其请求见解的 CRM 记录的唯一标识符。
startDateTime “日期-时间”格式的字符串 不可以 查找见解的开始日期和时间。 格式遵从 OpenAPI 规范。 这里是一个示例：2017-07-21T17:32:28Z。 此输入指示请求的见解的开始日期和时间。
endDateTime “日期-时间”格式的字符串 不可以 查找见解的结束日期和时间。 格式遵从 OpenAPI 规范。 这里是一个示例：2017-07-21T17:32:28Z。 此输入指示请求的见解的结束日期和时间。
主要 整型 不可以 要提取的见解数。 此输入指示要提取的见解数量。
skip 整型 不可以 要跳过的见解数。 此输入指示要跳过的见解数量。
crmType String 不可以 有效值为 Dynamics 365 和 Salesforce。 此输入指示为其请求见解的 CRM 记录所在的 CRM 类型。
crmOrgUrl String 不可以 CRM 组织的主机名，如 contoso.crm.dynamics.com。 此输入指示为其请求见解的 CRM 记录所在的 CRM 环境的 URL。

输出参数

销售用 Copilot 预期会从您的 API 收到见解（对象）列表，并预期每个见解都有特定的参数。 为确保销售用 Copilot 能够正确分析输出，响应结构必须符合下表中的准则。

参数 数据类型 必需 详情
value 数组 可以 见解（对象）列表，按见解架构一节描述的方法定义。
hasMoreResults 布尔型 不可以 指示是否有更多可用结果的值。

见解架构

客户 数据类型/格式 必需 详情 要在操作中添加的说明
职务 String 可以 引文卡上见解的标题。 它是使用通过 Accept-Language 请求头指定的语言显示的见解的自然语言标题。 这里有一个示例：已签署的合同。 此输出指示引文卡中活动的标题。
description String 可以 见解的描述。 它在记录摘要中显示为要点，是使用通过 Accept-Language 标头指定的语言显示的对见解的自然语言描述。 这里有一个示例：Kenny、Logan 和另外两人于 2023 年 9 月 7 日签署了 Contoso 2023 续约合同。 此输出指示见解的说明。
dateTime “日期-时间”格式的字符串 可以 UTC 格式的活动日期和时间。 如果活动同时具有开始时间和结束时间，应用程序必须确定要显示哪个时间。 格式遵从 OpenAPI 规范。 这里是一个示例：2017-07-21T17:32:28Z。 此输出指示与见解关联的时间。
url String 不可以 用于在合作伙伴应用程序中打开活动的有效 URL。 此输出指示用于打开见解的 URL。
additionalProperties 具有字符串类型的属性名称和属性值值的对象 不可以

详细视图中显示的其他属性。 属性名称和值采用通过 Accept-Language 标头指定的语言的自然语言。 下面是一个示例。

{
 "Status reason": "Signed off",
 "Owner": "Kenny Smith"
}
 此输出指示见解的详细视图中显示的其他属性。

备注

虽然扩展电子邮件摘要功能和记录摘要功能的 API 要求可能类似，但它们必须作为单独的操作添加到连接器中。

示例

{
    "value": [
        {
            "title": "Contract signed",
            "description": "You have 5 connections in Fourth Coffee Inc",
            "dateTime": "2024-05-07T03:28:38.0667701Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        },
        {
            "title": "Contract signed",
            "description": "Multiple stakeholders from Fourth Coffee have visited the Contoso website four times in the last four months",
            "dateTime": "2024-05-07T03:28:38.0669445Z",
            "url": null,
            "additionalProperties": {
                "Contract name": "50 Cafe-A-100 Automatic Renewal Contract",
                "Signed by": "Alberto Burgos, Tony",
                "Signed": "9/7/23"
            }
        }
    ],
    "hasMoreResults": false
}

下图中的示例显示如何将 API 的输出映射到记录摘要。

显示合作伙伴应用程序中最新活动的剖析的屏幕截图。

图例：

  1. 显示合作伙伴应用程序的见解的部分。 部分标题派生自 Microsoft Power Platform 连接器的名称。
  2. 来自 API 响应的见解的说明。
  3. 可以选择来查看有关见解的详细信息的引文编号。
  4. 显示有关见解的详细信息的引文卡。
  5. 见解的图标和标题。 此图标从 Microsoft Power Platform 连接器元数据检索。 标题文本是来自 API 响应的见解的标题。
  6. 来自 API 响应的见解的其他属性。
  7. 合作伙伴应用程序的名称。 显示的名称是 Microsoft Power Platform 连接器的名称。
  8. 可以选择来查看合作伙伴应用程序中的见解详细信息的链接。 基于 API 响应中见解的 URL。

查看记录摘要
使用应用程序中的见解扩充电子邮件摘要
使用应用程序中的文件链接扩充电子邮件草稿
使用应用程序中的见解扩充关键销售信息
使用应用程序中的见解扩充 CRM 记录详细信息
使用合作伙伴应用程序扩展销售用 Microsoft 365 销售用 Copilot
构建销售用 Copilot 扩展