借助适用于 Gemini Enterprise 的 Microsoft OneDrive 数据存储区，您可以搜索文件和文件夹，并对其执行操作。
支持的 Microsoft OneDrive 版本
Microsoft OneDrive 数据存储区通过 Microsoft Graph API v1.0 支持所有托管版本的 Microsoft OneDrive。
支持的操作
启用 Microsoft OneDrive 数据存储区后，最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。
| 操作 | 说明 |
|---|---|
| 创建文件夹 | 在 Microsoft OneDrive 中的指定路径下创建新文件夹。 |
| 复制文件 | 将文件从 Microsoft OneDrive 中的来源复制到目标位置。 |
| 上传文件 | 将文件上传到 Microsoft OneDrive 中的指定位置。 |
| 下载文件 | 将文件从 Microsoft OneDrive 下载到指定位置。 |
| 复制文件夹 | 将文件夹从 Microsoft OneDrive 中的来源复制到目标位置。 |
| 移动文件 | 将文件从 Microsoft OneDrive 中的来源位置移动到目标位置。 |
| 移动文件夹 | 在 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 |
委托：允许数据存储区读取、下载、创建、上传、更新和删除用户有权访问的文件。 | |
Files.ReadWrite.All |
（委托）允许数据存储区读取和更新用户有权访问的所有云端硬盘中的文件。对存储在用户自己的 Microsoft OneDrive 以外的云端硬盘中的文件执行文件和文件夹变更操作（复制、移动、重命名、共享、更新属性）时，需要此权限。 |
如需了解如何为 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 数据存储区。