設定 Google 雲端硬碟資料儲存庫

本頁說明如何建立資料儲存庫,並將 Google 雲端硬碟連結至 Gemini Enterprise。連結後,Gemini Enterprise 就能直接從 Google 雲端硬碟擷取資訊。資料並不會複製到 Gemini Enterprise 索引,因此不必管理資料儲存作業。

事前準備

建立資料儲存庫前,請先按照下列步驟準備 Google 雲端硬碟環境:

  • 您登入 Google Cloud 控制台的帳戶,必須是待連結 Google 雲端硬碟執行個體所用的帳戶。Gemini Enterprise 會使用 Google Workspace 客戶 ID 連線至 Google 雲端硬碟。個人 Google 帳戶 (結尾為 @gmail.com 的消費者帳戶) 沒有客戶 ID,因此不支援。

  • 請務必設定識別資訊提供者,以強制執行資料來源存取控管,並保護 Gemini Enterprise 中的資料。

  • 確認所有文件都能存取,像是將文件放在網域擁有的共用雲端硬碟中,或是將擁有權授予網域中的使用者。

  • 在 Google Workspace 中啟用 Gemini Enterprise 存取權:在Google 管理控制台中,使用者和 Google 雲端硬碟資料所在組織的 Google Workspace 管理員,必須啟用「允許 Gemini Enterprise 存取 Google Workspace 資料」。如果關閉這項設定,Google 雲端硬碟搜尋就不會在 Gemini Enterprise 網頁應用程式中傳回結果 (且可能會在 API 中傳回 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. 錯誤)。如需操作說明,請參閱「控管 Gemini Enterprise 的 Google Workspace 資料存取權」。

  • 啟用智慧功能:在 Google Workspace 帳戶中,開啟「Google Workspace 智慧功能」和「其他Google 產品的智慧功能」。詳情請參閱「開啟或關閉 Google Workspace 智慧功能」。

  • 將 OAuth 應用程式加入許可清單:Google 雲端硬碟資料儲存庫會使用 Google代管的 OAuth 應用程式存取您的資料。如果貴組織限制 OAuth 應用程式存取權,Google Workspace 管理員必須將這個應用程式加入貴組織的許可清單。詳情請參閱「將 Google管理的 OAuth 應用程式加入許可清單」。

  • 設定跨組織存取權 (如適用):根據預設,只有在 Google Workspace 客戶 ID 與 Google 雲端硬碟資料儲存庫和 Google Cloud 專案的組織相符時,Gemini Enterprise 才允許使用者搜尋 Google 雲端硬碟資料儲存庫。如果使用者或 Google 雲端硬碟資料屬於其他 Google Workspace 組織 (例如 Google Cloud 專案位於某個網域,而使用者從一或多個獨立的 Google Workspace 網域或測試租戶登入),請完成下列步驟:

    1. 請與 Cloud Customer Care 聯絡,將每位使用者 Google Workspace 組織的客戶 ID (例如 C01234567) 新增至 Google Cloud 專案的許可清單。
    2. 請各 Google Workspace 組織的管理員,在該組織的 Google 管理控制台中,開啟「允許 Gemini Enterprise 存取 Google Workspace 資料」。僅在 Google Cloud 專案的組織中啟用這項設定是不夠的。詳情請參閱「控管 Gemini Enterprise 的 Google Workspace 資料存取權」。

    此外,如果使用者需要尋找機構外部擁有的文件,請為應用程式啟用「Include cross-domain documents」(包含跨網域文件)。您可以在建立應用程式時選取這個選項,或稍後在「Manage web app features」(管理網頁應用程式功能) 中啟用。

建立 Google 雲端硬碟資料儲存庫

