概览

借助适用于 Gemini Enterprise 的 Microsoft Outlook 数据存储区，您可以搜索和执行对电子邮件、日历、联系人以及存储在 OneDrive 和 SharePoint 中的 Microsoft 365 文件（Excel 工作簿、Word 文档和 PowerPoint 演示文稿）的操作。

支持的 Microsoft Outlook 版本

Microsoft Outlook 数据存储区支持 Microsoft Graph API v1.0 与 IDP 的集成。

支持的操作

启用 Microsoft Outlook 数据存储区后，最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。

操作	说明
创建联系人	在 Microsoft Outlook 中创建新联系人。
创建活动	创建新活动。
下载附件	从 Microsoft Outlook 电子邮件中下载附件。
发送邮件	发送邮件。这包括发送带有附件的邮件。
更新联系人	更新 Microsoft Outlook 中的现有联系人。
更新活动	更新现有活动。
读取 Excel 数据	列出工作簿，从存储在 OneDrive 或 SharePoint 中的 Excel (.xlsx) 文件中读取工作表、表格和行。
修改 Excel 数据	在存储于 OneDrive 或 SharePoint 中的 Excel (.xlsx) 文件中添加和更新行、创建工作表和表格，以及添加关键列。
创建 Word 文档	在用户的 OneDrive 中创建新的 Word (.docx) 文档。
将 Word 文档转换为 PDF	将存储在 OneDrive 或 SharePoint 中的 Word (.docx) 文档转换为 PDF。
创建 PowerPoint 演示文稿	在用户的 OneDrive 中创建新的 PowerPoint (.pptx) 演示文稿。
将 PowerPoint 转换为 PDF	将存储在 OneDrive 或 SharePoint 中的 PowerPoint (.pptx) 演示文稿转换为 PDF。

注意:

