本頁說明如何建立資料儲存庫,並將 Salesforce 連結至 Gemini Enterprise。資料儲存庫會即時搜尋 Salesforce 記錄,讓使用者能以自然語言執行操作。
事前準備
設定 Salesforce 連線前,請先完成下列工作:
授予 Discovery Engine 編輯者角色 (
roles/discoveryengine.editor)。使用者必須具備這個角色,才能建立資料儲存庫。請按照下列步驟操作來授予這個角色:請 Salesforce 管理員在您要連結的 Salesforce 機構中,啟用 SObject All MCP 伺服器,並設定您選擇的驗證方式:
- OAuth 2.0 (Google 代管) (預設):從 Salesforce AppExchange 安裝 Gemini Enterprise - Salesforce Connector 受管理套件至該組織。您不需要用戶端 ID 或用戶端密鑰。
- OAuth 2.0 (自備應用程式):在該組織中建立外部用戶端應用程式,並取得其用戶端金鑰 (用戶端 ID) 和用戶端密鑰 (用戶端密鑰)。
在設定 OAuth 應用程式之前,使用者無法授權連接器;在 SObject All MCP 伺服器啟用之前,無法執行任何動作。請參閱「Salesforce 設定」。
記下貴機構的「我的網域」網址,例如
https://example.my.salesforce.com。請在「Instance URI」(執行個體 URI) 中輸入這個值。如果是沙箱組織,請使用沙箱「我的網域」,例如https://example--sandbox.sandbox.my.salesforce.com。
找出「我的網域」網址
如要找出要輸入為執行個體 URI 的「我的網域」網址,請按照下列步驟操作:
- 在 Salesforce 中前往「Setup」。
- 在「Quick Find」(快速尋找) 方塊中,搜尋並選取「My Domain」(我的網域)。
- 在「Current My Domain URL」(目前的我的網域網址) 下方,複製網址,例如
https://example.my.salesforce.com。
如果是沙箱組織,請在沙箱中執行這項操作。其「我的網域」網址看起來像 https://example--sandbox.sandbox.my.salesforce.com。
建立 Salesforce 資料儲存庫
如要建立 Salesforce 資料儲存庫,請按照下列步驟操作:
前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
選取或建立 Google Cloud 專案。
點按導覽選單中的「Data Stores」(資料儲存庫)。
點按「 Create data store」(建立資料儲存庫)。
在「Source」(來源) 部分中,搜尋「Salesforce」,然後按一下「Select」(選取)。
在「Data」(資料) 部分:
在「Authentication settings」(驗證設定) 的「Select your authentication method」(選取驗證方式) 部分,選擇下列其中一個選項:
- OAuth 2.0 (Google 代管) (預設):
- 在「Instance URI」(執行個體 URI) 中,輸入 Salesforce 網站的「我的網域」網址,例如
https://example.my.salesforce.com。如果是沙箱機構,請輸入沙箱「我的網域」,例如https://example--sandbox.sandbox.my.salesforce.com。
- 在「Instance URI」(執行個體 URI) 中,輸入 Salesforce 網站的「我的網域」網址,例如
- OAuth 2.0 (自備應用程式):
- 在「Instance URI」(執行個體 URI) 中,輸入 Salesforce 網站的「我的網域」網址,例如
https://example.my.salesforce.com。如果是沙箱機構,請輸入沙箱「我的網域」,例如https://example--sandbox.sandbox.my.salesforce.com。 - 在「Client ID」(用戶端 ID) 部分,輸入 Salesforce 外部用戶端應用程式的用戶端金鑰。
- 在「Client Secret」(用戶端密鑰) 部分,輸入 Salesforce 外部用戶端應用程式的消費者密鑰。
- 點選「Verify Auth」,然後完成 Salesforce 登入程序,驗證 OAuth 憑證。
- 在「Instance URI」(執行個體 URI) 中,輸入 Salesforce 網站的「我的網域」網址,例如
- OAuth 2.0 (Google 代管) (預設):
在「Advanced options」(進階選項) 下方,如要連結 Sandbox 組織,請選取「Use Sandbox」(使用 Sandbox)。Salesforce 隨後會從沙箱組織提供動作。
按一下「繼續」。
在「Entities to search」(要搜尋的實體) 部分,選取要讓 Gemini Enterprise 搜尋的實體。如果是 Salesforce,請選取「Salesforce MCP」。
按一下「繼續」。
選用:在「Actions」(動作) 部分,選取要為使用者啟用的建立、更新和刪除動作,或不選取任何動作,讓連接器保持唯讀狀態 (預設會啟用唯讀動作)。您也可以在建立資料儲存庫後啟用或停用這些動作,詳情請參閱「啟用動作」。
按一下「繼續」。
在「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」(可設定的計價模式)。詳情請參閱「確認專案的帳單狀態」一文和「授權」一文。
點選「建立」。Gemini Enterprise 會隨即建立資料儲存庫,並在「Data stores」(資料儲存庫) 頁面上顯示。
在「Data stores」(資料儲存庫) 頁面,點選資料儲存庫名稱即可查看狀態。資料儲存庫狀態從「Creating」(建立中) 變更為「Active」(運作中) 後,即可使用 Salesforce 資料儲存庫。
建立資料儲存庫後,請將剛建立的資料儲存庫連結至現有應用程式,或建立新的應用程式並連結至新的應用程式,然後授權 Gemini Enterprise 存取 Salesforce,再執行任何查詢。
啟用動作
建立 Salesforce 資料儲存庫時,系統會預先填入資料儲存庫中的動作。唯讀動作 (Soql Query、Find、Get Object Schema、Get Related Records、List Recent Sobject Records 和 Get User Info) 預設為啟用,且一律可用。建立、更新或刪除記錄的操作 (「Create Sobject Record」、「Update Sobject Record」、「Update Related Record」、「Delete Sobject Record」和「Delete Related Record」) 預設為關閉。
如果在建立資料儲存庫時,未啟用建立、更新或刪除動作,可以隨時按照下列步驟啟用:
在 Google Cloud 控制台中,前往 Salesforce 資料儲存庫。
選取「動作」分頁標籤。
選取要啟用的動作 (「Create Sobject Record」、「Update Sobject Record」、「Update Related Record」、「Delete Sobject Record」或「Delete Related Record」)。如要讓連接器維持唯讀狀態,請勿選取這些動作。
按一下「啟用動作」。
如需動作清單,請參閱「支援的動作」。
資料處理和查詢執行
本節說明 Gemini Enterprise 如何管理查詢,以及使用聯合資料儲存庫對隱私權造成的影響。
查詢執行
授權 Salesforce 後,將搜尋查詢傳送至 Gemini Enterprise 時,會發生下列情況:
- Gemini Enterprise 會將搜尋查詢直接傳送至 Salesforce MCP 伺服器。
- Gemini Enterprise 會結合各個連結資料來源的結果,並顯示詳盡的搜尋結果。
資料處理
使用第三方聯合搜尋功能時,適用下列資料處理規則:
- 查詢字串會傳送至第三方搜尋後端 (Salesforce MCP 伺服器)。
- 這些第三方可能會將查詢與您的身分建立關聯。
- 如果啟用多個聯合搜尋資料來源,查詢可能會傳送至所有來源。
- 第三方系統收到資料後,這些資料就受到該系統的《服務條款》和《隱私權政策》規範。
後續步驟
- 如要提供使用者介面來查詢 Salesforce 資料,請建立應用程式並連結至 Salesforce 資料儲存庫。
- 如要在設定應用程式後預覽搜尋結果的顯示情形,請參閱「取得搜尋結果」一文。
- 如要為資料儲存庫啟用警告,請參閱「為第三方資料儲存庫設定警告」。