Membuat aplikasi penelusuran layanan kesehatan

Perhatian:

• Batasan untuk layanan kesehatan: Sebagai pelanggan, Anda tidak akan, dan tidak akan mengizinkan Pengguna Akhir, menggunakan Layanan AI Generatif untuk tujuan klinis (agar lebih jelas, riset non-klinis, penjadwalan, atau tugas administratif lainnya tidak dibatasi), sebagai pengganti nasihat medis profesional, atau dengan cara apa pun yang diawasi atau memerlukan izin atau persetujuan dari otoritas pengatur yang berlaku. Untuk mengetahui informasi selengkapnya, lihat Persyaratan Khusus Layanan.

  Untuk memperjelas, terkait penggunaan Vertex AI Search untuk mengambil dan meringkas informasi medis yang ada, pembatasan penggunaan untuk tujuan klinis berarti pembatasan penggunaan untuk tujuan diagnosis atau perawatan langsung tanpa peninjauan oleh tenaga profesional berlisensi sesuai dengan hukum dan peraturan yang berlaku.

• Output yang dihasilkan mungkin tidak selalu sepenuhnya dapat diandalkan. Karena sifat LLM dan AI Generatif, output mungkin memiliki informasi yang salah atau bias (misalnya, stereotipe atau konten berbahaya lainnya) dan harus ditinjau. Semua ringkasan atau jawaban harus dianggap sebagai draf dan bukan final.
• Penggunaan produk ini yang dimaksudkan bukan untuk memberikan informasi yang berkaitan dengan pencegahan, diagnosis, atau pengobatan penyakit. Pertanyaan terkait diagnosis atau rekomendasi perawatan tidak dimaksudkan untuk dijawab oleh produk ini. Penggunaan produk ini yang dimaksudkan adalah untuk mengambil dan meringkas informasi medis yang ada yang diberikan oleh pengguna.
• Karena data pengujian terbatas, produk ini mungkin atau mungkin tidak berlaku untuk grup usia 0-18 dan untuk grup usia 85 tahun ke atas. Oleh karena itu, saat meninjau output yang dihasilkan, pelanggan harus mempertimbangkan representasi subpopulasi dalam data sumber mereka.

Untuk menelusuri data klinis di Vertex AI Search, Anda dapat mengikuti salah satu alur kerja berikut:

• Buat penyimpanan data layanan kesehatan, impor data FHIR R4 ke penyimpanan data, hubungkan ke aplikasi penelusuran layanan kesehatan, dan kueri data klinis. Untuk mengetahui informasi selengkapnya, lihat Membuat penyimpanan data kesehatan.
• Buat aplikasi penelusuran layanan kesehatan, buat penyimpanan data layanan kesehatan, dan impor data FHIR R4 ke penyimpanan data selama proses pembuatan aplikasi, lalu kueri data klinis.

Halaman ini menjelaskan metode kedua.

Tentang frekuensi impor data

Anda dapat mengimpor data FHIR R4 ke penyimpanan data dengan cara berikut:

• Impor batch: impor satu kali. Data diimpor ke penyimpanan data dalam batch. Untuk impor inkremental lebih lanjut, lihat Memuat ulang data kesehatan.

• Impor streaming: impor data streaming hampir real-time. Setiap perubahan inkremental di penyimpanan FHIR sumber disinkronkan di penyimpanan data Vertex AI Search. Streaming memerlukan konektor data, yang merupakan jenis penyimpanan data. Untuk membuat konektor data, Anda harus menyiapkan pengumpulan data. Konektor data berisi entitas, yang juga merupakan instance penyimpanan data.

  Anda juga dapat menjeda dan melanjutkan streaming serta melakukan sinkronisasi manual kapan pun diperlukan. Untuk mengetahui informasi selengkapnya, lihat Mengelola penyimpanan data penelusuran layanan kesehatan.

  Kecepatan streaming data untuk project Google Cloud tertentu bergantung pada kuota berikut. Jika melebihi kuota, Anda mungkin mengalami penundaan streaming.

  • Jumlah penulisan streaming FHIR atau BigQuery yang tertunda per menit. Untuk mengetahui informasi selengkapnya, lihat Kuota dan batas.
  • Jumlah operasi baca FHIR per menit per region. Untuk mengetahui informasi selengkapnya, lihat Kuota FHIR Cloud Healthcare API.

