本頁說明如何建立資料儲存庫,並將 Epic EHR 連結至 Gemini Enterprise。
事前準備
設定 Epic EHR 連線前,請先完成下列工作:
授予 Discovery Engine 編輯者角色 (
roles/discoveryengine.editor)。使用者必須具備這個角色,才能建立資料儲存庫。請按照下列步驟操作來授予這個角色:請 Epic 分析師為 Gemini Enterprise 註冊及設定 Epic 應用程式。詳情請參閱「Epic EHR 設定」。
取得要連結的 Epic 環境下列值:
- FHIR R4 基準網址
- 授權網址
- 權杖網址
- Epic 應用程式的用戶端 ID 和用戶端密鑰
詳情請參閱「尋找 Epic 端點」。
建立 Epic EHR 資料儲存庫
如要建立 Epic EHR 資料儲存庫,請按照下列步驟操作:
前往 Google Cloud 控制台的「Gemini Enterprise」頁面。
選取或建立 Google Cloud 專案。
點按導覽選單中的「Data Stores」(資料儲存庫)。
點按「 Create data store」(建立資料儲存庫)。
在「Source」(來源) 部分中,搜尋「Epic EHR」,然後按一下「Select」(選取)。
在「Data」(資料) 部分:
在「Authentication settings」(驗證設定) 部分,輸入下列詳細資料。輸入每個網址時,請加上
https://,且結尾不要加上斜線。- Epic FHIR R4 Audience URI (instance_uri):FHIR R4 基準網址,例如
https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4。 - Epic OAuth 2.0 Authorize URL:您的授權網址。
- Epic OAuth 2.0 Token URL:您的權杖網址。
- Epic Connection Hub 用戶端 ID:Epic 應用程式的用戶端 ID。
- Epic Connection Hub Client Secret:Epic 應用程式的用戶端密鑰。
- Epic FHIR R4 Audience URI (instance_uri):FHIR R4 基準網址,例如
點選「驗證身分」,然後完成 Epic 登入程序。
按一下「繼續」。
在「Destinations」(目的地) 部分,找到「Epic FHIR R4 Base Endpoint URL (host_url)」下方的「Host」(主機) 欄位,輸入 FHIR R4 基準網址,並加上
https://,但不要加上結尾斜線。使用與 Epic FHIR R4 Audience URI (instance_uri) 相同的值。按一下「繼續」。
如果建立資料儲存庫流程顯示「Advanced options」(進階選項) 部分,您可以勾選其中的「Enable Static IP Addresses」(啟用靜態 IP 位址) 核取方塊。這能確保資料儲存庫使用一組固定的 IP 位址傳出流量,適合在來源系統中加入許可清單。詳情請參閱「設定靜態 IP 輸出」。
按一下「繼續」。
在「Entities to search」(要搜尋的實體) 部分,選取所有實體。
按一下「繼續」。
在「動作」部分,保持選取所有動作。所有 Epic EHR 動作皆為唯讀。
按一下「繼續」。
在「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」(運作中) 後,即可使用 Epic EHR 資料儲存庫。
建立資料儲存庫後,請將剛建立的資料儲存庫連結至現有應用程式,或建立新的應用程式並連結至新的應用程式,然後授權 Gemini Enterprise 存取 Epic EHR,再執行任何查詢。每位使用者在貴組織的 Epic 登入頁面上,使用自己的 Epic 帳戶授權連接器。
資料處理和查詢執行
本節說明 Gemini Enterprise 如何管理查詢,以及使用聯合資料儲存庫對隱私權造成的影響。
查詢執行
授權 Epic EHR 後,將搜尋查詢傳送至 Gemini Enterprise 時,會發生下列情況:
- Gemini Enterprise 會將搜尋查詢直接傳送至 Epic FHIR API。
- Gemini Enterprise 會結合各個連結資料來源的結果,並顯示詳盡的搜尋結果。
資料處理
使用第三方聯合搜尋功能時,適用下列資料處理規則:
- 查詢字串會傳送至第三方搜尋後端 (Epic FHIR API)。
- 這些第三方可能會將查詢與您的身分建立關聯。
- 如果啟用多個聯合搜尋資料來源,查詢可能會傳送至所有來源。
- 第三方系統收到資料後,這些資料就受到該系統的《服務條款》和《隱私權政策》規範。
後續步驟
- 如要提供使用者介面來查詢 Epic EHR 資料,請建立應用程式並連結至 Epic EHR 資料儲存庫。
- 如要在設定應用程式後預覽搜尋結果的顯示情形,請參閱「取得搜尋結果」一文。
- 如要為資料儲存庫啟用警告,請參閱「為第三方資料儲存庫設定警告」。