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.
- 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. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi penelusuran layanan kesehatan.
Halaman ini menjelaskan metode pertama.
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 penyimpanan data layanan kesehatan dan mengimpor data ke dalamnya, selesaikan persyaratan berikut:
Pahami hubungan antara aplikasi dan penyimpanan data untuk penelusuran layanan kesehatan. Untuk informasi selengkapnya, lihat Tentang aplikasi dan penyimpanan data.
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 wilayahus
.
Membuat penyimpanan data
Anda dapat membuat penyimpanan data 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 penyimpanan data penelusuran layanan kesehatan. 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.
- Melalui REST API: Anda dapat mengimpor data FHIR dari penyimpanan FHIR Cloud Healthcare API
yang berada di project Google Cloud yang sama atau yang berbeda.
- Gunakan metode
dataStores.create
untuk membuat penyimpanan data layanan kesehatan. - Gunakan metode
documents.import
untuk menentukan penyimpanan FHIR di Cloud Healthcare API dan mengimpor data FHIR R4.
- Gunakan metode
Untuk membuat penyimpanan data layanan kesehatan, selesaikan langkah-langkah berikut.
Konsol
Di konsol Google Cloud, buka halaman Agent Builder.
Di menu navigasi, klik Penyimpanan Data.
Klik add_box Create data store.
- Di panel Select a data source, pilih Healthcare API (FHIR) sebagai sumber data Anda.
- Untuk mengimpor data dari penyimpanan FHIR, lakukan salah satu tindakan berikut:
- Pilih penyimpanan FHIR dari daftar penyimpanan FHIR yang tersedia:
- Luaskan kolom Penyimpanan FHIR.
- 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:
- Luaskan kolom Penyimpanan FHIR.
- Klik Enter FHIR store manually.
- 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
- Klik Simpan.
- Pilih penyimpanan FHIR dari daftar penyimpanan FHIR yang tersedia:
- 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.
- 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).
- Klik Lanjutkan.
- Di kolom Nama penyimpanan data Anda, masukkan nama untuk penyimpanan data Anda.
- Klik Create.
Penyimpanan data yang Anda buat tercantum di halaman Penyimpanan Data.
- Skema kustom (Pratinjau): untuk menentukan konfigurasi skema Anda sendiri, seperti
kemampuan pengindeksan, penelusuran, dan pengambilan, untuk resource dan elemen
FHIR yang didukung. Ini adalah fitur Pratinjau. Untuk menyiapkan skema yang dapat dikonfigurasi, hubungi customer engineer Anda.
- Klik Lanjutkan.
- Tinjau skema, luaskan setiap kolom, dan edit setelan kolom.
- 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.
- Klik Lanjutkan.
- Di kolom Nama konektor data Anda, masukkan nama untuk konektor data Anda.
- Klik Create.
Konektor data yang Anda buat tercantum di halaman Penyimpanan Data. Penyimpanan FHIR sumber ditambahkan sebagai entity dalam konektor data.
- 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).
- Klik Lanjutkan.
REST
Buat penyimpanan data.
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/dataStores?dataStoreId=DATA_STORE_ID" \ -d '{ "displayName": "DATA_STORE_DISPLAY_NAME", "industryVertical": "HEALTHCARE_FHIR", "solutionTypes": ["SOLUTION_TYPE_SEARCH"], "searchTier": "STANDARD", "searchAddOns": ["LLM"] }'
Ganti kode berikut:
PROJECT_ID
: ID project Google Cloud Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search yang ingin Anda buat. ID ini hanya boleh berisi huruf kecil, angka, garis bawah, dan tanda hubung.DATA_STORE_DISPLAY_NAME
: nama tampilan penyimpanan data Vertex AI Search yang ingin Anda buat.
Jika penyimpanan FHIR sumber dan penyimpanan data Vertex AI Search target berada di project Google Cloud yang sama, panggil metode berikut untuk melakukan impor batch satu kali. Jika tidak berada dalam project yang sama, lanjutkan ke langkah berikutnya.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_ID" \ "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/dataStores/DATA_STORE_ID/branches/0/documents:import" \ -d '{ "reconciliation_mode": "FULL", "fhir_store_source": {"fhir_store": "projects/PROJECT_ID/locations/CLOUD_HEALTHCARE_DATASET_LOCATION/datasets/CLOUD_HEALTHCARE_DATASET_ID/fhirStores/FHIR_STORE_ID"} }'
Ganti kode berikut:
PROJECT_ID
: ID project Google Cloud Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.CLOUD_HEALTHCARE_DATASET_ID
: ID set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.CLOUD_HEALTHCARE_DATASET_LOCATION
: lokasi set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.FHIR_STORE_ID
: ID penyimpanan FHIR R4 Cloud Healthcare API.
Jika penyimpanan FHIR sumber dan penyimpanan data Vertex AI Search target berada di project Google Cloud yang berbeda, panggil metode berikut untuk melakukan impor batch satu kali. Jika keduanya berada dalam project yang sama, kembali ke langkah sebelumnya.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: TARGET_PROJECT_ID" \ "https://us-discoveryengine.googleapis.com/v1alpha/projects/TARGET_PROJECT_ID/locations/us/dataStores/DATA_STORE_ID/branches/0/documents:import" \ -d '{ "reconciliation_mode": "FULL", "fhir_store_source": {"fhir_store": "projects/SOURCE_PROJECT_ID/locations/CLOUD_HEALTHCARE_DATASET_LOCATION/datasets/CLOUD_HEALTHCARE_DATASET_ID/fhirStores/FHIR_STORE_ID"} }'
Ganti kode berikut:
TARGET_PROJECT_ID
: project ID Google Cloud yang berisi penyimpanan data Vertex AI Search.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.SOURCE_PROJECT_ID
: ID project Google Cloud yang berisi set data Cloud Healthcare API dan penyimpanan FHIR.CLOUD_HEALTHCARE_DATASET_ID
: ID set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.CLOUD_HEALTHCARE_DATASET_LOCATION
: Lokasi set data Cloud Healthcare API yang berisi penyimpanan FHIR sumber.FHIR_STORE_ID
: ID penyimpanan FHIR R4 Cloud Healthcare API.
Opsional: Untuk menyiapkan impor data streaming (Pratinjau) menggunakan REST API, hubungi teknisi pelanggan Anda.
Python
Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Python Vertex AI Agent Builder.
Untuk melakukan autentikasi ke Vertex AI Agent Builder, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.
Membuat penyimpanan data
Mengimpor dokumen
Memverifikasi pembuatan penyimpanan data dan impor data FHIR
Tugas ini menunjukkan cara memverifikasi apakah penyimpanan data berhasil dibuat dan apakah data FHIR berhasil diimpor ke penyimpanan data.
- Di konsol Google Cloud: Pilih penyimpanan data dan verifikasi detailnya.
- Melalui REST API:
- Gunakan metode
dataStores.get
untuk mendapatkan detail penyimpanan data perawatan kesehatan. - Gunakan metode
operations.get
untuk mendapatkan detail operasi impor.
- Gunakan metode
Untuk memverifikasi pembuatan penyimpanan data dan impor data, selesaikan langkah-langkah berikut.
Konsol
Di konsol Google Cloud, buka halaman Agent Builder.
Di menu navigasi, klik Penyimpanan Data.
Halaman Penyimpanan Data menampilkan daftar penyimpanan data di project Google Cloud Anda dengan detailnya.
Verifikasi apakah penyimpanan data atau konektor data yang Anda buat ada dalam daftar penyimpanan data.
Pilih penyimpanan data atau konektor data dan verifikasi detailnya.
- Untuk penyimpanan data:
- Tabel ringkasan mencantumkan detail berikut:
- ID, jenis, dan region penyimpanan data.
- Jumlah dokumen yang menunjukkan jumlah resource FHIR yang diimpor.
- Stempel waktu saat dokumen terakhir diimpor.
- Atau, klik Lihat detail untuk melihat detail impor dokumen, seperti detail tentang impor yang berhasil, sebagian, atau gagal.
- Tab Documents mencantumkan ID resource dari resource FHIR yang diimpor dan jenis resource-nya dalam tabel yang diberi nomor halaman. Anda dapat memfilter tabel ini untuk memverifikasi apakah resource tertentu telah diimpor.
- Tab Aktivitas mencantumkan detail impor dokumen, seperti detail tentang impor yang berhasil, sebagian, atau gagal.
- Tabel ringkasan mencantumkan detail berikut:
- Untuk konektor data:
- Tabel ringkasan mencantumkan detail berikut:
- ID, jenis, dan wilayah koleksi.
- Nama aplikasi yang terhubung.
- Status konektor, yang aktif atau dijeda.
- Tabel Entities menampilkan entity dalam konektor data.
Nama entity adalah nama penyimpanan FHIR sumber. ID entitas adalah
ID konektor data yang ditambahkan dengan nama penyimpanan FHIR sumber.
- Klik nama entity untuk melihat detailnya. Karena entity adalah instance penyimpanan data dalam konektor data, detail entity sama dengan detail penyimpanan data.
- Tabel ringkasan mencantumkan detail berikut:
- Untuk penyimpanan data:
Di tab Schema, lihat properti untuk resource dan elemen FHIR yang didukung. Klik Edit untuk mengonfigurasi skema. Ini adalah fitur pratinjau Pribadi. Untuk menyiapkan skema yang dapat dikonfigurasi, hubungi customer engineer Anda.
REST
Verifikasi pembuatan penyimpanan data.
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/dataStores/DATA_STORE_ID"
Ganti kode berikut:
PROJECT_ID
: ID project Google Cloud Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.
Verifikasi apakah operasi impor data FHIR sudah selesai.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/IMPORT_OPERATION_ID"
Ganti kode berikut:
PROJECT_ID
: ID project Google Cloud Anda.DATA_STORE_ID
: ID penyimpanan data Vertex AI Search.IMPORT_OPERATION_ID
: ID operasi dari operasi yang berjalan lama yang ditampilkan saat Anda memanggil metodeimport
Langkah selanjutnya
- Buat aplikasi penelusuran layanan kesehatan dan hubungkan penyimpanan data Anda ke aplikasi tersebut.
- Telusuri data layanan kesehatan di aplikasi penelusuran layanan kesehatan Anda.
- Perbarui data layanan kesehatan.