医療検索アプリを作成する

Vertex AI Search で臨床データを検索するには、次のいずれかのワークフローに沿って操作します。

  • ヘルスケア データストアを作成し、FHIR R4 データをデータストアにインポートして医療検索アプリに接続し、臨床データをクエリします。 詳細については、ヘルスケア データストアを作成するをご覧ください。
  • 医療検索アプリを作成し、ヘルスケア データストアを作成して、アプリの作成プロセス中に FHIR R4 データをデータストアにインポートし、臨床データをクエリします。

このページでは、2 つ目の方法について説明します。

データ インポートの頻度について

FHIR R4 データをデータストアにインポートするには、次の方法があります。

  • 一括インポート: 1 回限りのインポート。データがデータストアにインポートされます。その他の増分インポートについては、ヘルスケア データを更新するをご覧ください。

  • ストリーミング インポート(プレビュー版): ニア リアルタイムのストリーミング データのインポート。ソース FHIR ストアの増分変更は、Vertex AI Search データストアで同期されます。ストリーミングにはデータコネクタが必要です。これは、エンティティを含むデータストアの一種です。エンティティはデータストア インスタンスでもあります。

    特定の Google Cloud プロジェクトのデータ ストリーミング レートは、次の割り当てによって異なります。割り当てを超えると、ストリーミングが遅延する可能性があります。

    • 1 分あたりの保留中の FHIR または BigQuery ストリーミング書き込みの数。 詳細については、割り当てと上限をご覧ください。
    • 1 分間、1 リージョンあたりの FHIR 読み取りオペレーション数。詳細については、Cloud Healthcare API FHIR の割り当てをご覧ください。

データ インポートの頻度は、データストアの作成時に選択できます。この構成は後で変更できません。

ストリーミング インポートは、Vertex AI Search がサポートするすべてのリソースで使用できます。詳細については、Healthcare FHIR R4 データスキーマ リファレンスをご覧ください。

始める前に

医療検索アプリを作成する前に、次の要件を満たす必要があります。

  • 医療検索のアプリとデータストアの関係を理解します。 詳細については、アプリとデータストアについてをご覧ください。

  • 取り込む FHIR データを準備します。

  • Vertex AI Search for Healthcare は、米国のマルチリージョン(us)でのみ検索サービスを提供します。したがって、医療検索アプリとデータストアは us マルチリージョンに配置する必要があります。

アプリの作成

ヘルスケア検索アプリは、Google Cloud コンソールまたは API を使用して作成できます。この 2 つのアプローチの違いは次のとおりです。

  • Google Cloud コンソール: Cloud Healthcare API でソース FHIR ストアを選択し、ヘルスケア検索アプリの作成プロセスの一環として FHIR データをインポートします。FHIR データをストリーミングするには(プレビュー版)、ソース FHIR ストアが宛先 Vertex AI Search アプリと同じ Google Cloud プロジェクトに存在する必要があります。
  • REST API を使用: Cloud Healthcare API の FHIR ストアから FHIR データをインポートできます。FHIR ストアは、同じ Google Cloud プロジェクトに配置することも、別の Google Cloud プロジェクトに配置することもできます。
    1. dataStores.create メソッドを使用して、医療データストアを作成します。
    2. documents.import メソッドを使用して、Cloud Healthcare API で FHIR ストアを指定し、FHIR データをインポートします。
    3. engines.create メソッドを使用して医療検索アプリを作成し、既存の医療データストアを指定します。

ヘルスケア検索アプリを作成する手順は次のとおりです。

