Memfilter penelusuran perawatan kesehatan

Perhatian:

• Pembatasan untuk layanan kesehatan: Sebagai pelanggan, Anda tidak akan, dan tidak akan mengizinkan Pengguna Akhir, menggunakan Layanan AI Generatif untuk tujuan klinis (untuk kejelasan, 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 peraturan yang berlaku. Untuk mengetahui informasi selengkapnya, lihat Persyaratan Khusus Layanan.

  Untuk memperjelas, sehubungan dengan penggunaan Vertex AI Search untuk mengambil dan merumuskan informasi medis yang ada, batasan penggunaan untuk tujuan klinik berarti batasan penggunaan untuk tujuan diagnosis atau pengobatan langsung tanpa peninjauan 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 diagnosis atau rekomendasi pengobatan tidak dimaksudkan untuk ditangani oleh produk. Tujuan penggunaan produk ini adalah 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 grup usia 0-18 tahun 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.

Saat membuat kueri data layanan kesehatan, Anda dapat menggunakan filter untuk menyaring respons penelusuran. Dalam permintaan penelusuran, Anda dapat memberikan filter untuk menerapkan kriteria yang menyertakan atau mengecualikan respons penelusuran tertentu.

Misalnya, saat Anda menelusuri data satu pasien, isi permintaan penelusuran harus berisi ekspresi filter berikut yang menentukan ID pasien:

"filter": "patient_id: ANY(\"PATIENT_ID\")"

Halaman ini menunjukkan cara menentukan filter untuk penelusuran layanan kesehatan.

Sebelum memulai

Sebelum memulai, lakukan hal berikut:

• Buat aplikasi penelusuran layanan kesehatan dan penyimpanan data penelusuran layanan kesehatan, lalu impor data FHIR R4. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi penelusuran layanan kesehatan dan Membuat penyimpanan data penelusuran layanan kesehatan.
• Tinjau daftar resource FHIR R4 yang didukung Vertex AI Search sebagai kolom yang dapat diindeks, ditelusuri, dan diambil. Untuk mengetahui informasi selengkapnya, lihat Referensi skema data FHIR R4 Layanan kesehatan.
• Pahami sintaksis ekspresi filter.

Menentukan filter

Filter ditentukan di kolom filter dalam isi permintaan metode servingConfigs.search.

Definisi filter mengikuti sintaksis ekspresi filter. Dalam ekspresi filter, literal dapat berupa kolom yang dapat diindeks dari respons terhadap kueri penelusuran. Misalnya, jika respons berisi resource Observation, patient_id yang dirujuk oleh resource Observation dapat digunakan sebagai literal filter.

Bagian berikut menunjukkan beberapa contoh cara membuat filter.

Menentukan filter resource_datetime

Contoh ini menunjukkan cara menentukan filter untuk penelusuran yang hanya menyertakan resource yang memiliki nilai resource_datetime setelah nilai tanggal dan waktu yang ditentukan.

REST

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

Ganti kode berikut:

• PROJECT_ID: ID project Google Cloud Anda.
• DATA_STORE_ID: ID penyimpanan data Vertex AI Search.
• QUERY: kueri penelusuran.
• PATIENT_ID: ID resource pasien yang datanya ingin Anda telusuri.
• DATE_TIME_VALUE: nilai kolom resource_datetime yang mewakili tanggal dan waktu dalam format dateTime FHIR. Beberapa contoh kolom ini adalah sebagai berikut:
  • Untuk menentukan tanggal dan waktu dengan zona waktu yang dipisahkan oleh pemisah T: 2022-08-05T01:00:00+00:00
  • Untuk menentukan tanggal: 2022-08-05
  • Untuk menentukan bulan: 2022-08
  • Untuk menentukan tahun: 2022

Respons

Anda akan menerima respons JSON yang mirip dengan respons yang terpotong berikut. Respons berisi hasil penelusuran terperinci yang tercantum dalam urutan kronologis terbalik dengan cuplikan, jika cuplikan tersedia. Kolom structData berisi data JSON terstruktur untuk dokumen.

{
    "results": [
    {
        "id": "DOCUMENT_ID",
        "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
            ...
            "resource_type": "FHIR_RESOURCE_TYPE",
            "resource_datetime": "RESOURCE_DATETIME",
            "patient_id": "PATIENT_ID",
            "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
            "snippets": [
            {
                "snippet": "SNIPPET_TEXT",
                "snippet_status": "SUCCESS"
            }
            ]
        }
        }
    }]
}

Menentukan filter jenis resource

Contoh berikut menunjukkan cara membuat filter yang menggunakan operator AND untuk memfilter semua resource Komposisi terlebih dahulu, lalu memfilter resource yang tanggalnya lebih lambat dari tanggal dan waktu yang ditentukan.

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

Menentukan filter resource FHIR

Anda dapat menggunakan filter untuk memeriksa apakah resource FHIR ada di penyimpanan data Vertex AI Search. Misalnya, Anda dapat menelusuri resource DocumentReference yang memiliki ID 6112d1ac-c6bd-4755-d689-bfb71d59afc5 menggunakan filter berikut.

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"