本頁說明如何建立資料儲存庫,並將 Box 連結至 Gemini Enterprise。
事前準備
設定 Box 連線前,請務必完成下列步驟:
- 授予 Discovery Engine 編輯者角色 (roles/discoveryengine.editor)。使用者必須具備這個角色,才能建立資料儲存庫。如要授予這個角色,請按照下列步驟操作:
- 建立並授權 Box 應用程式帳戶。
- 設定 Box 並授予必要權限。如需搜尋和資料擷取作業所需的範圍清單,請參閱「必要權限」。
- 取得驗證資訊,以便在建立資料儲存庫時使用。
- 使用可管理機構層級設定的管理員帳戶,來設定 Google Cloud 專案,確保機構能設定工作團隊集區。
- 請確認貴組織已完成設定,可管理工作團隊集區。
建立 Box 資料儲存庫
如要建立 Box 資料儲存庫,請按照下列步驟操作:
前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
選取或建立 Google Cloud 專案。
點按導覽選單中的「Data Stores」(資料儲存庫)。
點按「 Create data store」(建立資料儲存庫)。
在「來源」部分中搜尋「Box」,然後按一下「選取」。
在「Data」(資料) 部分:
- 在「Connector mode」(連接器模式) 部分,選取「Federated search」(聯合搜尋) 或「Data ingestion」(資料擷取) 做為連線模式。
點按「Continue」(繼續)。
在「Authentication settings」(驗證設定) 部分,根據所選的連線模式,設定驗證。
如果選取「聯合搜尋」,請輸入下列詳細資料:
- 用戶端 ID:Box 應用程式的專屬 ID。
- 用戶端密鑰:與 Box 應用程式相關聯的密鑰。
如果您選取「Data ingestion」(資料擷取),請輸入下列詳細資料:
- 企業 ID:Box 企業的專屬 ID。
- 用戶端 ID:Box 應用程式的公開 ID。
- 用戶端密鑰:與 Box 應用程式相關聯的密鑰。
- 執行個體 URI:Box 執行個體 API 的基本網址。
- 私密金鑰:用於驗證 Box 應用程式的私密金鑰。
- 金鑰 ID:私密金鑰的 ID。
- 通關密語:用於解密私密金鑰的通關密語。
如需搜尋和資料擷取作業所需的範圍清單,請參閱「必要範圍」。如要瞭解如何取得驗證資訊,請參閱「取得 Box 驗證資訊」。
如果選取「Federated Search」,請按一下「登入」並完成登入程序。
按一下「繼續」。
在「Advanced Options」(進階選項) 部分:
- 如果您選取「聯合搜尋」,請選取「模擬使用者模式」做為
Admin或User,然後按一下「繼續」。 - 選用。如果您選取「資料擷取」,請勾選「啟用靜態 IP 位址」核取方塊,在系統中允許一組靜態 IP 位址。
- 如果您選取「聯合搜尋」,請選取「模擬使用者模式」做為
按一下「繼續」。
在「Entities to search」(要搜尋的實體) (如果您已選取「Federated Search」(聯合搜尋)),或是「Entities to sync」(要同步的實體) (如果您已選取「Data ingestion」(資料擷取) ) 部分:
- 選取所有必要實體。
- 如果您選取「Data ingestion」(資料擷取),請繼續執行下列步驟:
- 選用:如要同步處理特定專案,請按照下列步驟操作:
- 按一下「Filter」(篩選)。
- 如要從索引中篩除實體,請選取「Exclude from the index」(從索引中排除) 核取方塊,如要確保實體包含在索引中,請選取「Include to the index」(包含在索引中) 核取方塊。
- 輸入金鑰。每輸入一個金鑰,就按下 Enter 鍵。
- 按一下「Save」(儲存)。
- 如要設定同步時間表,請按照下列步驟操作:
- 在「Sync frequency」(同步處理頻率) 清單中,選取同步頻率。
- 如要分別排定實體和身分資料的完整同步作業,請展開「Full sync」(完整同步) 部分的選單,然後選取「Custom options」(自訂選項)。
- 在「Incremental sync frequency」(增量同步頻率) 清單中,選取增量同步頻率。詳情請參閱同步時間表的相關說明。
- 在「Sync frequency」(同步處理頻率) 清單中,選取同步頻率。
- 選用:如要同步處理特定專案,請按照下列步驟操作:
按一下「繼續」。
在「Configuration」(設定) 部分:
- 從「Multi-region」(多區域) 清單中,選取資料連接器的位置。
- 在「Data connector name」(資料連接器名稱) 欄位中,輸入連接器的名稱。
- 如果您選取
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 金鑰) 清單中,選取金鑰。
點按「Continue」(繼續)。
在「Billing」(帳單) 部分,選取「General pricing」(一般計價模式) 或「Configurable pricing」(可設定的計價模式)。詳情請參閱「確認專案的帳單狀態」和「授權」。
點按「Create」(建立)。Gemini Enterprise 會隨即建立資料儲存庫,並在「Data stores」(資料儲存庫) 頁面上顯示。
如要驗證資料儲存庫的狀態,請執行下列操作:
- 在資料儲存庫清單中前往資料儲存庫,並監控其狀態,直到狀態變更為「Active」(有效) 為止。
- 資料儲存庫狀態從「建立中」變更為「運作中」時,即可使用 Box 連接器。
如果是使用 Box 建立的擷取資料儲存庫,資料儲存庫狀態會在啟動同步處理時,從「建立中」轉換為「執行中」。擷取完成後,狀態會變更為「Active」(運作中),表示已完成設定資料儲存庫。視資料量而定,擷取作業可能需要數小時。
如果您已建立 Box 聯合資料儲存庫,請務必先授權 Gemini Enterprise 存取 Box,再執行查詢。
資料處理和查詢執行
本節說明 Gemini Enterprise 如何管理查詢,以及使用聯合資料儲存庫對隱私權造成的影響。
查詢執行
授權 Box 並將搜尋查詢傳送至 Gemini Enterprise 後:
- Gemini Enterprise 會將搜尋查詢直接傳送至 Box API。
- Gemini Enterprise 會結合各個連結資料來源的結果,並顯示詳盡的搜尋結果。
資料處理
使用第三方聯合搜尋功能時,適用下列資料處理規則:
- 查詢字串會傳送至第三方搜尋後端 (Box API)。
- 這些第三方可能會將查詢與您的身分建立關聯。
- 如果啟用多個聯合搜尋資料來源,查詢可能會傳送至所有來源。
- 一旦第三方系統收到資料,這些資料就受到該系統的《服務條款》和《隱私權政策》規範。
後續步驟
- 如要提供查詢資料的使用者介面,請建立應用程式,然後將應用程式連結至 Box 聯邦資料儲存庫。
- 如要在設定應用程式後,預覽搜尋結果的顯示方式,請參閱「取得搜尋結果」。
- 如要為資料儲存庫啟用警告,請參閱「為第三方資料儲存庫設定警告」。