設定 Zendesk 資料儲存庫

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

事前準備

設定 Zendesk 資料儲存庫前，請確認下列事項：

  1. 授予 Discovery Engine 編輯者角色 (roles/discoveryengine.editor)。使用者必須具備這個角色，才能建立資料儲存庫。請按照下列步驟操作來授予這個角色：

    1. 前往 Google Cloud 控制台的「IAM」(身分與存取權管理) 頁面。

      前往「IAM」頁面

    2. 找出使用者帳戶，然後按一下「Edit」(編輯) 圖示。
    3. 將 Discovery Engine Editor 角色授予使用者。詳情請參閱「IAM 角色和權限」。

  2. 建立 OAuth 用戶端，並取得下列憑證：

    • 用戶端 ID

    • 用戶端密鑰

  3. 在 Zendesk 中為 OAuth 應用程式設定必要權限。

  4. 確認 Zendesk API 設定中已啟用權杖存取權。

建立 Zendesk 資料儲存庫

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

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

    Gemini Enterprise

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

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

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

  5. 在「來源」中搜尋「Zendesk」，然後按一下「選取」。

  6. 在「Data」(資料) 部分：

    1. 在「Authentication settings」(驗證設定) 部分，提供下列詳細資料： * 執行個體 URI：輸入 Zendesk 執行個體 URI (例如 https://[subdomain].zendesk.com)。 * 用戶端 ID：在 Zendesk 中註冊的應用程式專屬 ID。 * 用戶端密鑰：在 Zendesk 中註冊 OAuth 2.0 應用程式時產生的密鑰。

      如要瞭解如何取得用戶端 ID 和用戶端密鑰，請參閱「取得用戶端 ID 和用戶端密鑰」一文。如要瞭解執行搜尋所需的權限，請參閱「必要權限」。

    2. 按一下「Login」(登入)，然後完成 Zendesk 登入程序。

    3. 按一下「繼續」。

    4. 在「Destinations」(目的地) 部分：

      1. Proxy 伺服器：輸入要用來轉送 HTTP 流量的 Proxy 主機名稱或 IP 位址，包括「主機」和「通訊埠」。
      2. Zendesk Support 網址：輸入執行個體網址，包括 https://，也就是您的 Zendesk Support 網址。
      3. 按一下「繼續」。

    5. 選用：在「Advanced options」(進階選項) 部分：

      1. 啟用靜態 IP 位址：註冊一組靜態 IP 位址，並將這些位址加入系統的許可清單。如未將這些 IP 位址加入許可清單，同步執行作業就會失敗。
      2. 每分鐘最多 API 要求數：每次執行連接器時，每分鐘可傳送至 Zendesk 執行個體的 API 要求數量上限。
      3. 按一下「繼續」。

    6. 在「Entities to search」(要搜尋的實體) 部分，從清單選取所有要搜尋的實體。至少須選取一個實體。

  7. 按一下「繼續」。

  8. 在「Configuration」(設定) 部分：

    1. 從「Multi-region」(多區域) 清單中，選取資料連接器的位置。
    2. 在「Data connector name」(資料連接器名稱) 欄位中，輸入連接器的名稱。
    3. 如果您選取 US 或 EU 做為位置，請設定「Encryption settings」(加密設定)：
      • 選用：如果尚未設定單一區域金鑰，請按一下「Go to settings page」(前往設定頁面)。詳情請參閱「為第三方連接器註冊單一區域金鑰」一文。
      • 選取「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」(可設定的計價模式)。詳情請參閱「確認專案的帳單狀態」一文和「授權」一文。

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

建立資料儲存庫後，請建立應用程式、將應用程式連結至 Zendesk 資料儲存庫，然後授權 Gemini Enterprise 存取 Zendesk，再執行任何查詢。

如要瞭解執行搜尋所需的權限，請參閱「必要權限」。

資料處理和查詢執行

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

查詢執行

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

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

資料處理

使用第三方聯合搜尋功能時，適用下列資料處理規則：

  • 查詢字串會傳送至第三方搜尋後端 (Zendesk API)。
  • 這些第三方可能會將查詢與您的身分建立關聯。
  • 如果啟用多個聯合搜尋資料來源，查詢可能會傳送至所有來源。
  • 一旦第三方系統收到資料，這些資料就受到該系統的《服務條款》和《隱私權政策》規範。

後續步驟