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

エージェント検索で臨床データを検索するには、次のいずれかのワークフローを使用します。

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

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

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

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

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

  • ストリーミング インポート: ニア リアルタイムのストリーミング データのインポート。ソース FHIR ストアの増分変更は、エージェント検索データストアで同期されます。ストリーミングには、データストアの一種であるデータコネクタが必要です。データコネクタを作成するには、コレクションを設定する必要があります。データコネクタには、データストア インスタンスでもあるエンティティが含まれています。

    また、ストリーミングを一時停止して再開したり、必要に応じて手動で同期したりすることもできます。詳細については、医療検索データストアを管理するをご覧ください。

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

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

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

始める前に

医療検索アプリを作成する前に、次のことを理解しておいてください。

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

  • 取り込む FHIR データの準備。

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

  • 1 つの Google Cloud プロジェクトの Cloud Healthcare API FHIR ストアから別の Google Cloud プロジェクトの Agent Search データストアに医療データをインポートし、VPC Service Controls を使用している場合、2 つのプロジェクトは同じ境界内に存在する必要があります。

アプリを作成する

医療検索アプリは、 Google Cloud コンソールまたは API を使用して作成できます。医療検索アプリを作成する手順は次のとおりです。

コンソール

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

    AI Applications

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

  3. [アプリを作成する] ページの [ヘルスケア検索] で [作成] をクリックします。

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

  5. このアプリで 高度な LLM 機能を使用する生成回答を有効にするには、[生成回答] 切り替えボタンをクリックしてオンにします。

    生成レスポンスを有効にしてから、サポートされている機能が利用可能になるまでに最大 5 分ほどかかることがあります。

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

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

  8. [アクセスの透明性] セクションで、[このアプリの検索指標を無効にする] を選択して、現在のアプリの指標のロギングをオフにします。アプリの作成後にこれを変更することはできません。

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

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

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

  11. 省略可: 利用できないデータストアのリストを表示するには、[理由を確認] をクリックします。

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

    • データストア タイプで接続できるアプリが 1 つだけで、そのデータストアがすでに接続されています。
    • データストアとアプリのタイプが異なる。たとえば、ウェブサイト検索データストアを医療検索アプリに接続することはできません。

  12. [作成] をクリックします。

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

REST

  1. 医療データストアを作成して、医療データをインポートします。

  2. 医療検索アプリを作成し、データストアに接続します。ヘルスケア検索アプリは 1 つのデータストアにしか接続できませんが、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/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: 作成するエージェント検索アプリの ID。
    • APP_DISPLAY_NAME: 作成するエージェント検索アプリの表示名。
    • DATA_STORE_ID: エージェント検索アプリに追加する既存のエージェント検索データストアの 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 Applications

  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: Agent Search アプリの ID。

  2. データストアの作成と FHIR データのインポートを確認します。

次のステップ