Membuat aplikasi penelusuran layanan kesehatan

Tidak digunakan lagi: Agent Search untuk layanan kesehatan tidak digunakan lagi dan tidak akan tersedia setelah 15 Mei 2027.

Perhatian:

• Pembatasan 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 saran medis profesional, atau dengan cara apa pun yang diawasi oleh atau memerlukan izin atau persetujuan dari otoritas pengatur yang berlaku. Untuk mengetahui informasi selengkapnya, lihat Persyaratan Khusus Layanan.

  Agar lebih jelas, terkait penggunaan Agent Search untuk mengambil dan meringkas informasi medis yang ada, pembatasan penggunaan untuk tujuan klinis berarti pembatasan penggunaan untuk tujuan diagnosis atau perawatan langsung tanpa ditinjau oleh profesional berlisensi yang mematuhi 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, stereotip atau konten berbahaya lainnya) dan harus ditinjau. Semua ringkasan atau jawaban harus dianggap sebagai draf dan bukan final.
• Penggunaan produk ini tidak dimaksudkan untuk memberikan informasi terkait pencegahan, diagnosis, atau pengobatan penyakit. Pertanyaan terkait rekomendasi diagnosis atau pengobatan tidak dimaksudkan untuk dijawab oleh produk ini. Penggunaan produk ini dimaksudkan untuk mengambil dan meringkas informasi medis yang ada yang diberikan oleh pengguna.
• Karena data pengujian yang terbatas, produk ini mungkin atau mungkin tidak berlaku untuk kelompok usia 0-18 tahun dan untuk kelompok 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 Agent Search, Anda dapat mengikuti salah satu alur kerja berikut:

• Membuat penyimpanan data layanan kesehatan, mengimpor data FHIR R4 ke penyimpanan data, menghubungkannya ke aplikasi penelusuran layanan kesehatan, dan membuat kueri data klinis. Untuk mengetahui informasi selengkapnya, lihat Membuat penyimpanan data layanan kesehatan.
• Membuat aplikasi penelusuran layanan kesehatan, membuat penyimpanan data layanan kesehatan dan mengimpor data FHIR R4 ke penyimpanan data selama proses pembuatan aplikasi, dan membuat 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 Memperbarui data layanan kesehatan.

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

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

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

  • Jumlah penulisan streaming FHIR atau BigQuery yang tertunda per menit. Untuk mengetahui informasi selengkapnya, silakan melihat 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 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.

• Agent 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 one Google Cloud project ke penyimpanan data Agent Search di different Google Cloud project dan Anda menggunakan VPC Service Controls, kedua projects harus berada di perimeteryang sama.

Membuat aplikasi

Anda dapat membuat aplikasi penelusuran layanan kesehatan di Google Cloud konsol 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 [e-mail] akun layanan di project yang berisi penyimpanan data Agent Search:

