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

如要在 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. 在「建立應用程式」頁面,點選「醫療保健搜尋」下方的「建立」

  4. 在「Search app configuration」(搜尋應用程式設定) 窗格中,選取「Healthcare」(醫療照護)

  5. 如要為這個應用程式啟用進階 LLM 功能,請點按「Advanced LLM features」(進階 LLM 功能) 切換按鈕。

    啟用進階 LLM 功能即可取得搜尋摘要,也就是一或多個熱門搜尋結果的簡短摘要。

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

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

  7. 在「External name of your company or organization」(貴公司或貴機構的外部名稱) 欄位中,輸入公司或機構的常用名稱。您不必加入 Inc 或 LLC 等後置字元。這個欄位有助於 LLM 識別應用程式代表的公司。

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

  9. 按一下「繼續」

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

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

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

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

        • 自訂結構定義:定義自己的結構定義設定,例如支援的 FHIR 資源和元素的索引、搜尋和擷取功能。如要設定可設定的結構定義,請與客戶工程師聯絡。
          1. 按一下「繼續」
          2. 查看結構定義、展開每個欄位,然後編輯欄位設定。
          3. 按一下「新增欄位」,在支援的 FHIR 資源中新增欄位。您無法移除 Google 定義結構定義中提供的欄位。
          4. 按一下「繼續」
          5. 在「Your data connector name」(資料連接器名稱) 欄位中,輸入資料連接器的名稱。
          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 應用程式顯示名稱。
    • :現有 Vertex AI Search 資料儲存庫的 ID,您要將該資料儲存庫新增至 Vertex AI Search 應用程式。DATA_STORE_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 資料匯入作業

後續步驟