Membuat aplikasi penelusuran layanan kesehatan

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 buat kueri data klinis. Untuk mengetahui informasi selengkapnya, lihat Membuat penyimpanan data layanan kesehatan.
  • Buat aplikasi penelusuran layanan kesehatan, buat penyimpanan data layanan kesehatan, dan impor data FHIR R4 ke dalam penyimpanan data selama proses pembuatan aplikasi, lalu buat 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. Untuk impor inkremental lebih lanjut, lihat Memperbarui data layanan kesehatan.

  • Impor streaming (Pratinjau): 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 yang berisi entity. Entity juga merupakan instance penyimpanan data.

    Kecepatan streaming data untuk project Google Cloud tertentu bergantung pada kuota berikut. Jika melebihi kuota, Anda mungkin akan 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.

Impor streaming tersedia untuk semua resource yang didukung Vertex AI Search. Untuk mengetahui informasi selengkapnya, lihat Referensi skema data FHIR R4 Layanan kesehatan.

Sebelum memulai

Sebelum membuat aplikasi penelusuran layanan kesehatan, selesaikan persyaratan berikut:

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

  • Siapkan data FHIR untuk penyerapan.

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

Buat aplikasi

Anda dapat membuat aplikasi penelusuran layanan kesehatan di konsol Google Cloud atau menggunakan API. Kedua pendekatan tersebut berbeda dalam hal berikut:

  • Di konsol Google Cloud: Pilih penyimpanan FHIR sumber di Cloud Healthcare API dan impor data FHIR sebagai bagian dari proses pembuatan aplikasi penelusuran layanan kesehatan. Untuk melakukan streaming data FHIR (Pratinjau), penyimpanan FHIR sumber Anda harus berada di project Google Cloud yang sama dengan aplikasi Vertex AI Search tujuan.
  • Melalui REST API: Anda dapat mengimpor data FHIR dari penyimpanan FHIR Cloud Healthcare API. Penyimpanan FHIR dapat berada di project Google Cloud yang sama atau berbeda.
    1. Gunakan metode dataStores.create untuk membuat penyimpanan data layanan kesehatan.
    2. Gunakan metode documents.import untuk menentukan penyimpanan FHIR di Cloud Healthcare API dan mengimpor data FHIR.
    3. Gunakan metode engines.create untuk membuat aplikasi penelusuran layanan kesehatan dan menentukan penyimpanan data layanan kesehatan yang ada.

Untuk membuat aplikasi penelusuran layanan kesehatan, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud, buka halaman Agent Builder.

    Agent Builder

  2. Di halaman Aplikasi, klik Aplikasi baru.

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

  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, mungkin perlu waktu hingga lima menit agar fitur yang didukung tersedia.

  6. Di kolom Nama aplikasi Anda, masukkan nama untuk aplikasi Anda.

  7. Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama umum untuk perusahaan atau organisasi Anda. Anda tidak perlu menyertakan akhiran seperti Inc atau LLC. Kolom ini berguna bagi LLM untuk mengidentifikasi perusahaan yang diwakili aplikasi.

  8. Klik Lanjutkan.

  9. Untuk terhubung ke penyimpanan data, di halaman Penyimpanan Data, lakukan salah satu tindakan berikut:

    • Pilih penyimpanan data layanan 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 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, lakukan salah satu tindakan berikut:
        • Pilih penyimpanan FHIR dari daftar penyimpanan FHIR yang tersedia:
          1. Luaskan kolom Penyimpanan FHIR.
          2. Dalam daftar ini, pilih set data yang berada di lokasi yang diizinkan, lalu pilih penyimpanan FHIR yang menggunakan FHIR versi R4.

            Untuk melakukan streaming data FHIR (Pratinjau), penyimpanan FHIR sumber Anda harus berada di project Google Cloud yang sama dengan penyimpanan data Vertex AI Search tujuan.

        • Masukkan penyimpanan FHIR secara manual:
          1. Luaskan kolom Penyimpanan FHIR.
          2. Klik Enter FHIR store manually.
          3. Pada dialog Nama penyimpanan FHIR, 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 lebih lanjut, lihat Memuat ulang data layanan kesehatan.
        • Streaming: untuk melakukan impor data streaming mendekati real-time. Untuk melakukan streaming data, Anda harus membuat konektor data, yang merupakan jenis penyimpanan data. Ini adalah fitur Pratinjau. Untuk menyiapkan penyimpanan data streaming menggunakan REST API, hubungi engineer pelanggan Anda.
      5. Di bagian Apa skema untuk data ini?, pilih salah satu opsi berikut:
        • Skema standar Google: untuk mempertahankan konfigurasi skema yang ditentukan Google, seperti kemampuan pengindeksan, penelusuran, dan 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 Skema kustom (Pratinjau).
          1. Klik Lanjutkan.
          2. Di kolom Nama penyimpanan data Anda, masukkan nama untuk penyimpanan data Anda.
          3. Klik Create.

            4. Penyimpanan data yang Anda buat tercantum di halaman Penyimpanan Data.

        • Skema kustom (Pratinjau): untuk menentukan konfigurasi skema Anda sendiri, seperti kemampuan pengindeksan, kemampuan penelusuran, dan kemampuan pengambilan, untuk resource dan elemen FHIR yang didukung. Ini adalah fitur Pratinjau. 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 di 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 Create.

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

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

  10. 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 penyimpanan data mungkin tidak tersedia:

    • Jenis penyimpanan data Anda hanya mengizinkan 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.

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

    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/v1alpha/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 Google Cloud 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 informasi selengkapnya, lihat Fitur LLM lanjutan.

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 layanan kesehatan.

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

Konsol

  1. Di konsol Google Cloud, buka halaman Agent Builder.

    Agent Builder

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

  3. Pastikan penyimpanan data yang Anda hubungkan ke aplikasi tercantum di kolom 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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Ganti kode berikut:

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

  2. Verifikasi pembuatan penyimpanan data dan impor data FHIR.

Langkah selanjutnya