如要建立 Google 雲端硬碟資料儲存庫,請執行下列步驟:

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

    Gemini Enterprise

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

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

  4. 點按「 Create data store」(建立資料儲存庫)。

  5. 在「Source」(來源) 部分中,搜尋「Google Drive」(Google 雲端硬碟),然後按一下「Select」(選取)。

  6. 選用:在「Data」(資料) 部分,設定篩選器,指定資料儲存庫搜尋的 Google 雲端硬碟內容範圍。如要使用 Google Cloud 控制台或 REST API 設定篩選器,請選取下列其中一個選項:

    控制台

    1. 在「Shared Drive IDs」(共用雲端硬碟 ID) 欄位和/或「Folder IDs」(資料夾 ID) 欄位中,輸入要篩選的 ID。
    2. 在每個欄位中,選擇「Include」(包含),只搜尋指定的 ID,或選擇「Exclude」(排除),在搜尋時略過這些 ID。請為每個欄位設定「Include」模式或「Exclude」模式,但不能同時設定。
    3. 如要找出資料夾 ID 或共用雲端硬碟 ID,請在 Google 雲端硬碟中開啟資料夾或共用雲端硬碟,然後複製網址中的 ID。網址格式如下:https://drive.google.com/drive/folders/ID。例如:https://drive.google.com/drive/folders/123456789012345678901。

    REST API

    如要建立含有篩選器的資料儲存庫,請呼叫 setUpDataConnector 方法。

    納入清單是在 admin_filter 下設定,排除清單則是在 admin_exclusion_filter 下設定。請在 admin_filter 或 admin_exclusion_filter 下方填入清單,但不要同時在兩者下方填入清單。

       curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
           "collectionId": "COLLECTION_ID",
           "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
           "dataConnector": {
             "dataSource": "google_drive",
             "params": {
               "FILTER_TYPE": {
                 "FILTER_KEY": [
                   "FILTER_VALUE_1",
                   "FILTER_VALUE_2"
                 ]
               }
             },
             "entities": [
               {
                 "entityName": "google_drive"
               }
             ],
             "connectorModes": [
               "FEDERATED"
             ]
           }
       }'
       

    更改下列內容:

    • PROJECT_ID:專案 ID。
    • ENDPOINT_LOCATION:API 要求適用的多區域。請指定下列其中一個值:
      • us 適用於美國多區域
      • eu 代表歐盟多區域
      • global 適用於全域位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION:資料儲存庫的多區域:global 或 us。
    • COLLECTION_ID:資料儲存庫的專屬 ID。
    • COLLECTION_DISPLAY_NAME:資料儲存庫的顯示名稱。
    • FILTER_TYPE:篩選器類型,admin_filter 代表包含,admin_exclusion_filter 代表排除。請在 admin_filter 或 admin_exclusion_filter 下方填入清單,但不可同時在兩者下方填入。
    • FILTER_KEY:要篩選的雲端硬碟實體,可以是 SharedDriveIds 或 FolderIds。
    • FILTER_VALUE_1、FILTER_VALUE_2:要篩選的共用雲端硬碟 ID 或資料夾 ID。
  7. 在「Actions」(動作) 部分,從清單中選擇要為 Google 雲端硬碟連接器啟用的動作。

    如要管理動作清單,請參閱「管理動作」。

  8. 按一下「Continue」(繼續)。

  9. 在「Configuration」(設定) 部分:

    1. 從「Multi-region」(多區域) 清單中,選取資料連接器的位置。
    2. 在「Data connector name」(資料連接器名稱) 欄位中,輸入連接器的名稱。
    3. 如果您選取 us 或 eu 做為位置,請設定「Encryption settings」(加密設定):
      • 選取「Google-managed encryption key」(客戶自行管理的加密金鑰) 或「Cloud KMS key」(Cloud KMS 金鑰)。
      • 如果您選取「Cloud KMS key」(Cloud KMS 金鑰):
        • 在「Key management type」(金鑰管理類型) 清單中,選取適當的類型。
        • 在「Cloud KMS key」(Cloud KMS 金鑰) 清單中,選取金鑰。
      詳情請參閱「客戶自行管理的加密金鑰」一文。

  10. 選用:在「Tag」(標記) 欄位中,輸入資料儲存庫的穩定 ID。這個 ID 會用於不同版本的連接器,且在資料儲存庫建立後即無法變更,因此請選擇日後不需變更的值。

  11. 選用:在「Sensitive Data Protection policy」(Sensitive Data Protection 政策) 部分,附加現有的 Sensitive Data Protection 內容政策,檢查並封鎖 Gemini Enterprise 透過這個資料儲存庫擷取的機密資料。詳情請參閱「保護來源中的機密資料」。如果貴組織不需要 Sensitive Data Protection 內容政策,可以略過這個步驟。

  12. 點選「建立」。Gemini Enterprise 會隨即建立資料儲存庫,並在「Data stores」(資料儲存庫) 頁面上顯示。

