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

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

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

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

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

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

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

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

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

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

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

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

始める前に

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

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

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

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

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

アプリを作成する

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

コンソール

  1. コンソールで、[AI アプリケーション] ページに移動します。 Google Cloud

    AI Applications

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

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

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

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

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

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

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

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

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

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

    • バッチ インポートの場合は既存の医療データストアを選択し、ストリーミング インポートの場合は既存のデータ コネクタを選択します。アプリを作成する前にデータストアまたはデータ コネクタを作成するには、医療データストアを作成するをご覧ください。
    • データストア（1 回限りのバッチ インポート用）、またはデータストアのインスタンスであるデータコネクタ（ストリーミング インポート用）を作成します。
      1. [データストアを作成] をクリックします。
      2. [データソースを選択] ペインで、データソースとして [Healthcare API（FHIR）] を選択します。
      3. FHIR ストアからデータをインポートするには、次のいずれかを行います。
      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"]
    }
}'

    次のように置き換えます。

アプリの作成を確認する

このタスクでは、医療検索アプリが正常に作成されたかどうか、FHIR データがデータストアに正常にインポートされたかどうかを確認する方法について説明します。

  • コンソールで、アプリを選択して詳細を確認します。 Google Cloud
  • REST API で engines.get メソッドを使用して、医療データストアの詳細を取得します。

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

コンソール

  1. コンソールで、[AI アプリケーション] ページに移動します。 Google Cloud

    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 データのインポートを確認します。

次のステップ