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

注意:

• ヘルスケアに関する制限: お客様は、生成 AI サービスを臨床目的（明確にするために記すと、非臨床研究、スケジュール設定、またはその他の管理業務は制限されません）、専門的な医療アドバイスの代用として、または該当する規制機関の監督下にある、もしくは該当する規制機関の許可もしくは承認を必要とする方法で使用してはならず、エンドユーザーにも使用させてはなりません。詳しくは、サービス固有の規約をご覧ください。

  明確にするために記すと、Vertex AI Search を使用して既存の医療情報を取得して要約する場合、臨床目的での使用の制限とは、適用される法律および規制に準拠して、ライセンス取得済みの専門家による審査なしで直接診断または治療の目的で使用することを制限することを意味します。

• 生成された出力は、必ずしも完全に信頼できるとは限りません。LLM と生成 AI の性質上、出力には誤った情報や偏った情報（ステレオタイプや他の有害なコンテンツなど）が含まれている可能性があるため、確認する必要があります。すべての要約や回答は、最終版ではなく草稿とお考えください。
• このプロダクトが意図する使用は、病気や疾患の予防、診断、治療に関する情報を提供することではありません。 診断や治療の推奨に関する質問は、このプロダクトでの対応を意図していません。このプロダクトが意図する使用は、ユーザーから提供された既存の医療情報を取得して要約することです。
• テストデータが限られているため、このプロダクトは 0 から 18 歳の年齢層と 85 歳以上の年齢層に適している場合とそうでない場合があります。したがって、生成された出力を確認する際は、ソースデータ内のサブポピュレーションの代表性を考慮する必要があります。

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 の割り当てをご覧ください。

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

始める前に

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

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

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

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

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

アプリを作成する

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

このタスクに必要な権限

Vertex AI Search データストアを含むプロジェクトの [e-mail] サービス アカウントに、次の Identity and Access Management（IAM）ロールを付与します。

目的	ロール
Cloud Healthcare API の FHIR ストアから FHIR データを 1 回だけバッチ インポートする場合。	BigQuery ジョブユーザー（roles/bigquery.jobUser） BigQuery データ編集者（roles/bigquery.dataEditor） Healthcare FHIR ストア管理者（roles/healthcare.fhirStoreAdmin）
同じ Google Cloud プロジェクト内の Cloud Healthcare API の FHIR ストアから FHIR データをストリーミング インポートする。	BigQuery ジョブユーザー（roles/bigquery.jobUser） BigQuery データ編集者（roles/bigquery.dataEditor） Healthcare FHIR ストア管理者（roles/healthcare.fhirStoreAdmin） Healthcare FHIR リソース読み取り（roles/healthcare.fhirResourceReader）
別の Google Cloud プロジェクトの Cloud Healthcare API の FHIR ストアから FHIR データをストリーミング インポートする。	BigQuery ジョブユーザー（roles/bigquery.jobUser） BigQuery データ編集者（roles/bigquery.dataEditor） Healthcare FHIR ストア管理者（roles/healthcare.fhirStoreAdmin） Healthcare FHIR リソース読み取り（roles/healthcare.fhirResourceReader）
Cloud Storage 内のファイルを参照する FHIR データをインポートするには。参照されるファイルが Vertex AI Search アプリと同じ Google Cloud プロジェクトにある場合、これらの権限はデフォルトで付与されます。	ストレージ オブジェクト管理者（roles/storage.objectAdmin）
データストアの作成時にスキーマをカスタマイズして、FHIR リソースと要素のインデックス登録可能性、検索可能性、取得可能性を構成するには。	ストレージ オブジェクト管理者（roles/storage.objectAdmin）

Cloud Healthcare API FHIR R4 データストアを含むプロジェクトの [e-mail] サービス アカウントに、次の Identity and Access Management ロールを付与します。

目的	ロール
別の Google Cloud プロジェクトの Cloud Healthcare API の FHIR ストアから FHIR データをストリーミング インポートする。	Healthcare FHIR ストア管理者（roles/healthcare.fhirStoreAdmin） Healthcare FHIR リソース読み取り（roles/healthcare.fhirResourceReader）

Cloud Healthcare API FHIR R4 データストアを含むプロジェクトの [e-mail] サービス アカウントに、次の Identity and Access Management ロールを付与します。

目的	ロール
同じ Google Cloud プロジェクト内の Cloud Healthcare API の FHIR ストアから FHIR データをストリーミング インポートする。	BigQuery ジョブユーザー（roles/bigquery.jobUser） BigQuery データ編集者（roles/bigquery.dataEditor）
データストアの作成時にスキーマをカスタマイズして、FHIR リソースと要素のインデックス登録可能性、検索可能性、取得可能性を構成するには。	ストレージ オブジェクト管理者（roles/storage.objectAdmin）

コンソール

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

   AI Applications

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

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

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

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

   高度な LLM 機能を有効にすると、上位の検索結果の簡単な要約である検索サマリーが表示されます。

   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. [作成] をクリックします。

           作成したデータストアが [データストア] ページに表示されます。

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

           作成したデータコネクタが [データストア] ページに表示されます。 ソース FHIR ストアは、データコネクタ内のエンティティとして追加されます。

      6. [続行] をクリックします。
      7. 作成したデータストアまたはデータコネクタを選択します。

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

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

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

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

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

REST

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

2. 医療検索アプリを作成し、データストアに接続します。医療検索アプリは 1 つのデータストアにしか接続できませんが、1 つのデータストアを複数のアプリに接続することが可能です。

   キーワード: Vertex AI Search では、API のコンテキストでアプリという用語とエンジンという用語を同じ意味で使用できます。

   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 機能をご覧ください。

   レスポンス

   次のような JSON レスポンスが返されます。done フィールドの値が true の場合、アプリを作成するオペレーションが完了したことを示します。false の場合、アプリの作成オペレーションは失敗しました。

   {
     "name": "projects/PROJECT_ID/locations/us/collections/default_collection/operations/APP_CREATION_OPERATION_ID",
     "done": true,
     "response": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1.Engine",
       "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
       "displayName": "APP_DISPLAY_NAME",
       "dataStoreIds": [
         "DATA_STORE_ID"
       ],
       "solutionType": "SOLUTION_TYPE_SEARCH",
       "searchEngineConfig": {
         "searchTier": "SEARCH_TIER_STANDARD",
         "searchAddOns": [
           "SEARCH_ADD_ON_LLM"
         ]
       },
       "industryVertical": "HEALTHCARE_FHIR"
     }
   }
   

アプリの作成を確認する

このタスクでは、医療検索アプリが正常に作成されたかどうか、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: Vertex AI Search アプリの ID。

   レスポンス

   次のような JSON レスポンスが返されます。レスポンスには、作成されたアプリの詳細が含まれます。

   {
     "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
     "displayName": "APP_DISPLAY_NAME",
     "createTime": "APP_CREATION_TIMESTAMP",
     "dataStoreIds": [
       "DATA_STORE_ID"
     ],
     "solutionType": "SOLUTION_TYPE_SEARCH",
     "searchEngineConfig": {
       "searchTier": "SEARCH_TIER_STANDARD",
       "searchAddOns": [
         "SEARCH_ADD_ON_LLM"
       ]
     },
     "industryVertical": "HEALTHCARE_FHIR",
     "dataStores": [
       "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/APP_ID"
     ]
   }
   

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

次のステップ

• 医療検索アプリで医療データを検索する。
• 医療データを更新する。