建立醫療照護搜尋應用程式

如要在 Vertex AI Search 中搜尋臨床資料,您可以按照下列任一工作流程操作:

  • 建立醫療照護資料儲存庫、將 FHIR R4 資料匯入資料儲存庫、將其連結至醫療照護搜尋應用程式,然後查詢臨床資料。詳情請參閱「建立醫療保健資料儲存庫」。
  • 建立醫療照護搜尋應用程式、建立醫療照護資料儲存庫,並在應用程式建立程序中將 FHIR R4 資料匯入資料儲存庫,然後查詢臨床資料。

本頁面將說明第二種方法。

關於資料匯入頻率

您可以透過下列方式,將 FHIR R4 資料匯入資料儲存庫:

  • 批次匯入:一次性匯入。資料會以批次方式匯入資料儲存庫。如要進一步瞭解如何匯入增量資料,請參閱「重新整理醫療保健資料」。

  • 串流匯入:近乎即時的串流資料匯入。來源 FHIR 儲存庫中的任何增量變更都會在 Vertex AI Search 資料儲存庫中同步處理。串流功能需要資料連接器,這是一種資料儲存庫類型。如要建立資料連接器,您必須設定集合。資料連接器包含實體,這也是資料儲存庫的執行個體。

    您也可以暫停及繼續串流,並視需要手動同步處理。詳情請參閱「管理醫療保健搜尋資料儲存庫」。

    特定 Google Cloud 專案的資料串流速率取決於下列配額。如果超出配額,可能會發生串流延遲的情形。

您可以在建立資料儲存庫時選取資料匯入頻率,且日後無法變更這項設定。

事前準備

