如要在 Vertex AI Search 中搜尋臨床資料,您可以按照下列任一工作流程操作:
- 建立醫療照護資料儲存庫、將 FHIR R4 資料匯入資料儲存庫、將其連結至醫療照護搜尋應用程式,然後查詢臨床資料。詳情請參閱「建立醫療保健資料儲存庫」。
- 建立醫療照護搜尋應用程式、建立醫療照護資料儲存庫,並在應用程式建立程序中將 FHIR R4 資料匯入資料儲存庫,然後查詢臨床資料。
本頁面將說明第二種方法。
關於資料匯入頻率
您可以透過下列方式,將 FHIR R4 資料匯入資料儲存庫:
批次匯入:一次性匯入。資料會以批次方式匯入資料儲存庫。如要進一步瞭解如何匯入增量資料,請參閱「重新整理醫療保健資料」。
串流匯入:近乎即時的串流資料匯入。來源 FHIR 儲存庫中的任何增量變更都會在 Vertex AI Search 資料儲存庫中同步處理。串流功能需要資料連接器,這是一種資料儲存庫類型。如要建立資料連接器,您必須設定集合。資料連接器包含實體,這也是資料儲存庫的執行個體。
您也可以暫停及繼續串流,並視需要手動同步處理。詳情請參閱「管理醫療保健搜尋資料儲存庫」。
特定 Google Cloud 專案的資料串流速率取決於下列配額。如果超出配額,可能會發生串流延遲的情形。
- 每分鐘待處理的 FHIR 或 BigQuery 串流寫入作業數量。詳情請參閱「配額與限制」。
- 每個地區每分鐘的 FHIR 讀取作業數。詳情請參閱 Cloud Healthcare API FHIR 配額。
您可以在建立資料儲存庫時選取資料匯入頻率,且日後無法變更這項設定。
事前準備
建立醫療保健搜尋應用程式前,請先瞭解下列事項:
醫療照護搜尋應用程式與資料儲存庫之間的關係。詳情請參閱「關於應用程式和資料儲存庫」。
Vertex AI Search for healthcare 僅在美國多區域 (
us
) 提供搜尋服務,因此醫療照護搜尋應用程式和資料儲存庫必須位於us
多區域。如果您要從一個 Google Cloud 專案的 Cloud Healthcare API FHIR 儲存庫匯入醫療照護資料,並將其匯入另一個 Google Cloud 專案的 Vertex AI Search 資料儲存庫,且您使用的是 VPC Service Controls,則這兩個專案必須位於相同的範圍內。
建立應用程式
您可以在 Google Cloud 控制台或使用 API 建立醫療保健搜尋應用程式。如要建立醫療保健搜尋應用程式,請按照下列步驟操作:
控制台
前往 Google Cloud 控制台的「AI Applications」頁面。
在「應用程式」頁面中,按一下 add_box「新增應用程式」。
在「Create App」頁面,點選「Healthcare search」下方的「Create」。
在「搜尋應用程式設定」窗格中,選取「醫療照護內容搜尋應用程式」。
如要為這個應用程式開啟進階 LLM 功能,請按一下「進階 LLM 功能」切換鈕。
啟用進階 LLM 功能,即可取得搜尋摘要,也就是前幾個搜尋結果的簡短摘要。
啟用 LLM 功能後,最多可能需要五分鐘才能開始使用支援的功能。
在「應用程式名稱」欄位中輸入應用程式名稱。
在「貴公司或貴機構的外部名稱」欄位中,輸入貴公司或貴機構的常用名稱。您不需要加入 Inc 或 LLC 等後綴。這個欄位可協助 LLM 識別應用程式所代表的公司。
在「資料存取透明度」部分,選取「停用這個應用程式的搜尋指標」,即可停用目前應用程式的記錄指標。應用程式建立後,就無法變更這項設定。
按一下「繼續」。
如要連結資料儲存庫,請在「資料儲存庫」頁面中執行下列任一操作:
- 選取現有的醫療照護資料儲存庫進行批次匯入,或選取現有資料連接器進行串流匯入。如要在建立應用程式前建立資料儲存庫或資料連接器,請參閱「建立醫療照護資料儲存庫」一文。
- 建立資料儲存庫 (用於一次性批次匯入) 或資料連接器 (用於串流匯入),資料連接器是資料儲存庫的例項:
- 按一下 add_box「建立資料儲存庫」。
- 在「Select a data source」(選取資料來源) 窗格中,選取「Healthcare API (FHIR)」做為資料來源。
- 如要從 FHIR 儲存庫匯入資料,請執行下列任一操作:
- 從可用 FHIR 儲存庫清單中選取 FHIR 儲存庫:
- 展開「FHIR 儲存庫」欄位。
- 在這個清單中,選取位於允許位置的資料集,然後選取使用 FHIR 4.0 版的 FHIR 儲存庫。
- 手動輸入 FHIR 儲存庫:
- 展開「FHIR 儲存庫」欄位。
- 按一下「手動輸入 FHIR 存放區」。
- 在「FHIR 儲存庫名稱」對話方塊中,輸入 FHIR 儲存庫的完整名稱,格式如下:
project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID
- 按一下 [儲存]。
- 從可用 FHIR 儲存庫清單中選取 FHIR 儲存庫:
- 在「同步處理」部分中,選取下列其中一個選項。
資料儲存庫建立後,即無法變更這項選擇。
- 一次性:執行一次性的批次資料匯入作業。如要進一步瞭解如何匯入增量資料,請參閱「重新整理醫療保健資料」。
- 串流:執行近乎即時的串流資料匯入作業。如要串流資料,您必須建立資料連接器,這是一種資料儲存庫。如要使用 REST API 設定串流資料儲存庫,請與客戶工程師聯絡。
- 在「這項資料的結構定義是什麼?」部分,選取下列其中一個選項:
- Google 預先定義的結構定義:保留 Google 定義的結構定義設定,例如支援的 FHIR 資源和元素的可索引、可搜尋和可擷取性。選取這個選項後,您就無法在建立資料儲存庫後更新結構定義。如果您想在建立資料儲存庫後變更架構,請選取「自訂架構」選項。
- 按一下「繼續」。
- 在「資料儲存庫名稱」欄位中,輸入資料儲存庫的名稱。
- 按一下 [建立]。
您建立的資料儲存庫會列在「資料儲存庫」頁面。
- 自訂結構定義:為支援的 FHIR 資源和元素定義專屬的結構定義設定,例如索引、搜尋和擷取功能。如要設定可設定的結構定義,請與客戶工程師聯絡。
- 按一下「繼續」。
- 查看結構定義、展開每個欄位,然後編輯欄位設定。
- 按一下「Add new fields」,即可在支援的 FHIR 資源上新增欄位。您無法移除 Google 定義的結構定義中提供的欄位。
- 按一下「繼續」。
- 在「資料連接器名稱」欄位中,輸入資料連接器的名稱。
- 按一下 [建立]。
您建立的資料連接器會列在「資料儲存庫」頁面中。 來源 FHIR 存放區會新增為資料連接器中的實體。
- Google 預先定義的結構定義:保留 Google 定義的結構定義設定,例如支援的 FHIR 資源和元素的可索引、可搜尋和可擷取性。選取這個選項後,您就無法在建立資料儲存庫後更新結構定義。如果您想在建立資料儲存庫後變更架構,請選取「自訂架構」選項。
- 按一下「繼續」。
- 選取已建立的資料儲存庫或資料連接器。
選用步驟:如要查看無法使用的資料儲存庫清單,請按一下「瞭解原因」。
系統會顯示表格,列出資料儲存庫清單和無法使用的原因。以下是資料儲存庫可能無法使用的幾個原因:
- 您的資料儲存庫類型僅允許連結至一個應用程式,而資料儲存庫已連結。
- 資料儲存庫和應用程式的類型不同。舉例來說,您無法將網站搜尋資料儲存庫連結至醫療照護搜尋應用程式。
按一下 [建立]。
如果應用程式及其資料儲存庫已成功建立,資料儲存庫詳細資料頁面會顯示匯入 FHIR 資料的詳細資料。
REST
- 建立醫療照護資料儲存庫,並將醫療照護資料匯入其中。
建立醫療照護搜尋應用程式,並連結至資料儲存庫。醫療照護搜尋應用程式只能連結至一個資料儲存庫,但一個資料儲存庫可以連結至多個應用程式。
curl -X POST\ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json"\ -H "X-Goog-User-Project: PROJECT_ID" \ "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \ -d '{ "displayName": "APP_DISPLAY_NAME", "dataStoreIds":"DATA_STORE_ID", "industryVertical": "HEALTHCARE_FHIR", "solutionType": "SOLUTION_TYPE_SEARCH", "searchEngineConfig": { "searchTier": "SEARCH_TIER_STANDARD", "searchAddOns": ["SEARCH_ADD_ON"] } }'
更改下列內容:
PROJECT_ID
: Google Cloud 專案的 ID。APP_ID
:您要建立的 Vertex AI Search 應用程式 ID。APP_DISPLAY_NAME
:您要建立的 Vertex AI Search 應用程式顯示名稱。DATA_STORE_ID
:您要新增至 Vertex AI Search 應用程式的現有 Vertex AI Search 資料儲存庫 ID。SEARCH_ADD_ON
:這個選用欄位可用來指定是否要在這個應用程式中使用進階 LLM 功能,例如使用生成式 AI 答案搜尋。如要啟用進階 LLM 功能,請輸入值SEARCH_ADD_ON_LLM
。如果您不想使用進階 LLM 功能,請指定SEARCH_ADD_ON_UNSPECIFIED
或移除searchAddOns
欄位。詳情請參閱「進階 LLM 功能」。
驗證應用程式建立作業
本任務將說明如何驗證是否已成功建立醫療照護搜尋應用程式,以及 FHIR 資料是否已成功匯入資料儲存庫。
- 在 Google Cloud 控制台中:選取應用程式並確認詳細資料。
- 透過 REST API,使用
engines.get
方法取得醫療照護資料儲存庫詳細資料。
如要驗證資料儲存庫建立和資料匯入作業,請完成下列步驟。
控制台
前往 Google Cloud 控制台的「AI Applications」頁面。
在「應用程式」頁面中,確認您建立的應用程式是否列在應用程式清單中。
確認已連結至應用程式的資料儲存庫是否列於「已連結的資料儲存庫」表格中。
選取資料儲存庫並驗證資料儲存庫詳細資料。
REST
確認應用程式建立作業。
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json"\ -H "X-Goog-User-Project: PROJECT_ID" \ "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"
更改下列內容:
PROJECT_ID
: Google Cloud 專案的 ID。APP_ID
:Vertex AI Search 應用程式 ID。
後續步驟
- 在醫療照護搜尋應用程式中搜尋醫療照護資料。
- 重新整理醫療照護資料。