總覽

Gemini Enterprise 的 Microsoft OneDrive 資料儲存庫可讓您搜尋檔案和資料夾，並執行相關操作。

支援的 Microsoft OneDrive 版本

Microsoft OneDrive 資料儲存庫可透過 Microsoft Graph API 1.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 權限

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

注意：下表列出各連線模式所需的權限。如果您為「Federated search」(聯合搜尋) 或「Data ingestion」(資料擷取) 連線模式啟用「Actions」(動作)，也請選取「Actions」(動作) 列中列出的權限。

連線模式 範圍 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 perimeter。如要強制執行 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 擷取資料儲存庫的限制如下：

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

建議

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

後續步驟