建立醫療保健搜尋應用程式前,請先瞭解下列事項:

  • 醫療照護搜尋應用程式與資料儲存庫之間的關係。詳情請參閱「關於應用程式和資料儲存庫」。

  • 準備 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 建立醫療保健搜尋應用程式。如要建立醫療保健搜尋應用程式,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在「應用程式」頁面中,按一下 「新增應用程式」

  3. 在「Create App」頁面,點選「Healthcare search」下方的「Create」

  4. 在「搜尋應用程式設定」窗格中,選取「醫療照護內容搜尋應用程式」

  5. 如要為這個應用程式開啟進階 LLM 功能,請按一下「進階 LLM 功能」切換鈕。

    啟用進階 LLM 功能,即可取得搜尋摘要,也就是前幾個搜尋結果的簡短摘要。

    啟用 LLM 功能後,最多可能需要五分鐘才能開始使用支援的功能。

  6. 在「應用程式名稱」欄位中輸入應用程式名稱。

  7. 在「貴公司或貴機構的外部名稱」欄位中,輸入貴公司或貴機構的常用名稱。您不需要加入 Inc 或 LLC 等後綴。這個欄位可協助 LLM 識別應用程式所代表的公司。

  8. 在「資料存取透明度」部分,選取「停用這個應用程式的搜尋指標」,即可停用目前應用程式的記錄指標。應用程式建立後,就無法變更這項設定。

  9. 按一下「繼續」

  10. 如要連結資料儲存庫,請在「資料儲存庫」頁面中執行下列任一操作:

    • 選取現有的醫療照護資料儲存庫進行批次匯入,或選取現有資料連接器進行串流匯入。如要在建立應用程式前建立資料儲存庫或資料連接器,請參閱「建立醫療照護資料儲存庫」一文。
    • 建立資料儲存庫 (用於一次性批次匯入) 或資料連接器 (用於串流匯入),資料連接器是資料儲存庫的例項:
      1. 按一下 「建立資料儲存庫」
      2. 在「Select a data source」(選取資料來源) 窗格中,選取「Healthcare API (FHIR)」做為資料來源。
      3. 如要從 FHIR 儲存庫匯入資料,請執行下列任一操作:
        • 從可用 FHIR 儲存庫清單中選取 FHIR 儲存庫:
          1. 展開「FHIR 儲存庫」欄位。
          2. 在這個清單中,選取位於允許位置的資料集,然後選取使用 FHIR 4.0 版的 FHIR 儲存庫。
        • 手動輸入 FHIR 儲存庫:
          1. 展開「FHIR 儲存庫」欄位。
          2. 按一下「手動輸入 FHIR 存放區」
          3. 在「FHIR 儲存庫名稱」對話方塊中,輸入 FHIR 儲存庫的完整名稱,格式如下:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. 按一下 [儲存]
      4. 在「同步處理」部分中,選取下列其中一個選項。 資料儲存庫建立後,即無法變更這項選擇。
        • 一次性:執行一次性的批次資料匯入作業。如要進一步瞭解如何匯入增量資料,請參閱「重新整理醫療保健資料」。
        • 串流:執行近乎即時的串流資料匯入作業。如要串流資料,您必須建立資料連接器,這是一種資料儲存庫。如要使用 REST API 設定串流資料儲存庫,請與客戶工程師聯絡。
      5. 在「這項資料的結構定義是什麼?」部分,選取下列其中一個選項:
        • Google 預先定義的結構定義:保留 Google 定義的結構定義設定,例如支援的 FHIR 資源和元素的可索引、可搜尋和可擷取性。選取這個選項後,您就無法在建立資料儲存庫後更新結構定義。如果您想在建立資料儲存庫後變更架構,請選取「自訂架構」選項。
          1. 按一下「繼續」
          2. 在「資料儲存庫名稱」欄位中,輸入資料儲存庫的名稱。
          3. 按一下 [建立]。
          4. 您建立的資料儲存庫會列在「資料儲存庫」頁面。

        • 自訂結構定義:為支援的 FHIR 資源和元素定義專屬的結構定義設定,例如索引、搜尋和擷取功能。如要設定可設定的結構定義,請與客戶工程師聯絡。
          1. 按一下「繼續」
          2. 查看結構定義、展開每個欄位,然後編輯欄位設定。
          3. 按一下「Add new fields」,即可在支援的 FHIR 資源上新增欄位。您無法移除 Google 定義的結構定義中提供的欄位。
          4. 按一下「繼續」
          5. 在「資料連接器名稱」欄位中,輸入資料連接器的名稱。
          6. 按一下 [建立]。
          7. 您建立的資料連接器會列在「資料儲存庫」頁面中。 來源 FHIR 存放區會新增為資料連接器中的實體。

      6. 按一下「繼續」
      7. 選取已建立的資料儲存庫或資料連接器。
  11. 選用步驟:如要查看無法使用的資料儲存庫清單,請按一下「瞭解原因」

    系統會顯示表格,列出資料儲存庫清單和無法使用的原因。以下是資料儲存庫可能無法使用的幾個原因:

    • 您的資料儲存庫類型僅允許連結至一個應用程式,而資料儲存庫已連結。
    • 資料儲存庫和應用程式的類型不同。舉例來說,您無法將網站搜尋資料儲存庫連結至醫療照護搜尋應用程式。
  12. 按一下 [建立]。

    如果應用程式及其資料儲存庫已成功建立,資料儲存庫詳細資料頁面會顯示匯入 FHIR 資料的詳細資料。

REST

  1. 建立醫療照護資料儲存庫,並將醫療照護資料匯入其中
  2. 建立醫療照護搜尋應用程式,並連結至資料儲存庫。醫療照護搜尋應用程式只能連結至一個資料儲存庫,但一個資料儲存庫可以連結至多個應用程式。

    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 方法取得醫療照護資料儲存庫詳細資料。

如要驗證資料儲存庫建立和資料匯入作業,請完成下列步驟。

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 在「應用程式」頁面中,確認您建立的應用程式是否列在應用程式清單中。

  3. 確認已連結至應用程式的資料儲存庫是否列於「已連結的資料儲存庫」表格中。

  4. 選取資料儲存庫並驗證資料儲存庫詳細資料

REST

  1. 確認應用程式建立作業。

    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。
  2. 驗證資料儲存庫建立作業和 FHIR 資料匯入作業

後續步驟