如要驗證資料儲存庫的狀態,請執行下列操作:

  1. 在資料儲存庫清單中,前往連接器並監控其狀態,直到狀態變更為「Active」(運作中) 為止。
  2. 資料儲存庫狀態從「Creating」(建立中) 變更為「Active」(運作中) 時,即可使用 Google 雲端硬碟連接器。

建立資料儲存庫之後,請建立應用程式並連結至 Google 雲端硬碟資料儲存庫,再執行查詢。

查詢執行

授權 Google 雲端硬碟之後,輸入搜尋查詢時會發生下列情況:

  1. Gemini Enterprise 會將搜尋查詢傳送至 Google Drive API。

  2. Gemini Enterprise 會結合並顯示各個來源的結果。

錯誤訊息和疑難排解

下表是使用這個 Google 資料來源時可能看見的錯誤訊息,包括 HTTP 錯誤代碼和建議的疑難排解步驟。

錯誤代碼 錯誤訊息 說明 疑難排解
403 權限遭拒 Google Workspace 資料儲存庫不支援使用服務帳戶憑證進行搜尋。 系統正在搜尋的引擎有 Google Workspace 資料儲存庫,且傳遞的憑證屬於服務帳戶。不支援使用服務帳戶憑證在 Google Workspace 資料儲存庫中搜尋。 透過使用者憑證呼叫搜尋,或從引擎中移除 Google Workspace 資料儲存庫。
403 權限遭拒 Google Workspace 資料儲存庫不支援個人帳戶。 系統透過個人帳戶 (@gmail.com) 憑證呼叫搜尋功能,但 Google Workspace 資料儲存庫不支援這類憑證。 從引擎移除 Google Workspace 資料儲存庫,或使用代管 Google 帳戶。
403 權限遭拒 資料儲存庫的客戶 ID 不相符 只有 Google Workspace 客戶 ID 與 Google Workspace 資料儲存庫和 Google Cloud 專案的組織相符的使用者,才能進行搜尋,除非使用者的 Google Workspace 客戶 ID 已列入專案許可清單。 如果是不小心造成不一致,請在 Google Cloud 專案中重新建立資料儲存庫,該專案必須與 Google Workspace 使用者屬於相同組織,或從應用程式中移除 Google Workspace 資料儲存庫。如果使用者和 Google Workspace 資料儲存庫應位於不同組織,請與 Cloud Customer Care 聯絡,將每位使用者的 Google Workspace 客戶 ID 新增至 Google Cloud 專案的許可清單,並確保每位使用者組織中的 Google Workspace 管理員啟用 Gemini Enterprise 存取 Google Workspace 資料的權限。此外,如果使用者需要尋找機構 外部擁有的文件,請在「管理 網頁應用程式功能」中啟用「包含跨網域文件」。
403 權限遭拒 組織管理員已禁止 Agentspace 存取 Workspace。 使用者 Google Workspace 組織的管理員已禁止 Gemini Enterprise 存取 Google Workspace 資料。在 Gemini Enterprise 網頁應用程式中,系統可能不會直接顯示這項錯誤,而是傳回沒有相符 Google 雲端硬碟檔案的查詢結果。 請與使用者 Google Workspace 組織的管理員聯絡,啟用存取權。在跨組織設定中,如果 Google Workspace 組織的使用者會查詢 Google 雲端硬碟,則必須在每個組織的 Google 管理控制台中啟用這項設定。
400 引數無效 要求含有無效引數。 如果要求中的資料連接器名稱不符合命名規定,就會發生這項錯誤。請確認資料連接器名稱,長度須介於 1 到 63 個字元之間,開頭須為小寫英文字母,結尾須為小寫英文字母或數字,且只能包含小寫英文字母、數字、連字號或底線。例如,使用 cymbal-collection-123456789 這類名稱,而非 123456789-cymbal-collection。

如要瞭解查詢 Google 雲端硬碟資料時可能遇到的常見搜尋問題,請參閱「常見搜尋問題」。

後續步驟