Anda dapat memilih frekuensi impor data pada saat pembuatan penyimpanan data dan Anda tidak dapat mengubah konfigurasi ini nanti.

Sebelum memulai

Sebelum membuat aplikasi penelusuran layanan kesehatan, pahami hal-hal berikut:

• Hubungan antara aplikasi dan penyimpanan data untuk penelusuran layanan kesehatan. Untuk mengetahui informasi selengkapnya, lihat Tentang aplikasi dan penyimpanan data.

• Persiapan data FHIR Anda untuk penyerapan.

• Vertex AI Search untuk layanan kesehatan hanya menyediakan layanan penelusuran di multi-region AS (us). Oleh karena itu, aplikasi penelusuran layanan kesehatan dan penyimpanan data Anda harus berada di multi-region us.

• Jika Anda mengimpor data layanan kesehatan dari penyimpanan FHIR Cloud Healthcare API di satu Google Cloud project ke penyimpanan data Vertex AI Search di project Google Cloud lain dan Anda menggunakan Kontrol Layanan VPC, kedua project harus berada di perimeter yang sama.

Buat aplikasi

Anda dapat membuat aplikasi penelusuran kesehatan di konsol Google Cloud atau menggunakan API. Untuk membuat aplikasi penelusuran layanan kesehatan, ikuti langkah-langkah berikut:

Izin yang diperlukan untuk langkah ini

Berikan peran Identity and Access Management (IAM) berikut ke akun layanan [e-mail] di project yang berisi penyimpanan data Aplikasi AI:

Tujuan	Peran
Untuk melakukan impor batch satu kali data FHIR dari penyimpanan FHIR di Cloud Healthcare API.	BigQuery Job User (roles/bigquery.jobUser) Editor data BigQuery (roles/bigquery.dataEditor) Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin)
Untuk melakukan impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API dalam project Google Cloud yang sama.	BigQuery Job User (roles/bigquery.jobUser) Editor data BigQuery (roles/bigquery.dataEditor) Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin) Healthcare FHIR Resource Reader (roles/healthcare.fhirResourceReader)
Untuk melakukan impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API dalam project Google Cloud yang berbeda.	BigQuery Job User (roles/bigquery.jobUser) Editor data BigQuery (roles/bigquery.dataEditor) Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin) Healthcare FHIR Resource Reader (roles/healthcare.fhirResourceReader)
Untuk mengimpor data FHIR yang mereferensikan file di Cloud Storage. Izin ini diberikan secara default jika file yang dirujuk berada di project Google Cloud yang sama dengan aplikasi AI.	Storage Object Admin (roles/storage.objectAdmin)
Untuk menyesuaikan skema saat membuat penyimpanan data guna mengonfigurasi kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan resource dan elemen FHIR.	Storage Object Admin (roles/storage.objectAdmin)

Berikan peran Identity and Access Management berikut ke akun layanan [e-mail] di project yang berisi penyimpanan data FHIR R4 Cloud Healthcare API:

Tujuan	Peran
Untuk melakukan impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API dalam project Google Cloud yang berbeda.	Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin) Healthcare FHIR Resource Reader (roles/healthcare.fhirResourceReader)

Berikan peran Identity and Access Management berikut ke akun layanan [e-mail] di project yang berisi penyimpanan data FHIR R4 Cloud Healthcare API:

Tujuan	Peran
Untuk melakukan impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API dalam project Google Cloud yang sama.	BigQuery Job User (roles/bigquery.jobUser) Editor data BigQuery (roles/bigquery.dataEditor)
Untuk menyesuaikan skema saat membuat penyimpanan data guna mengonfigurasi kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan resource dan elemen FHIR.	Storage Object Admin (roles/storage.objectAdmin)

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di halaman Aplikasi, klik Aplikasi baru.

3. Di halaman Create App, pada bagian Healthcare search, klik Create.

4. Di panel Konfigurasi aplikasi penelusuran, pilih Layanan kesehatan.

5. Untuk mengaktifkan fitur LLM lanjutan untuk aplikasi ini, klik tombol Fitur LLM lanjutan.

   Aktifkan fitur LLM lanjutan untuk mendapatkan ringkasan penelusuran, yang merupakan ringkasan singkat dari satu atau beberapa hasil penelusuran teratas.

   Saat Anda mengaktifkan fitur LLM, diperlukan waktu hingga lima menit agar fitur yang didukung tersedia.

