借助适用于 Gemini Enterprise 的 Microsoft OneDrive 数据存储区，您可以搜索文件和文件夹并对其执行操作。
支持的 Microsoft OneDrive 版本
通过 Microsoft Graph API v1.0，Microsoft OneDrive 数据存储区可支持所有托管版本的 Microsoft OneDrive。
支持的操作
启用 Microsoft OneDrive 数据存储区后，最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。
| 操作 | 说明 |
|---|---|
| 创建文件夹 | 在 Microsoft OneDrive 中的指定路径下创建新文件夹。 |
| 复制文件 | 将文件从 Microsoft OneDrive 中的来源复制到目标。 |
| 上传文件 | 将文件上传到 Microsoft OneDrive 中的指定位置。 |
| 下载文件 | 将文件从 Microsoft OneDrive 下载到指定位置。 |
所需权限
如需让 Gemini Enterprise 使用 Microsoft OneDrive 数据存储区执行搜索和数据注入操作，您需要拥有以下权限：
Microsoft Graph API 权限
下表列出了每种连接模式所需的权限。
注意 ：下表列出了每种连接模式所需的权限。如果您为联合搜索 或数据注入 连接模式启用了操作 ，请同时选择操作 行中列出的权限。
| 连接模式 | 范围 | 用途 |
|---|---|---|
| 联合搜索 | Files.Read.All |
（委托）允许数据存储区读取用户可以访问的所有文件。 |
Sites.Read.All |
（委托）允许数据存储区读取用户可以访问的所有网站集中的文档和列表项。 | |
User.Read.All |
（委托）允许数据存储区解析用户云端硬盘位置以发现内容。 | |
| 数据注入 | GroupMember.Read.All |
（联合凭证和 OAuth 2.0 刷新令牌）允许数据存储区在没有已登录用户的情况下读取所有群组的成员资格和基本群组属性。 |
User.Read |
（联合凭证和 OAuth 2.0 刷新令牌）允许数据存储区读取已登录用户的个人资料。它还允许数据存储区读取已登录用户的基本公司信息。 | |
User.Read.All |
（仅限 OAuth 2.0 刷新令牌）允许数据存储区读取用户个人资料。 | |
Sites.FullControl.All（选项 1）Sites.Selected（选项 2） |
（联合凭证和 OAuth 2.0 刷新令牌）选项 1 允许数据存储区完全控制所有网站集。选项 2 允许数据存储区访问部分网站集。您可以在 Microsoft OneDrive 中配置具体的网站集和授予的权限。 | |
User.Read.All（选项 1）User.ReadBasic.All（选项 2） |
（仅限联合凭证）选项 1 允许数据存储区读取用户个人资料。选项 2 允许数据存储区读取组织中其他用户的一组基本个人资料属性。 | |
| 操作 | Files.ReadWrite.AppFolder |
（委托）允许数据存储区读取、创建、更新和删除 Microsoft OneDrive 文件夹中的文件。 |
Files.ReadWrite |
委托：允许数据存储区读取、下载、创建、上传、更新和删除用户可以访问的文件。 |
如需了解如何添加 Microsoft OneDrive 的权限，请参阅配置 Microsoft OneDrive 并设置必要的权限。
限制
本部分列出了可能会影响您使用 Microsoft OneDrive 数据存储区的已知问题和限制。
- 创建新应用或向现有应用添加数据存储区时，建议仅将一个数据存储区与属于单个连接器类型的操作相关联。
- 不支持对现有 Microsoft OneDrive 数据存储区强制执行 VPC Service Controls 边界。 如需强制执行 VPC Service Controls，您必须删除并重新创建该数据存储区。如需详细了解 VPC Service Controls 以及如何在启用 VPC Service Controls 后使用操作，请参阅 使用 VPC Service Controls 保护应用的安全。
- Microsoft OneDrive 数据存储区仅在
global,us, 和eu位置受支持。
以下是 Microsoft OneDrive 联合数据存储区的限制：
- 搜索限制：搜索结果可能会有所不同，并且不总是全面覆盖所有文件类型。您可能无法搜索归档或加密文件夹中的内容。联合搜索不支持在附件中进行搜索。
- 委托的访问权限 ：访问共享的 Microsoft OneDrive 文件或文件夹可能需要标准用户授权未涵盖的特定权限。
- 联合搜索模式下的布局解析器 ：虽然布局解析器是标准解析器，但在联合搜索模式下，它对复杂 PDF（包含表格、多列布局或需要 OCR）的有效性有限。此模式的实时 API 调用可能无法提供布局解析器在数据注入期间执行深度分析所需的完整数据或时间。
不支持的 PDF 功能 ：因此，系统可能无法完全分析或搜索复杂的 PDF 结构。包括：
- 多列文本布局
- 嵌入式表格和图表中的数据
- 需要光学字符识别 (OCR) 的扫描文档中的文本
- 具有非线性阅读顺序或复杂格式的文档。
以下是 Microsoft OneDrive 注入数据存储区的限制：
- 增量同步不会检测到文件夹级操作，例如复制、移动或重命名。
建议
对于包含具有复杂功能（例如表格、多列布局或依赖于 OCR 的内容）的 PDF 的 Microsoft OneDrive 数据，我们建议使用数据注入模式进行有效搜索。此模式允许布局解析器深入处理整个文档内容并为其编制索引。
后续步骤
- 如需使用 Microsoft OneDrive 创建和配置数据存储区，请参阅设置 Microsoft OneDrive 数据存储区。