使用应用程序中的见解丰富电子邮件摘要（预览版）

项目
10/11/2024

重要提示

这是生产就绪预览功能。
生产就绪预览版受补充使用条款的约束。

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

当 Outlook 中的 Copilot 和销售用 Copilot 一起使用时，Outlook 中显示的电子邮件摘要包括来自您的客户关系管理（CRM）系统（如 Dynamics 365 或 Salesforce CRM）的销售信息。您可以使用来自您自己的应用程序的见解扩展销售用 Copilot 提供的电子邮件摘要功能。

API 描述

您必须将以下 API 描述添加到操作中。通过这种方式，销售用 Copilot 可以识别必须调用的正确 API 以丰富功能。

此操作将获取其他销售见解，这些见解将显示在 Outlook 摘要中的 C4S 电子邮件摘要体验中。该操作增强了 copilot 的销售现有技能。

输入参数

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

客户	数据类型/格式	必需	详情	要在操作中添加的描述
recordType	String	否	CRM 中的记录类型。该记录可以指定与电子邮件相关的客户、商机、潜在顾客或联系人。	此输入标识 CRM中与总结的电子邮件相关的记录类型。
recordId	String	否	CRM 中请求相关记录的记录 ID。	此输入提供与总结的电子邮件相关的 CRM 记录的唯一标识符。
crmType	String	否	CRM 系统的类型。有效值为 Salesforce 和 Dynamics 365。	此输入指示存在与所总结电子邮件相关的记录的 CRM 的类型。
crmOrgUrl	String	否	CRM 组织 URL。	此输入指示存在与所总结电子邮件相关的记录的 CRM 环境的 URL。
emailContacts	String	是	以逗号分隔的电子邮件地址列表，例如 `kenny@contoso.com,logan@contoso.com`。	此输入指示当前电子邮件线程中所有相关参与者电子邮件的列表。
上	Integer	否	要获取的数据分析数量。	此输入指示要提取的见解数量。
跳过	Integer	否	要跳过的见解数量。	此输入指示提取见解时要跳过的项目数。

输出参数

销售用 Copilot 希望从您的 API 接收洞察（对象）列表，并且它希望每个洞察都有特定的参数。为确保销售用 Copilot 能够正确解析输出，回复结构必须遵循下表中的准则。

参数	数据类型	必需	详情
value	数组	是	按照 Schema for insights 部分所述定义的见解（对象）列表。注意：Although此参数包含洞察列表，则电子邮件扩充摘要中仅使用第一个洞察。
hasMoreResults	布尔型	否	一个值，该值指示是否有更多结果可用。

参数

数据类型

必需

详情

value

数组

是

按照 Schema for insights 部分所述定义的见解（对象）列表。

注意：Although此参数包含洞察列表，则电子邮件扩充摘要中仅使用第一个洞察。

hasMoreResults

布尔型

否

一个值，该值指示是否有更多结果可用。

洞察架构

客户	数据类型/格式	必需	详情	要在操作中添加的描述
称谓	最多 20 个字符的字符串	是	Sales Insights 的标题。	此输出指示合作伙伴部分的标题，应仅包括合作伙伴的名称。
Description	String	是	提供给用户的见解，例如您的同事 Mona Kane、Ray Tanaka 和 Daniela Smith 以前曾与他们合作过。	此输出指示您希望包含在电子邮件摘要中的文本。

备注

Although 扩展电子邮件摘要功能和记录摘要功能的 API 要求可能看起来相似，但它们必须在连接器中作为单独的操作添加。

示例

{
    "value": [
        {
            "title": "From Contoso Customer Insights",
            "description": "Your colleagues Mona Kane, Ray Tanaka, and Daniela Smith have worked with them before."
        }
    ],
    "hasMoreResults": false
}

下图中的示例显示了如何将 API 的输出映射到电子邮件摘要。

屏幕截图显示了电子邮件摘要中来自合作伙伴应用的见解。

图例：

见解的标题。具有相同标题的见解将分组在一起。
见解的说明。每个见解都有一个描述。

另请参见

利用 Outlook 中的 Copilot 使用销售信息汇总电子邮件线程
 向 Sales 聊天添加新的问答（Q&A）功能
 利用应用程序中的洞察丰富关键销售信息
 使用应用程序中的见解扩充 CRM 记录详细信息
 使用来自应用程序的见解丰富 CRM 记录摘要
 使用合作伙伴应用程序扩展 Microsoft 365 Copilot 销售人员
 构建销售用 Copilot 扩展

通过