6. Di kolom Your app name, masukkan nama untuk aplikasi Anda.

7. Di kolom External name of your company or organization, masukkan nama umum perusahaan atau organisasi Anda. Anda tidak perlu menyertakan akhiran seperti Inc. atau LLC. Kolom ini berguna bagi LLM untuk mengidentifikasi perusahaan yang diwakili oleh aplikasi.

8. Di bagian Transparansi Akses, pilih Nonaktifkan metrik penelusuran untuk aplikasi ini guna menonaktifkan metrik logging untuk aplikasi saat ini. Setelan ini tidak dapat diubah setelah aplikasi dibuat.

9. Klik Lanjutkan.

10. Untuk terhubung ke penyimpanan data, di halaman Data Stores, lakukan salah satu hal berikut:

    • Pilih penyimpanan data kesehatan yang ada untuk impor batch atau konektor data yang ada untuk impor streaming. Untuk membuat penyimpanan data atau konektor data sebelum membuat aplikasi, lihat Membuat penyimpanan data layanan kesehatan.
    • Buat penyimpanan data (untuk impor batch satu kali) atau konektor data, yang merupakan instance penyimpanan data (untuk impor streaming):
      1. Klik Buat penyimpanan data.
      2. Di panel Select a data source, pilih Healthcare API (FHIR) sebagai sumber data Anda.
      3. Untuk mengimpor data dari penyimpanan FHIR, lakukan salah satu hal berikut:
         • Pilih FHIR store dari daftar FHIR store yang tersedia:
           1. Perluas kolom FHIR store.
           2. Dalam daftar ini, pilih set data yang berada di lokasi yang diizinkan dan lalu pilih penyimpanan FHIR yang menggunakan FHIR versi R4.
         • Masukkan penyimpanan FHIR secara manual:
           1. Perluas kolom FHIR store.
           2. Klik Enter FHIR store manually.
           3. Dalam dialog FHIR store name, masukkan nama lengkap penyimpanan FHIR dalam format berikut:

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

           4. Klik Simpan.
      4. Di bagian Sinkronisasi, pilih salah satu opsi berikut. Pilihan ini tidak dapat diubah setelah penyimpanan data dibuat.
         • Satu kali: untuk melakukan impor data batch satu kali. Untuk impor inkremental selanjutnya, lihat Memuat ulang data kesehatan.
         • Streaming: untuk melakukan impor data streaming hampir real-time. Untuk mengalirkan data, Anda harus membuat konektor data, yang merupakan jenis penyimpanan data. Untuk menyiapkan penyimpanan data streaming menggunakan REST API, hubungi customer engineer Anda.
      5. Di bagian What is the schema for this data?, pilih salah satu opsi berikut:
         • Skema yang telah ditentukan Google: untuk mempertahankan konfigurasi skema yang ditentukan Google, seperti kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan, untuk elemen dan resource FHIR yang didukung. Setelah memilih opsi ini, Anda tidak dapat memperbarui skema setelah membuat penyimpanan data. Jika Anda ingin dapat mengubah skema setelah pembuatan penyimpanan data, pilih opsi Skema kustom.
           1. Klik Lanjutkan.
           2. Di kolom Nama penyimpanan data Anda, masukkan nama untuk penyimpanan data Anda.
           3. Klik Buat.

           Penyimpanan data yang Anda buat tercantum di halaman Data Stores.

         • Skema kustom: untuk menentukan konfigurasi skema Anda sendiri, seperti kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan, untuk elemen dan resource FHIR yang didukung. Untuk menyiapkan skema yang dapat dikonfigurasi, hubungi customer engineer Anda.
           1. Klik Lanjutkan.
           2. Tinjau skema, luaskan setiap kolom, dan edit setelan kolom.
           3. Klik Tambahkan kolom baru untuk menambahkan kolom baru pada resource FHIR yang didukung. Anda tidak dapat menghapus kolom yang disediakan dalam skema yang ditentukan Google.
           4. Klik Lanjutkan.
           5. Di kolom Nama konektor data Anda, masukkan nama untuk konektor data Anda.
           6. Klik Buat.

           Konektor data yang Anda buat akan tercantum di halaman Data Stores. Penyimpanan FHIR sumber ditambahkan sebagai entitas dalam konektor data.

      6. Klik Lanjutkan.
      7. Pilih penyimpanan data atau konektor data yang dibuat.