Console

  1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

    Agent Builder

  2. [アプリ] ページで、 [新しいアプリ] をクリックします。

  3. [アプリを作成] ページの [医療検索] で、[作成] をクリックします。

  4. [検索アプリの構成] ペインで、[ヘルスケア] を選択します。

  5. このアプリで高度な LLM 機能を有効にするには、[高度な LLM 機能] トグルをクリックします。

    高度な LLM 機能を有効にすると、検索の要約を取得できます。検索の要約は、上位の検索結果の短い要約です。

    LLM 機能を有効にしてから、サポートされている機能が使用可能になるまでに最大で 5 分ほどかかります。

  6. [アプリ名] フィールドに、アプリの名前を入力します。

  7. [会社または組織の表示名] フィールドに、会社または組織の一般名を入力します。Inc や LLC などの接尾辞を含める必要はありません。このフィールドは、アプリが代表する会社を LLM が識別するために役立ちます。

  8. [続行] をクリックします。

  9. データストアに接続するには、[データストア] ページで次のいずれかを行います。

    • バッチ インポートの場合は既存のヘルスケア データストアを選択し、ストリーミング インポートの場合は既存のデータコネクタを選択します。アプリを作成する前にデータストアまたはデータ コネクタを作成するには、ヘルスケア データストアを作成するをご覧ください。
    • データストア(1 回限りのバッチ インポート用)またはデータコネクタ(データストアのインスタンス、ストリーミング インポート用)を作成します。
      1. [データストアを作成] をクリックします。
      2. [データソースを選択] ペインで、データソースとして [Healthcare API(FHIR)] を選択します。
      3. FHIR ストアからデータをインポートするには、次のいずれかを行います。
        • 使用可能な FHIR ストアのリストから FHIR ストアを選択します。
          1. [FHIR ストア] フィールドを開きます。
          2. このリストで、許可されたロケーションにあるデータセットを選択し、FHIR バージョン R4 を使用する FHIR ストアを選択します。

            FHIR データをストリーミングするには(プレビュー版)、ソース FHIR ストアが宛先 Vertex AI Search データストアと同じ Google Cloud プロジェクトに存在する必要があります。

        • FHIR ストアを手動で入力します。
          1. [FHIR ストア] フィールドを開きます。
          2. [FHIR ストアを手動で入力] をクリックします。
          3. [FHIR ストア名] ダイアログで、FHIR ストアの完全な名前を次の形式で入力します。

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

          4. [保存] をクリックします。
      4. [ロケーション] セクションで、次のいずれかのオプションを選択します。 この選択は、データストアの作成後に変更することはできません
        • 1 回限り: 1 回限りの一括データ インポートを実行します。その他の増分インポートについては、ヘルスケア データを更新するをご覧ください。
        • ストリーミング: ニア リアルタイムのストリーミング データのインポートを実行します。データをストリーミングするには、データストアの一種であるデータコネクタを作成する必要があります。これはプレビュー機能です。REST API を使用してストリーミング データストアを設定するには、カスタマー エンジニアにお問い合わせください。
      5. [このデータのスキーマ] セクションで、次のいずれかのオプションを選択します。
        • Google の事前定義スキーマ: サポートされている FHIR リソースと要素に対して、Google が定義したスキーマ構成(インデックス登録可能性、検索可能性、取得可能性など)を保持します。このオプションを選択すると、データストアの作成後にスキーマを更新することはできません。データストアの作成後にスキーマを変更できるようにするには、[カスタム スキーマ(プレビュー)] オプションを選択します。
          1. [続行] をクリックします。
          2. [データストア名] フィールドに、データストアの名前を入力します。
          3. [作成] をクリックします。
          4. 作成したデータストアが [データストア] ページに表示されます。

        • カスタム スキーマ(プレビュー): サポートされている FHIR リソースと要素に独自のスキーマ構成(インデックス登録可能性、検索可能性、取得可能性など)を定義します。これはプレビュー機能です。構成可能なスキーマを設定するには、カスタマー エンジニアにお問い合わせください。
          1. [続行] をクリックします。
          2. スキーマを確認し、各フィールドを開いてフィールドの設定を編集します。
          3. [新しいフィールドを追加] をクリックして、サポートされている FHIR リソースに新しいフィールドを追加します。Google が定義したスキーマで指定されているフィールドは削除できません。
          4. [続行] をクリックします。
          5. [データ コネクタ名] フィールドに、データ コネクタの名前を入力します。
          6. [作成] をクリックします。
          7. 作成したデータコネクタが [データストア] ページに表示されます。 ソース FHIR ストアがデータコネクタ内にエンティティとして追加されます。

      6. [続行] をクリックします。
      7. 作成したデータストアまたはデータコネクタを選択します。
  10. 省略可: 使用できないデータストアのリストを表示するには、[理由を確認] をクリックします。

    データストアのリストと、使用できない理由が記載された表が表示されます。データストアが使用できない理由としては、次のようなものがあります。

    • データストア タイプで接続できるアプリが 1 つだけで、そのデータストアがすでに接続されています。
    • データストアとアプリのタイプが異なります。たとえば、ウェブサイト検索データストアをヘルスケア検索アプリに接続することはできません。
  11. [作成] をクリックします。

    アプリとそのデータストアが正常に作成されると、データストアの詳細ページに、インポートされた FHIR データの詳細が表示されます。

REST

  1. ヘルスケア データストアを作成して、ヘルスケア データをインポートする
  2. 医療検索アプリを作成してデータストアに接続します。医療検索アプリは 1 つのデータストアにのみ接続できますが、特定のデータストアは複数のアプリに接続できます。

    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/v1alpha/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 メソッドを使用して、ヘルスケア データストアの詳細を取得します。

データストアの作成とデータのインポートを確認する手順は次のとおりです。

Console

  1. Google Cloud コンソールで、[Agent Builder] ページに移動します。

    Agent Builder

  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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"
    

    以下を置き換えます。

    • PROJECT_ID: Google Cloud プロジェクトの ID。
    • APP_ID: Vertex AI Search アプリの ID。
  2. データストアの作成と FHIR データのインポートを確認する

次のステップ