借助适用于 Gemini Enterprise 的 Microsoft SharePoint 数据存储区，您可以搜索 Microsoft SharePoint Online 数据（包括文档、列表和网站）并对其执行操作。
支持的 Microsoft SharePoint 版本
Microsoft SharePoint 数据存储区支持最新云版 Microsoft SharePoint Online。
支持的操作
启用 Microsoft SharePoint 数据存储区后，最终用户可以在 Gemini Enterprise 中使用自然语言命令来执行以下操作。
| 操作 | 说明 |
|---|---|
| 创建文件夹 | 在指定路径中创建新文件夹。 |
| 添加列表 | 在 Microsoft SharePoint 网站上创建新的结构化数据列表（例如任务、联系人）。 |
| 上传文档 | 将文档上传到 Microsoft SharePoint 网站或库。 |
| 下载文档 | 从 Microsoft SharePoint 网站或库下载文档。 |
| 添加页面 | 在 Microsoft SharePoint 网站上创建新网页。 |
| 查看文档 | 从 Microsoft SharePoint 库中签出文档。 |
| 在文档中查看 | 将文档签入 Microsoft SharePoint 库。 |
| 重命名附件或文档 | 重命名 Microsoft SharePoint 库中的附件或文档。 |
| 移动附件或文档 | 将文档从 Microsoft SharePoint 库移动到目标库、文件夹或其他 SharePoint 网站。 |
| 舍弃签出文档 | 舍弃文档的签出，在不保存更改的情况下将其恢复。 |
| 共享资源 | 与指定收件人共享文档、文件夹或资源，或生成共享链接。 |
| 更新文件属性 | 更新 Microsoft SharePoint 库中某个文档的元数据属性。 |
| 更新页面 | 更新 Microsoft SharePoint 网站上的现有网页。 |
| 更新列表 | 更新 Microsoft SharePoint 网站上现有结构化数据列表的设置。 |
| 创建列表项 | 在 Microsoft SharePoint 网站上的指定列表中创建新项。 |
| 更新列表项 | 更新指定列表中的现有商品的字段。 |
| 列出列表 | 检索指定 Microsoft SharePoint 网站中的所有列表和文档库。 |
| 获取列表项 | 返回单个列表项，包括其所有列值。 |
| 获取列表字段 | 返回指定列表的架构，包括其所有字段及其属性。 |
所需权限
如需让 Gemini Enterprise 使用 Microsoft SharePoint 数据存储区执行搜索和数据注入操作，您需要拥有以下权限：
Microsoft Graph API 权限
下表概述了每种连接模式所需的权限。
注意：下表概述了每种连接模式所需的权限。如果您为联合搜索或数据注入连接模式启用了操作，还应选择操作行中列出的权限。
| 连接模式 | 范围 | 用途 |
|---|---|---|
| 联合搜索 | 不适用 | 无需任何 Graph API 权限。 |
| 数据注入 | 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 允许数据存储区访问部分网站集合。您可以在 SharePoint Online 中配置特定的网站集和授予的权限。 | |
User.Read.All（选项 1）User.ReadBasic.All（选项 2） |
（仅限联合凭证）选项 1 允许数据存储区读取用户个人资料。选项 2 允许数据存储区读取组织中其他用户的一组基本个人资料属性。 | |
| 操作 | Sites.ReadWrite.All |
（联合搜索和数据注入）允许数据存储区代表已登录的用户修改或删除所有网站集中的文档和列表项。 |
Sites.Read.All |
（联合搜索和数据注入）允许数据存储区代表已登录的用户读取所有网站集中的列表、列表项和列表架构。对于列出列表、获取列表项和获取列表字段操作，此参数是必需的。 | |
Files.ReadWrite |
允许数据存储区读取、创建、更新和删除已登录用户的文件。 | |
Files.ReadWrite.All |
允许数据存储区读取、创建、更新、删除、上传和下载已登录用户可访问的所有文件。 | |
Sites.Manage.All |
允许数据存储区代表用户在所有网站集中创建或删除文档库和列表。 |
Microsoft SharePoint API 权限
下表概述了每种连接模式所需的权限。
| 连接模式 | 范围 | 用途 |
|---|---|---|
| 联合搜索 | Sites.Search.All（委派） |
允许数据存储区代表当前已登录的用户运行搜索查询并读取基本网站信息。搜索结果基于用户权限，而非应用权限。 |
AllSites.Read（选项 1，委派） |
允许数据存储区代表已登录的用户读取所有网站集中的文档和列表项。 | |
Sites.Selected（选项 2，委派） |
允许数据存储区访问已登录用户的部分网站集。您可以在 SharePoint Online 中配置特定的网站集和授予的权限。 | |
| 数据注入（联合凭证） | Sites.FullControl.All（选项 1，应用） |
允许数据存储区完全控制所有网站集。 |
Sites.Selected（选项 2，应用） |
允许数据存储区访问已登录用户的部分网站集。您可以在 SharePoint Online 中配置特定的网站集和授予的权限。 | |
| 数据注入（OAuth 2.0 刷新令牌） | AllSites.FullControl（选项 1，委派） |
允许数据存储区代表已登录的用户完全控制所有网站集。 |
Sites.Selected（选项 2，委派） |
允许数据存储区访问已登录用户的部分网站集。您可以在 SharePoint Online 中配置特定的网站集和授予的权限。 | |
| 操作 | AllSites.Write（委派） |
允许数据存储区代表已登录的用户在所有网站集中创建、读取、更新、删除、上传和下载文档及列表项。 |
如需了解如何添加 Microsoft SharePoint 的权限，请参阅配置 Microsoft SharePoint 并设置必要的权限。
限制
本部分概述了可能会影响您使用 Microsoft SharePoint 数据存储区的已知问题和限制。
- 创建新应用或向现有应用添加数据存储区时，建议仅将一个数据存储区与属于单个连接器类型的操作相关联。
- 不支持对现有 Microsoft SharePoint 数据存储区强制执行 VPC Service Controls 边界。 如需强制执行 VPC Service Controls，您必须删除并重新创建该数据存储区。如需详细了解 VPC Service Controls 以及如何在启用 VPC Service Controls 后使用操作，请参阅使用 VPC Service Controls 保护应用的安全。
- Microsoft SharePoint 数据存储区仅在
global、us和eu位置受支持。
- 搜索质量前提条件：为了获得最佳搜索结果并充分利用知识图谱功能，我们建议除了 Microsoft SharePoint 数据存储区之外，还配置并同步人员搜索数据存储区。
Microsoft SharePoint 联合数据存储区存在以下限制：
- 搜索限制：搜索结果可能会有所不同，并且不总是全面覆盖所有文件类型。您可能无法搜索已归档或加密的文件夹中的内容。联合搜索不支持在附件中进行搜索。
- 委托访问权限：访问共享网站或库可能需要特定权限，而标准用户授权无法涵盖这些权限。
- 联合搜索模式下的布局解析器：虽然布局解析器是标准配置，但在联合搜索模式下，它对复杂 PDF（包含表格、多列布局或需要 OCR）的有效性有限。此模式的实时 API 调用可能无法提供布局解析器在数据注入期间执行深度分析所需的完整数据或时间。
- 不支持的 PDF 功能：因此，复杂的 PDF 结构可能无法得到全面分析或搜索。其中包括：
- 多列文本布局
- 嵌入式表格和图表中的数据
- 需要进行光学字符识别 (OCR) 的扫描文档中的文本
- 具有非线性阅读顺序或复杂格式的文档。
建议
对于包含具有复杂功能（例如表格、多列布局或依赖于 OCR 的内容）的 PDF 的 Microsoft SharePoint 数据，我们建议使用标准提取模式以实现有效的搜索。此模式允许布局解析器深入处理整个文档内容并将其编入索引。
排查 SharePoint 连接器搜索结果问题
如果您遇到文档缺失、结果不正确或搜索相关性较差的问题，请检查以下诊断区域：
- 检查“人物”数据存储区：如果您遇到相关性或实体匹配问题，请确保已设置“人物搜索”数据存储区并正在同步。
- 身份验证错误：持续存在的身份验证错误（例如“检索 Graph API 访问令牌时出错”）会导致搜索功能无法正常运行。如需解决此问题，请查看 Microsoft Entra ID 日志了解详情，然后重新对连接进行身份验证。
- 身份不匹配：如果使用 Google Identity，请验证用户的 Google 电子邮件地址是否与 Microsoft SharePoint 电子邮件地址完全一致。不匹配会导致系统无法返回结果。
- 指定文件夹搜索 (.aspx 网址)：使用以
/Forms/AllItems.aspx结尾的完整浏览器网址进行搜索时，系统会在整个网站（而不仅仅是特定文件夹）中执行搜索。请务必使用绝对文件夹路径进行定向搜索。 - 结果限制：请注意，联合搜索可能会限制每个查询返回的文档数量（通常上限约为 20 个结果）。
- 引用问题：可能会出现间歇性引用不正确的情况。如果问题持续存在，请向支持团队报告该问题，并附上您的诊断令牌。
- 连接器-模型兼容性：确保您使用的是最新的 Gemini 模型版本。某些旧版模型（例如 3.x）在解决 SharePoint 操作（例如 Agent Builder 中的
download_document）的工具方面存在已知问题。
后续步骤
- 如需创建和配置 Microsoft SharePoint 数据存储区，请参阅设置 Microsoft SharePoint 数据存储区。