• 您还可以执行其他只读操作。
• 在 Gemini Enterprise 中上传和下载文件的文件大小上限为 25 MB。
• Excel、Word 和 PowerPoint 操作需要用户正在使用的 OneDrive 或 SharePoint 文件具有额外的 Microsoft Graph API 权限。如需了解详情，请参阅 [所需权限](#required-permissions)。

所需权限

下表列出了 Microsoft Outlook 搜索和操作所需的权限。

连接模式	权限	用途
联合搜索	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	（委托）允许数据存储区读取已登录用户的邮箱， 共享邮箱中的电子邮件、日历活动和联系人。
数据注入	Calendars.Read	（应用）允许数据存储区读取所有日历的活动。
	Calendars.ReadBasic.All	（应用）允许数据存储区读取所有日历的活动，但不能读取正文、附件和扩展等属性。
	Contacts.Read	（应用）允许数据存储区读取所有邮箱中的所有联系人。
	Mail.Read	（应用）允许数据存储区读取所有邮箱中的邮件。
	Mail.ReadBasic	（应用）允许数据存储区读取所有邮箱中的基本邮件属性。包括除正文、previewBody、附件和任何扩展属性之外的所有属性。
	Mail.ReadBasic.All	（应用）允许数据存储区读取所有邮箱中的基本邮件属性。包括除正文、previewBody、附件和任何扩展属性之外的所有属性。
	User.Read	（委托）允许数据存储区读取已登录用户的个人资料。
	User.Read.All	（应用）允许数据存储区读取组织中其他用户的一组完整个人资料属性、报告和管理者。
	User.ReadBasic.All	（应用）允许数据存储区读取组织中其他用户的一组基本个人资料属性。
操作	Mail.Send	（委托）允许数据存储区以组织中用户的身份发送邮件。
	Calendars.ReadWrite	（委托）允许数据存储区在用户日历中创建、读取、更新和删除活动。
	Contacts.ReadWrite	（委托）允许数据存储区创建、读取、更新和删除用户联系人。
	User.Read	（委托）允许数据存储区读取已登录用户的个人资料。
文件效率（Excel、Word、PowerPoint）	Files.Read.All	（委托）对 Excel 工作簿执行读取操作（列出、获取工作表、获取表格、获取行）以及将 Word 或 PowerPoint 转换为 PDF 时需要此权限。读取用户可以访问的所有文件，包括存储在用户有权访问的 SharePoint 网站中的文件。
	Files.ReadWrite.All	（委托）执行写入操作时需要此权限：在用户的 OneDrive 中创建 Excel 工作表和表格、添加和更新 Excel 行、添加关键列，以及创建 Word 和 PowerPoint 文档。
	User.Read	（委托）解析已登录用户的 OneDrive 位置以进行文件操作时需要此权限。
任务（Outlook 待办事项列表和任务）	Tasks.Read	（委托）对已登录用户的 Outlook 任务列表和任务执行读取操作（列出任务列表、列出任务、获取任务）时需要此权限。
	Tasks.ReadWrite	（委托）执行写入操作时需要此权限：在已登录用户的 Outlook 任务列表中创建、更新和删除任务。
用户和目录（委托枚举）	User.ReadBasic.All	（委托）枚举或查找组织中其他用户的个人资料（获取用户、列出用户，以及对其他用户的邮箱或日历执行操作的工具）的工具需要此权限。

注意 ：上述文件效率操作需要用户的租户管理员在 OAuth 应用注册中授予相应的 Microsoft Graph API 权限。如果未授予这些权限，则对 Excel、Word 和 PowerPoint 工具的请求会失败，并显示 HTTP 403 accessDenied 错误。对于具有更严格的最低权限要求的租户，可以使用 Sites.Read.All / Sites.ReadWrite.All（网站范围）或 Sites.Selected（在 Microsoft Entra 中配置的特定网站集）替换相应的 Files.* 范围。如需了解设置步骤，请参阅配置 Microsoft Outlook 并设置必要的权限，如需查看接受的替代方案的完整列表，请参阅Microsoft Graph 委托权限。

注意：缺少 Tasks.Read 或 Tasks.ReadWrite 会导致 Outlook 任务工具失败，并显示 HTTP 403 notAllowed。缺少 User.ReadBasic.All（委托）会导致用户查找工具失败，并显示 HTTP 403 Authorization_RequestDenied。需要更高权限的用户访问权限的租户可以使用 User.Read.All 或 Directory.Read.All 替换 User.ReadBasic.All。

如需了解如何添加 Microsoft Outlook 的权限，请参阅 配置 Microsoft Outlook 并设置必要的权限。

数据注入的速率限制

请求量限制为每 10 分钟内 10,000 个 API 请求。当您选择使用注入作为连接模式时，这些速率限制仅适用于 Microsoft Outlook 数据存储区。

限制

本部分列出了可能会影响您使用 Microsoft Outlook 数据存储区的已知问题和限制。

• 创建新应用或向现有应用添加数据存储区时，建议仅将一个数据存储区与属于单个连接器类型的操作相关联。

• 不支持对现有 Microsoft Outlook 数据存储区强制执行 VPC Service Controls 边界。 如需强制执行 VPC Service Controls，您必须删除并重新创建该数据存储区。如需详细了解 VPC Service Controls 以及如何在启用 VPC Service Controls 后使用操作，请参阅 使用 VPC Service Controls 保护应用的安全。

• Microsoft Outlook 数据存储区仅在 global、us 和 eu 位置受支持。

• Microsoft Outlook 数据存储区可以处理每个节点每秒一个事务，并限制超出此限制的任何事务。

• Microsoft Outlook 数据存储区在出现速率限制超出错误时重试的能力取决于是否从 Microsoft Graph API 收到“retry-after”值，该值仅针对 Outlook 数据存储区提供。 默认重试次数为 3 次。

• Microsoft Outlook 数据存储区的吞吐量受 Microsoft Graph 设定的 API 调用限制的约束。限制适用于每个应用 ID 和邮箱组合，即特定应用访问特定用户或群组邮箱。超出某个邮箱的限制不会影响应用访问其他邮箱的能力。

后续步骤

• 如需使用 Microsoft Outlook 创建和配置数据存储区，请参阅设置 Microsoft Outlook 数据存储区。