11. Opsional: Untuk melihat daftar penyimpanan data yang tidak tersedia, klik Pelajari alasannya.

    Tabel ditampilkan dengan daftar penyimpanan data dan alasan mengapa penyimpanan data tersebut tidak tersedia. Berikut beberapa alasan mengapa penyimpanan data mungkin tidak tersedia:

    • Jenis penyimpanan data Anda hanya memungkinkan koneksi ke satu aplikasi dan penyimpanan data sudah terhubung.
    • Penyimpanan data dan aplikasi Anda memiliki jenis yang berbeda. Misalnya, Anda tidak dapat menghubungkan penyimpanan data penelusuran situs ke aplikasi penelusuran layanan kesehatan.

12. Klik Buat.

    Jika aplikasi dan penyimpanan datanya berhasil dibuat, halaman detail penyimpanan data akan menampilkan detail data FHIR yang diimpor.

REST

1. Buat penyimpanan data layanan kesehatan dan impor data layanan kesehatan ke dalamnya.

2. Buat aplikasi penelusuran layanan kesehatan dan hubungkan ke penyimpanan data. Aplikasi penelusuran layanan kesehatan hanya dapat terhubung ke satu penyimpanan data, sedangkan satu penyimpanan data tertentu dapat terhubung ke beberapa aplikasi.

   Istilah Penting: Di Vertex AI Search, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks 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"]
       }
   }'
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • APP_ID: ID aplikasi Vertex AI Search yang ingin Anda buat.
   • APP_DISPLAY_NAME: nama tampilan aplikasi Vertex AI Search yang ingin Anda buat.
   • DATA_STORE_ID: ID penyimpanan data Vertex AI Search yang ada yang ingin Anda tambahkan ke aplikasi Vertex AI Search.
   • SEARCH_ADD_ON: kolom opsional untuk menentukan apakah Anda menginginkan fitur LLM lanjutan, seperti penelusuran dengan jawaban AI generatif, untuk aplikasi ini. Untuk mengaktifkan fitur LLM lanjutan, masukkan nilai SEARCH_ADD_ON_LLM. Jika Anda tidak menginginkan fitur LLM Lanjutan, tentukan SEARCH_ADD_ON_UNSPECIFIED atau hapus kolom searchAddOns. Untuk mengetahui informasi selengkapnya, lihat Fitur LLM lanjutan.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Jika nilai untuk kolom done adalah true, hal ini menunjukkan bahwa operasi untuk membuat aplikasi telah selesai. Jika false, operasi pembuatan aplikasi tidak berhasil.

   {
     "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"
     }
   }
   

Memverifikasi pembuatan aplikasi

Tugas ini menunjukkan cara memverifikasi apakah aplikasi penelusuran layanan kesehatan berhasil dibuat dan apakah data FHIR berhasil diimpor ke penyimpanan data.

• Di konsol Google Cloud : Pilih aplikasi dan verifikasi detailnya.
• Melalui REST API, gunakan metode engines.get untuk mendapatkan detail penyimpanan data kesehatan.

Untuk memverifikasi pembuatan penyimpanan data dan impor data, selesaikan langkah-langkah berikut.

Konsol

1. Di konsol Google Cloud , buka halaman AI Applications.

   Aplikasi AI

2. Di halaman Aplikasi, verifikasi apakah aplikasi yang Anda buat ada dalam daftar aplikasi.

3. Verifikasi bahwa penyimpanan data yang Anda hubungkan ke aplikasi tercantum dalam tabel Penyimpanan data yang terhubung.

4. Pilih penyimpanan data dan verifikasi detail penyimpanan data.

REST

1. Verifikasi pembuatan aplikasi.

   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"
   

   Ganti kode berikut:

   • PROJECT_ID: ID Google Cloud project Anda.
   • APP_ID: ID aplikasi Vertex AI Search.

   Respons

   Anda akan menerima respons JSON yang mirip dengan berikut ini. Respons berisi detail aplikasi yang dibuat.

   {
     "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. Verifikasi pembuatan penyimpanan data dan impor data FHIR.

Langkah berikutnya

• Telusuri data layanan kesehatan di aplikasi penelusuran layanan kesehatan Anda.
• Perbarui data layanan kesehatan.