總覽

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 權限

下表列出各連線模式所需的權限。

注意：下表列出各連線模式所需的權限。如果為「聯合搜尋」或「資料擷取」連線模式啟用「動作」，請一併選取「動作」列中列出的權限。

連線模式 範圍 Purpose
聯合搜尋 不適用 不需要任何 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 權限

下表列出各連線模式所需的權限。

連線模式 範圍 Purpose
聯合搜尋 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) 的掃描文件文字
    • 具有非線性閱讀順序或複雜格式的文件。

建議

如果 Microsoft SharePoint 資料包含具有複雜功能的 PDF (例如表格、多欄版面配置或需要 OCR 的內容)，建議使用標準擷取模式，以便有效搜尋。這個模式可讓版面配置剖析器深入處理整個文件內容並建立索引。

排解 SharePoint 連接器搜尋結果問題

如果文件遺失、結果有誤或搜尋結果關聯性不佳，請檢查下列診斷區域：

  • 檢查人員資料儲存庫：如果遇到相關性或實體比對問題，請確認人員搜尋資料儲存庫已設定並同步。
  • 驗證錯誤：如果持續發生驗證錯誤 (例如「擷取 Graph API 存取權杖時發生錯誤」)，搜尋功能將無法運作。如要解決這個問題，請查看 Microsoft Entra ID 記錄瞭解詳細資料，然後重新驗證連線。
  • 身分不符：如果使用 Google Identity，請確認使用者的 Google 電子郵件地址與 Microsoft SharePoint 電子郵件地址完全相符。如果不相符，系統就不會傳回結果。
  • 指定資料夾搜尋 (.aspx 網址)：使用以 /Forms/AllItems.aspx 結尾的完整瀏覽器網址進行搜尋時，系統會搜尋整個網站，而不只是特定資料夾。請一律使用絕對資料夾路徑進行目標搜尋。
  • 結果限制：請注意，聯合搜尋可能會限制每個查詢傳回的文件數量 (通常最多約 20 個結果)。
  • 引用問題：可能會出現間歇性引用錯誤。如果問題持續發生，請向支援團隊回報，並附上診斷權杖。
  • 連結器與模型相容性：請務必使用最新版 Gemini 模型。部分舊型號 (例如 3.x) 在解決 SharePoint 動作的工具時，會發生已知問題，例如 Agent Builder 中的 download_document。

後續步驟