使用应用程序的见解扩充电子邮件摘要（预览）
重要提示
- 这是生产就绪预览功能。
- 生产就绪预览需要满足补充使用条款。
[本文为预发布文档，可能会发生变化。]
当 Outlook 中的 Copilot 和销售用 Copilot 一起使用时，Outlook 中显示的电子邮件摘要包括来自客户关系管理 (CRM) 系统（如 Dynamics 365 或 Salesforce CRM）的销售信息。 您可以利用您自己的应用程序中的见解来扩展销售用 Copilot 提供的电子邮件摘要功能。
API 描述
您必须将以下 API 说明添加到操作中。 这样，销售用 Copilot 可以识别必须调用来扩充功能的正确 API。
此操作将获得额外的销售见解，这些见解将在 Outlook 摘要中的 C4S 电子邮件摘要体验中显示。 操作增强了销售用 Copilot 的现有技能。
API 运算
此 API 使用运算类型：GET
输入参数
销售用 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。 |
此输入指示当前电子邮件线程中所有相关参与者电子邮件的列表。 |
| 上 | 整型 | 不可以 | 要提取的见解数。 | 此输入指示要提取的见解数量。 |
| 跳过 | 整型 | 不可以 | 要跳过的见解数。 | 此输入指示提取见解时要跳过的项目数。 |
输出参数
销售用 Copilot 预期会从您的 API 收到见解（对象）列表，并预期每个见解都有特定的参数。 为确保销售用 Copilot 能够正确分析输出，响应结构必须符合下表中的准则。
| 参数 | 数据类型 | 必需 | 详情 |
|---|---|---|---|
| value | 数组 | 可以 | 见解（对象）列表，按见解架构一节描述的方法定义。 注意：虽然此参数包含一系列见解，但在电子邮件扩充摘要中只使用第一个见解。 |
| hasMoreResults | 布尔型 | 不可以 | 指示是否有更多可用结果的值。 |
见解架构
| 客户 | 数据类型/格式 | 必需 | 详情 | 要在操作中添加的说明 |
|---|---|---|---|---|
| 称谓 | 字符串，最多 20 个字符 | 可以 | 销售见解的标题。 | 此输出指示合作伙伴部分的标题，应仅包括合作伙伴的名称。 |
| Description | String | 可以 | 提供给用户的见解，如您的同事 Mona Kane、Ray Tanaka 和 Daniela Smith 之前曾与他们一起工作过。 | 此输出指示您希望包含在电子邮件摘要中的文本。 |
备注
虽然扩展电子邮件摘要功能和记录摘要功能的 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 使用销售信息汇总电子邮件线程
使用应用程序中的见解扩充关键销售信息
使用应用程序中的见解扩充 CRM 记录详细信息
使用应用程序中的见解扩充 CRM 记录摘要
使用合作伙伴应用程序扩展销售用 Microsoft 365 销售用 Copilot
使用应用程序中的文件链接扩充电子邮件草稿
构建销售用 Copilot 扩展