Tujuan	Peran
Untuk melakukan impor batch data FHIR satu kali dari penyimpanan FHIR di Cloud Healthcare API.	BigQuery Job User (roles/bigquery.jobUser) BigQuery Data Editor (roles/bigquery.dataEditor) Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin)
Untuk melakukan impor streaming data FHIR dari penyimpanan FHIR di Cloud Healthcare API di project yang sama Google Cloud .	BigQuery Job User (roles/bigquery.jobUser) BigQuery Data Editor (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 di project yang berbeda Google Cloud .	BigQuery Job User (roles/bigquery.jobUser) BigQuery Data Editor (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 direferensikan berada di project yang sama dengan aplikasi Agent Search. Google Cloud	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 [e-mail] akun layanan 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 di project yang berbeda Google Cloud .	Healthcare FHIR Store Administrator (roles/healthcare.fhirStoreAdmin) Healthcare FHIR Resource Reader (roles/healthcare.fhirResourceReader)

Berikan peran Identity and Access Management berikut ke [e-mail] akun layanan 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 di project yang sama Google Cloud .	BigQuery Job User (roles/bigquery.jobUser) BigQuery Data Editor (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 Google Cloud konsol, buka halaman AI Applications.

   AI Applications

2. Di halaman Apps, klik New app.

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

4. Di panel Search app configuration, pilih Healthcare.

5. Untuk mengaktifkan respons generatif yang menggunakan fitur LLM lanjutan untuk aplikasi ini, klik tombol Generative responses ke posisi aktif.

   Saat Anda mengaktifkan respons generatif, fitur yang didukung mungkin memerlukan waktu hingga lima menit untuk 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 untuk perusahaan atau organisasi Anda. Anda tidak perlu menyertakan akhiran seperti Inc atau LLC. Kolom ini berguna agar LLM dapat mengidentifikasi perusahaan yang diwakili oleh aplikasi.

8. Di bagian Access Transparency, pilih Disable search metrics for this app untuk menonaktifkan metrik logging untuk aplikasi saat ini. Setelan ini tidak dapat diubah setelah aplikasi dibuat.

9. Klik Continue.

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

    • Pilih penyimpanan data layanan kesehatan yang ada untuk impor batch atau konektor data yang ada untuk impor streaming. Untuk membuat penyimpanan data atau a 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 Create data store.
      2. Di panel Select a data source, pilih Healthcare API (FHIR) sebagai sumber data Anda.
      3. Untuk mengimpor data dari penyimpanan FHIR Anda, lakukan salah satu hal berikut:
         • Pilih penyimpanan FHIR dari daftar penyimpanan FHIR yang tersedia:
           1. Luaskan 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. Luaskan kolom FHIR store.
           2. Klik Enter FHIR store manually.
           3. Di 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 Save.
      4. Di bagian Synchronization, 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 lebih lanjut, lihat Memperbarui data layanan kesehatan.
         • Streaming: untuk melakukan impor data streaming hampir real-time. Untuk melakukan streaming 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 ditentukan Google: untuk mempertahankan konfigurasi skema yang ditentukan Google, seperti kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan, untuk resource dan elemen 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 Custom schema.
           1. Klik Continue.
           2. Di kolom Your data store name, masukkan nama untuk penyimpanan data Anda.
           3. Klik Create.

           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 resource dan elemen FHIR yang didukung. Untuk menyiapkan skema yang dapat dikonfigurasi, hubungi customer engineer Anda.
           1. Klik Continue.
           2. Tinjau skema, luaskan setiap kolom, dan edit setelan kolom.
           3. Klik Add new fields untuk menambahkan kolom baru pada resource FHIR yang didukung. Anda tidak dapat menghapus kolom yang disediakan dalam skema yang ditentukan Google.
           4. Klik Continue.
           5. Di kolom Your data connector name, masukkan nama untuk konektor data Anda.
           6. Klik Create.

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

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

11. Opsional: Untuk melihat daftar penyimpanan data yang tidak tersedia, klik Learn why.

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

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

12. Klik Create.

    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. Sebuah aplikasi penelusuran layanan kesehatan hanya dapat terhubung ke satu penyimpanan data, sedangkan sebuah penyimpanan data dapat terhubung ke beberapa aplikasi.

   Istilah Penting: Di Agent 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 project Anda. Google Cloud
   • APP_ID: ID aplikasi Agent Search yang ingin Anda buat.
   • APP_DISPLAY_NAME: nama tampilan aplikasi Agent Search yang ingin Anda buat.
   • DATA_STORE_ID: ID penyimpanan data Agent Search yang ada yang ingin Anda tambahkan ke aplikasi Agent 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 Google Cloud konsol: Pilih aplikasi dan verifikasi detailnya.
• Melalui REST API, gunakan metode engines.get untuk mendapatkan detail penyimpanan data layanan kesehatan.

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

Konsol

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

   AI Applications

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

3. Verifikasi bahwa penyimpanan data yang Anda hubungkan ke aplikasi tercantum dalam tabel Connected data stores.

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 project Anda. Google Cloud
   • APP_ID: ID aplikasi Agent 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.