本頁說明如何建立資料儲存庫,並將 Salesforce 連結至 Gemini Enterprise。
事前準備
設定連線前,請先完成下列工作:
授予 Discovery Engine 編輯者角色 (
roles/discoveryengine.editor)。使用者必須具備這個角色,才能建立資料儲存庫。請按照下列步驟操作來授予這個角色:設定 Salesforce 帳戶並取得驗證憑證。
建立 Salesforce 聯邦資料儲存庫
如要建立 Salesforce 資料儲存庫,請執行下列步驟:
前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
選取或建立 Google Cloud 專案。
點按導覽選單中的「Data Stores」(資料儲存庫)。
點按「 Create data store」(建立資料儲存庫)。
在「來源」部分中,搜尋「Salesforce」,然後按一下「選取」。
在「Data」(資料) 部分:
在「Authentication settings」(驗證設定) 部分,根據所選的連線模式,設定驗證。如要進一步瞭解如何取得驗證憑證,請參閱「Salesforce 設定」。
- 執行個體網址:Salesforce 執行個體的基準網址。
- 用戶端 ID:應用程式的 OAuth 用戶端 ID。
- 用戶端密鑰:應用程式的 OAuth 用戶端密鑰。
- 按一下「Login」(登入),然後完成 Salesforce 登入程序。
按一下「繼續」。
在「Advanced options」(進階選項) 部分,如要使用 Salesforce Sandbox 執行個體,請選取「Use Sandbox」(使用 Sandbox) 核取方塊。
按一下「繼續」。
在「Entities to search」(要搜尋的實體) 部分,選取至少一個實體。
按一下「繼續」。
如果選取「Federated search」(聯合搜尋),請前往「Actions」(動作),然後從「Select Salesforce actions to enable」(選取要啟用的 Salesforce 動作) 清單中,選取要為資料儲存庫啟用的動作。
如要查看及管理動作清單,請參閱查看及管理動作的相關說明。
- 點選「Continue」(繼續)。
在「Configuration」(設定) 部分:
- 從「Multi-region」(多區域) 清單中,選取資料連接器的位置。
- 在「Your 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」(可設定的計價模式)。詳情請參閱「確認專案的帳單狀態」一文和「授權」一文。
點選「Continue」(繼續)。
點選「Create」(建立)。Gemini Enterprise 會隨即建立資料儲存庫,並在「Data stores」(資料儲存庫) 頁面上顯示。
在「Data stores」(資料儲存庫) 頁面,點選資料儲存庫名稱即可查看狀態。資料儲存庫狀態從「Creating」(建立中) 變更為「Active」(運作中) 後,即可使用 Salesforce 連接器。
建立資料儲存庫後,請建立應用程式、將應用程式連結至 Salesforce 資料儲存庫,然後授權應用程式存取 Salesforce,再執行任何查詢。
詳情請參閱「後續步驟」。
建立 Salesforce 資料擷取資料儲存庫
如要建立資料擷取資料儲存庫,請按照下列步驟操作。否則請略過這個部分。
如要透過控制台將 Salesforce 資料同步至 Gemini Enterprise,請按照下列步驟操作:
- 前往控制台的「Gemini Enterprise」頁面。
- 點按導覽選單中的「Data Stores」(資料儲存庫)。
- 點按「 Create Data Store」(建立資料儲存庫)。
- 在「Select a data source」(選取資料來源) 頁面,捲動或搜尋「Salesforce V2」,然後連至第三方來源。
- 在「Authentications」(驗證) 部分,選取驗證方式並輸入驗證資訊。如要進一步瞭解如何取得驗證憑證,請參閱「設定 Salesforce 資料擷取資料儲存庫」。
- 在「目的地」部分,選取「公開」或「私人」。
- 如果目的地類型為公開,您不必設定服務連結。請在「Login URL」(登入網址) 欄位中,輸入 Salesforce 伺服器的登入網址。
- 如果目的地類型為私人,請輸入所有必要資訊:
- 「Service attachment」(服務連結):輸入服務連結。
- 「Base domain name」(基礎網域名稱):輸入基礎網域。
- 「Login URL」(登入網址):輸入 Salesforce 伺服器的登入網址。
- 按一下「繼續」。
- 在「Entities to sync」(要同步處理的實體) 部分,完成下列操作:
- 選取要同步處理的實體。
- 選用:「URL field name」(網址欄位名稱):輸入資料欄名稱,即可將預設實體網址改為 Salesforce 資料表中的自訂網址。
- 選用:如要新增自訂實體,請點按「Add entities manually」(手動新增實體)。自訂實體名稱必須採用以下格式:<var>custom_object_name</var>__c。
- 選取「Sync frequency」(完整同步) 的「Full sync」(同步頻率),以及「Increamental sync」(資料增量同步) 的「Incremental sync frequency」(增量同步頻率)。 詳情請參閱同步時間表。
- 選取要同步處理的實體。
- 按一下「繼續」。
- 在「設定資料連接器」部分,完成下列步驟:
- 選取資料儲存庫的區域。
- 輸入資料儲存庫的名稱。
- 點按「Create」(建立)。Gemini Enterprise 會隨即建立資料儲存庫,並在「Data stores」(資料儲存庫) 頁面上顯示。
- 如要檢查擷取狀態,請前往「Data Stores」(資料儲存庫) 頁面,然後點按資料儲存庫名稱。連接器開始同步處理資料時,「Connector state」(連接器狀態) 會從「Creating」(建立中) 轉為「Running」(執行中)。
詳情請參閱「後續步驟」。
後續步驟
- 如要提供使用者介面來查詢 Salesforce 資料,請建立應用程式並連結至 Salesforce 資料儲存庫。
- 如要查看及管理動作清單,請參閱查看及管理動作的相關說明。
- 如要在設定應用程式後,預覽搜尋結果的顯示方式,請參閱「取得搜尋結果」。
- 如要為資料儲存庫啟用警告,請參閱「為第三方資料儲存庫設定警告」。