總覽

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

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

連線模式	範圍	Purpose
聯合搜尋	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 擷取資料儲存庫的限制如下：

• 增量同步無法偵測資料夾層級的操作，例如「複製」、「移動」或「重新命名」。

建議

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

後續步驟

• 如要使用 Microsoft OneDrive 建立及設定資料儲存庫，請參閱「設定 Microsoft OneDrive 資料儲存庫」。