設定檔案選擇器的驗證機制

與 Gemini Enterprise 助理對話時,使用者可以透過檔案選擇器附加檔案。助理支援三種檔案來源:本機檔案、Google 雲端硬碟檔案和 Microsoft OneDrive 檔案。本頁面說明管理員如何設定這項行為。

如要讓使用者從 Google 雲端硬碟和 OneDrive 選取檔案,您可以重複使用設定 Google 雲端硬碟資料儲存庫和 OneDrive 資料儲存庫時建立的資料儲存庫設定,控管使用者的登入方式。您可以控管下列項目:

  • 挑選器使用的登入應用程式。挑選器可以重複使用您在連接器上設定的 Microsoft Entra (舊稱 Azure AD) 或 Google 應用程式,而非預設的 Google 代管應用程式。
  • OneDrive 挑選器使用的 Microsoft Entra 租用戶。OneDrive 挑選器可讓使用者登入特定的 Microsoft Entra 租戶。

如要瞭解使用者附加檔案和與檔案對話的體驗,請參閱「上傳檔案並與檔案對話」。

檔案選擇器的運作方式

如果您將 Google 雲端硬碟和 OneDrive 資料儲存庫設為使用相同的檔案選擇器授權設定,檔案選擇器會使用相同設定驗證使用者。下表摘要說明這兩個控制項,以及受影響的挑選器。

控制項 用途 套用對象
自訂登入應用程式 使用者透過檔案選擇器將檔案附加至助理時,Gemini Enterprise 可使用資料儲存庫現有的 Microsoft Entra ID 或 Google Identity 設定來驗證使用者,而非預設的 Google 代管應用程式。 Google 雲端硬碟和 OneDrive
租戶強制執行 OneDrive 挑選器會要求使用者登入特定的 Microsoft Entra 租戶 (https://login.microsoftonline.com/{your-tenant}/...),而非共用登入端點 (/common/),因此其他租戶的使用者無法進行驗證。系統會從附加的 OneDrive 連接器讀取租戶。 僅限 OneDrive

管理員可將連接器附加至應用程式,設定這項行為。

指定設定提供者時,適用下列規則:

  • 每種接頭類型只能有一個供應商。一次只能將一個 OneDrive 設定供應商和一個 Google 雲端硬碟設定供應商附加至應用程式。如果將相同類型的第二個連接器標示為供應器,系統會拒絕並傳回無效引數錯誤。
  • 供應商必須是支援動作的連接器。設定供應商必須是支援動作或聯合存取權的 OneDrive 或 Google 雲端硬碟連接器。僅限擷取的連接器無法做為設定提供者。詳情請參閱「管理動作」。

事前準備

設定檔案選擇器前,請先確認下列事項:

  • 管理員存取權授予 Discovery Engine 編輯者角色 (roles/discoveryengine.editor)。使用者必須具備這個角色,才能建立資料儲存庫。請按照下列步驟操作來授予這個角色:
    1. 前往 Google Cloud 控制台的「IAM」(身分與存取權管理) 頁面。

      前往「IAM」頁面

    2. 找出使用者帳戶,然後點選「編輯」。
    3. 將 Discovery Engine Editor 角色授予使用者。詳情請參閱「IAM 角色和權限」。
  • 自訂 OneDrive 登入應用程式:請確認您擁有可控管的 Microsoft Entra ID 應用程式,包括用戶端 ID、用戶端密鑰和租戶 ID,以及該租戶中的 OneDrive 帳戶,以便進行測試。詳情請參閱「向 Microsoft Identity Platform 註冊應用程式」。
  • 已設定的資料儲存庫。設定 OneDrive 或 Google 雲端硬碟資料儲存庫。設定資料儲存庫時,您需要設定驗證設定,包括用戶端 ID、用戶端密鑰,以及 OneDrive 資料儲存庫的租戶 ID。詳情請參閱:
  • 附加的資料儲存庫。將 OneDrive 資料儲存庫或 Google 雲端硬碟資料儲存庫附加至 Gemini Enterprise 應用程式。詳情請參閱「將資料儲存庫連結至應用程式」。

使用自己的登入應用程式

根據預設,挑選器會使用 Google 代管的應用程式登入。您可以將一個連接器指定為挑選器的設定提供者,讓挑選器改用您自己的 Microsoft Entra ID 或 Google Identity。

如果您已設定 OneDrive 或 Google 雲端硬碟資料儲存庫,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 選取或建立 Google Cloud 專案。

  3. 點按導覽選單中的「Data Stores」(資料儲存庫)。

  4. 搜尋資料儲存庫,然後點選資料儲存庫名稱。

  5. 按一下「查看/編輯參數」。

  6. 選取「Picker Config Provider」選項。

  7. 按一下「儲存」。

還原變更,改用 Google 代管的應用程式

如要改回使用 Google 管理的預設應用程式進行檔案選擇器驗證,請按照下列步驟操作:

  1. 前往 Google Cloud 控制台的「Gemini Enterprise」頁面。

    Gemini Enterprise

  2. 選取 Google Cloud 專案。

  3. 點按導覽選單中的「Data Stores」(資料儲存庫)。

  4. 點按資料儲存庫的名稱。

  5. 按一下「查看/編輯參數」。

  6. 清除「Picker Config Provider」欄位。

  7. 按一下「儲存」。

使用者體驗

設定挑選器後,使用者會看到以下畫面:

  • 如果是 OneDrive,系統會提示使用者登入貴組織的 Microsoft 租戶。其他租戶的帳戶則會遭到拒絕。
  • 登入時會使用您設定的應用程式:預設為 Google 代管的應用程式,如果您設定了設定供應商,則會使用您自己的應用程式。
  • 首次成功登入後,系統會記住連線,以便後續選取檔案。

如要進一步瞭解使用者體驗,請參閱「上傳檔案並與檔案對話」。

疑難排解

問題 可能原因 解析度
將連接器標示為 **Picker Config Provider** 時失敗,並顯示 Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. 同一個引擎中的另一個連接器已是挑選器設定提供者。一個引擎最多只能有一個。 清除其他連接器上的「Picker Config Provider」參數,然後重試。
OneDrive 登入失敗,並顯示 AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...' 使用者帳戶所在的 Microsoft Entra 租用戶,與連接器上設定的租用戶不同。租戶專屬登入端點會拒絕該帳戶。 租戶強制執行功能運作正常。請使用者以您設定的租戶帳戶登入,或更新連接器的租戶 ID。
OneDrive 仍會提示共用登入端點。 尚未設定租戶,或變更尚未生效。 確認連接器的租戶 ID。設定變更最多可能需要約 3 分鐘才會生效,請稍候再試。

後續步驟