設定 Google Chat 資料儲存庫

本頁說明如何建立資料儲存庫，並將 Google Chat 連結至 Gemini Enterprise。

事前準備

  • 使用與要連結的 Google Workspace 執行個體相關聯的帳戶，登入 Google Cloud 控制台。Gemini Enterprise 會使用 Google Workspace 客戶 ID 連線至 Google Chat。

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

建立 Google Chat 資料儲存庫

如要建立 Google Chat 資料儲存庫，請執行下列步驟：

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

    Gemini Enterprise

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

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

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

  5. 在「Source」(來源) 中搜尋「Google Chat」，然後按一下「Select」(選取)。

  6. 在「資料」部分中，設定篩選器來管理已建立索引的即時通訊資料量、相關性和隱私權。 您可以使用 Google Cloud 控制台或 API，將篩選器新增至資料儲存庫：

    控制台

    1. 在「訊息回溯期篩選器」欄位中，輸入要為搜尋結果建立索引的對話記錄天數。舉例來說，輸入 90 可確保系統只搜尋過去 90 天內的訊息，並篩除較舊和較不相關的資料。
    2. 選取「排除即時訊息」核取方塊，即可從搜尋結果中排除所有私人 1:1 即時訊息。啟用後，Google Chat 連接器只會為多使用者聊天室和群組對話建立索引。

    REST

    如要在建立資料儲存庫時新增篩選器，請呼叫 setUpDataConnector 方法。

    

    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_chat",
          "params":{
            "admin_filter":{
              "MessageRecency":RECENCY_DAYS,
              "ExcludeDirectMessages":EXCLUDE_DMS
              }
            },
          "entities":[
            {
              "entityName":"google_chat"
            }],
            "connectorModes":[
              "FEDERATED"
              ]
        }
      }'

    更改下列內容：

    • PROJECT_ID：專案的 ID。
    • ENDPOINT_LOCATION：API 要求適用的多區域。請指定下列其中一個值：
      • us 適用於美國多區域
      • eu 代表歐盟多區域
      • global 適用於全域位置
      詳情請參閱「為資料儲存庫指定多區域」。
    • LOCATION：資料儲存庫的多區域：global、us 或 eu
    • COLLECTION_ID：資料儲存庫的專屬 ID。
    • COLLECTION_DISPLAY_NAME：資料儲存庫的顯示名稱。
    • EXCLUDE_DMS：布林值 (true 或 false)。
    • RECENCY_DAYS：代表訊息年齡限制的整數。例如：90。

    如要進一步瞭解篩選器類型和新增篩選器，請參閱「將篩選器新增至 Google Chat 資料儲存庫」。

  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」(資料儲存庫) 頁面上顯示。

在「Data stores」(資料儲存庫) 頁面，點選資料儲存庫名稱即可查看狀態。資料儲存庫狀態從「Creating」(建立中) 變更為「Active」(運作中) 後，即可使用 Google Chat 連接器。

建立資料儲存庫後，請將剛建立的資料儲存庫連結至現有應用程式，或建立新應用程式並連結至新應用程式，然後授權 Gemini Enterprise 存取 Google Chat，再執行任何查詢。

查詢執行

本節說明 Gemini Enterprise 如何管理查詢，以及使用聯合資料儲存庫對隱私權造成的影響。

授權 Google Chat 後，將搜尋查詢傳送至 Gemini Enterprise 時，會發生下列情況：

  • Gemini Enterprise 會將搜尋查詢直接傳送至 Google Chat API。
  • Gemini Enterprise 會結合各個連結資料來源的結果，並顯示詳盡的搜尋結果。

錯誤訊息和疑難排解

下表說明使用 Google Chat 連接器時可能會出現的常見錯誤訊息，並提供可能的 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 管理員聯絡，啟用存取權。

後續步驟