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

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

事前準備

  • 您登入 Google Cloud 控制台的帳戶，必須是待連結 Google 雲端硬碟執行個體所用的帳戶。Gemini Enterprise 會使用 Google Workspace 客戶 ID 連線至 Google 雲端硬碟。

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

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

  • 啟用其他 Google 產品的 Google Workspace 智慧功能，將 Google 雲端硬碟資料連結至 Gemini Enterprise。如需相關說明，請參閱「開啟或關閉 Google Workspace 智慧功能」。

建立 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. 在「資料」部分，指定資料儲存庫的雲端硬碟來源。您可以使用 Google Cloud 控制台或 API 設定篩選器，指定要建立索引的 Google 雲端硬碟內容：

    控制台

    1. 選取資料儲存庫的雲端硬碟來源：
      • 「All」(全部)：將工作區中的所有雲端硬碟新增至資料儲存庫。
      • 資料夾篩選器：將搜尋範圍侷限在特定一組資料夾。選擇「包含」，將搜尋範圍限定為所列資料夾；選擇「排除」，則可從搜尋範圍中移除所列資料夾。然後新增一或多個資料夾 ID。
      • 共用雲端硬碟篩選器：將搜尋範圍限縮為特定共用雲端硬碟。選擇「包含」，將搜尋範圍限定為僅列出的共用雲端硬碟；選擇「排除」，則可從搜尋範圍中移除列出的共用雲端硬碟。然後新增一或多個共用雲端硬碟 ID。
    2. 針對每種篩選器類型，設定「包含」模式或「排除」模式，但不能同時設定兩種模式。
    3. 前往 Google 雲端硬碟中的資料夾或共用雲端硬碟，然後複製網址中的 ID，即可取得資料夾 ID 或共用雲端硬碟 ID。網址格式如下：https://drive.google.com/corp/drive/folders/ID。例如：https://drive.google.com/corp/drive/folders/123456789012345678901。

    REST

    如要建立含有篩選器的資料儲存庫，請呼叫 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":{
             "admin_filter":{
               "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": INCLUDED_FOLDER_IDS
             },
             "admin_exclusion_filter":{
               "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": EXCLUDED_FOLDER_IDS
             }
           },
           "entities":[
             {
               "entityName":"drive"
             }],
           "connectorModes":[
             "FEDERATED"
             ]
         }
       }'

    更改下列內容：

    • PROJECT_ID：專案 ID。
    • ENDPOINT_LOCATION：應用程式的區域。例如：us 或 eu。
    • LOCATION：資料儲存庫的多區域：global 或 us。
    • COLLECTION_ID：資料儲存庫的專屬 ID。
    • COLLECTION_DISPLAY_NAME：資料儲存庫的顯示名稱。
    • INCLUDED_SHARED_DRIVE_IDS：要納入搜尋範圍的共用雲端硬碟 ID 清單，例如 ["0ABCdEfGhIjKlMnOpQ"]。如果未設定共用雲端硬碟的納入清單，請使用空白清單 []。
    • INCLUDED_FOLDER_IDS：要納入搜尋範圍的資料夾 ID 清單，例如 ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]。如果不想為資料夾設定納入清單，請使用空白清單 []。
    • EXCLUDED_SHARED_DRIVE_IDS：要從搜尋中排除的共用雲端硬碟 ID 清單。如未設定共用雲端硬碟的排除清單，請使用空白清單 []。
    • EXCLUDED_FOLDER_IDS：要從搜尋中排除的資料夾 ID 清單。如未設定資料夾的排除清單，請使用空白清單 []。

    如要進一步瞭解篩選器類型及如何新增篩選器，請參閱「為 Google 雲端硬碟資料儲存庫新增篩選器」。

  7. 按一下「繼續」。

  8. 在「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 金鑰) 清單中，選取金鑰。
      詳情請參閱「客戶自行管理的加密金鑰」一文。

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

  10. 在「Billing」(帳單) 部分，選取「General pricing」(一般計價模式) 或「Configurable pricing」(可設定的計價模式)。詳情請參閱「確認專案的帳單狀態」一文和「授權」一文。

  11. 按一下「Create」(建立)。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 資料儲存庫屬於同一組織的使用者，才能進行搜尋。 從引擎中移除 Google Workspace 資料儲存庫，或是與支援團隊聯絡 (如果使用者和 Google Workspace 資料儲存庫需位於不同組織)。
403 權限遭拒 組織管理員已禁止 Agentspace 存取 Workspace。 Google Workspace 管理員已禁止 Gemini Enterprise 存取 Google Workspace 資料。 請與 Google Workspace 管理員聯絡，啟用存取權。
400 引數無效 要求含有無效引數。 如果要求中的資料連接器名稱不符合命名規定，就會發生這個錯誤。確認資料連接器名稱，確保長度介於 1 至 63 個字元之間，開頭為小寫字母，結尾為小寫字母或數字，且只包含小寫字母、數字、連字號或底線。例如，使用 cymbal-collection-123456789 這類名稱，而非 123456789-cymbal-collection。

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

後續步驟