概览

借助适用于 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。
创建日历 为已登录的用户创建新日历。
更新日历 为已登录的用户更新现有日历。
回复活动邀请 回复（接受、拒绝或暂定接受）日历活动邀请。

所需权限

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

连接模式 权限 用途
联合搜索 Mail.Read
Mail.Read.Shared
Calendars.Read
Contacts.Read		 （委托）允许数据存储区读取已登录用户的邮箱、共享邮箱中的邮件、日历活动和联系人。
数据注入 Calendars.Read （应用）允许数据存储区读取所有日历的活动。
Calendars.ReadBasic.All （应用）允许数据存储区读取所有日历的事件，但不能读取正文、附件和扩展等属性。
Contacts.Read （应用）允许数据存储区读取所有邮箱中的所有联系人。
Mail.Read （应用）允许数据存储区读取所有邮箱中的邮件。
Mail.ReadBasic （应用）允许数据存储区读取所有邮箱中的基本邮件属性。包含除 body、previewBody、attachments 和任何扩展属性之外的所有属性。
Mail.ReadBasic.All （应用）允许数据存储区读取所有邮箱中的基本邮件属性。包含除 body、previewBody、attachments 和任何扩展属性之外的所有属性。
User.Read （委托）允许数据存储区读取已登录用户的个人资料。
User.Read.All （应用）允许数据存储区读取组织中其他用户的一组完整个人资料属性、报告和管理者。
User.ReadBasic.All （应用）允许数据存储区读取组织中其他用户的一组基本个人资料属性。
操作 Mail.Send （委托）允许数据存储区以组织中用户的身份发送邮件。
Mail.ReadWrite （委托）允许数据存储区创建、读取、更新、移动和删除邮件，以及向邮件添加附件。“添加附件”“创建邮件”“更新邮件”和“移动邮件”操作需要此权限。
Calendars.ReadWrite （委托）允许数据存储区在用户日历中创建、读取、更新和删除事件。
Contacts.ReadWrite （委托）允许数据存储区创建、读取、更新和删除用户联系人。
User.Read （委托）允许数据存储区读取已登录用户的个人资料。
文件办公效率（Excel、Word、PowerPoint） Files.Read.All （委托）仅适用于读取文件元数据或下载文件内容的工具：列出 Excel 工作簿、读取 Excel 工作簿元数据，以及将 Word (.docx) 或 PowerPoint (.pptx) 文档转换为 PDF。读取用户可以访问的所有文件，包括存储在用户有权访问的 SharePoint 网站中的文件。不足以执行 Excel 工作簿内容操作（请参阅下一行）。
Files.ReadWrite.All （委托）所有 Excel 工作簿内容操作（读取和写入）都需要此权限，包括获取工作表、获取表、获取行、创建工作表和表、添加和更新行以及添加键列。根据这些端点（例如 worksheet-list、table-list、tablerow-list）的 Microsoft Graph API 参考文档，接受的委托权限为 Files.ReadWrite。Files.ReadWrite.All 会在用户可以访问的所有云端硬盘（个人 OneDrive 以及用户有权访问的任何 SharePoint 文档库）中授予相同的权限。在用户的 OneDrive 中创建 Word 和 PowerPoint 文档时也需要此权限。
User.Read （委托）需要解析已登录用户的 OneDrive 位置，以便执行文件操作。
任务（Outlook 待办事项清单和任务） Tasks.Read （委托）对已登录用户的 Outlook 任务列表和任务执行读取操作（列出任务列表、列出任务、获取任务）时需要。
Tasks.ReadWrite （委托）写入操作（在已登录用户的 Outlook 任务列表中创建、更新和删除任务）所需。
用户和目录（委托枚举） 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 数据存储区与单个 Azure 租户 ID 一一对应。它无法跨多租户组织 (MTO) 内的多个隔离的 Microsoft 365 租户。您必须为每个不同的租户创建一个专用数据存储区。

  • 邮箱必须完全迁移到 Exchange Online。无法通过 Microsoft Graph API 访问在 Hybrid Exchange 环境中托管在本地的邮箱。尝试查询这些邮箱或跨租户邮箱可能会导致 MailboxNotEnabledForRESTAPI 错误。

  • Microsoft Outlook 数据存储区每秒可处理一个事务，并会限制超出此限制的所有事务。

后续步骤