סינון חיפושים בתחום הבריאות

הוצאה משימוש: התכונה 'חיפוש מבוסס סוכנים' בתחום שירותי הבריאות הוצאה משימוש ולא תהיה זמינה אחרי 15 במאי 2027.

זהירות:

• הגבלות בתחום הבריאות: כלקוחות, אסור לכם להשתמש בשירותי ה-AI הגנרטיבי למטרות קליניות (למען הבהרה, מחקר לא קליני, תזמון או משימות אדמיניסטרטיביות אחרות לא מוגבלים), כתחליף לייעוץ רפואי מקצועי או בכל אופן אחר שנמצא בפיקוח של רשות רגולטורית רלוונטית או שדורש אישור ממנה. כמו כן, אסור לכם לאפשר למשתמשי הקצה לעשות זאת. מידע נוסף זמין במאמר תנאים ספציפיים לשירות.

  לשם הבהרה, בנוגע לשימוש בחיפוש מבוסס סוכנים כדי לאחזר ולסכם מידע רפואי קיים, ההגבלה על השימוש למטרות קליניות פירושה הגבלה על השימוש למטרות אבחון או טיפול ישירים ללא בדיקה על ידי איש מקצוע מורשה בהתאם לחוקים ולתקנות הרלוונטיים.

• הפלט שנוצר לא תמיד אמין לחלוטין. בגלל האופי של מודלים גדולים של שפה (LLM) ו-AI גנרטיבי, יכול להיות שהפלט יכלול מידע שגוי או מוטה (למשל, סטריאוטיפים או תוכן פוגעני אחר), ולכן צריך לבדוק אותו. כל הסיכומים או התשובות הם טיוטות ולא סופיים.
• השימוש המיועד במוצר הזה הוא לא לספק מידע שקשור למניעה, לאבחון או לטיפול במחלות. המוצר לא נועד לתת מענה לשאלות בנוגע להמלצות על אבחון או טיפול. השימוש המיועד במוצר הזה הוא לאחזר ולסכם מידע רפואי קיים שסופק על ידי משתמשים.
• בגלל נתוני בדיקה מוגבלים, יכול להיות שהמוצר הזה לא מתאים לקבוצת הגיל 0-18 ולקבוצת הגיל 85 ומעלה. לכן, כשבודקים את הפלט שנוצר, הלקוחות צריכים להביא בחשבון את מידת הייצוג של אוכלוסיות משנה בנתוני המקור שלהם.

כשמבצעים שאילתות על נתונים של שירותי בריאות, אפשר להשתמש במסננים כדי לדייק את התשובות לחיפוש. בבקשת חיפוש, אפשר לספק מסננים כדי לאכוף קריטריונים שכוללים או מחריגים תשובות חיפוש מסוימות.

לדוגמה, כשמחפשים נתונים של מטופל אחד, גוף בקשת החיפוש צריך להכיל את ביטוי הסינון הבא שמציין את מזהה המטופל:

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

בדף הזה מוסבר איך מגדירים מסננים לחיפוש בתחום הבריאות.

לפני שמתחילים

לפני שמתחילים, צריך לבצע את הפעולות הבאות:

• יוצרים אפליקציה לחיפוש נתונים בתחום הבריאות ומאגר נתונים לחיפוש בתחום הבריאות, ומייבאים נתוני FHIR R4. מידע נוסף מופיע במאמרים יצירת אפליקציה לחיפוש מידע בתחום הבריאות ויצירת מאגר נתונים לחיפוש מידע בתחום הבריאות.
• מעיינים ברשימת משאבי FHIR R4 שחיפוש מבוסס סוכנים תומך בהם כשדות שאפשר להוסיף לאינדקס, לחפש ולאחזר. מידע נוסף זמין במאמר הפניה לסכימת נתונים של FHIR R4 בתחום הבריאות.
• הסבר על התחביר של ביטוי הסינון

הגדרת מסננים

המסננים מצוינים בשדה filter בגוף הבקשה של השיטה servingConfigs.search.

הגדרת המסנן מתבצעת לפי תחביר ביטוי הסינון. בביטוי המסנן, המחרוזת יכולה להיות כל שדה שאפשר להוסיף לאינדקס מהתגובה לשאילתת החיפוש. לדוגמה, אם התשובה מכילה משאב Observation, אפשר להשתמש ב-patient_id שאליו מפנה משאב ה-Observation כמסנן מילולי.

בקטעים הבאים מוצגות כמה דוגמאות לאופן שבו אפשר ליצור מסננים.

הגדרת מסנן resource_datetime

בדוגמה הזו מוסבר איך לציין מסנן לחיפוש שכולל רק את המשאבים שבהם הערך של resource_datetime מאוחר יותר מהתאריך ומהשעה שצוינו.

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}}
}'

מחליפים את מה שכתוב בשדות הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫DATA_STORE_ID: המזהה של מאגר הנתונים של חיפוש מבוסס סוכנים.
• ‫QUERY: שאילתת החיפוש.
• ‫PATIENT_ID: מזהה המשאב של המטופל שאת הנתונים שלו רוצים לחפש.
• ‫DATE_TIME_VALUE: הערך של השדה resource_datetime שמייצג תאריך ושעה בפורמט dateTime של FHIR. דוגמאות לערכים בשדה הזה:
  • כדי לציין תאריך ושעה עם אזור זמן שמופרדים באמצעות המפריד T: 2022-08-05T01:00:00+00:00
  • כדי לציין תאריך: 2022-08-05
  • כדי לציין חודש: 2022-08
  • כדי לציין שנה: 2022

תשובה

אתם אמורים לקבל תגובת JSON שדומה לתגובה הבאה (התגובה קוצרה). התשובה מכילה תוצאות חיפוש מפורטות שמופיעות בסדר כרונולוגי הפוך עם תקצירים, אם יש תקצירים. השדה structData מכיל את נתוני ה-JSON המובְנים של המסמך.

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

הגדרת מסנן של סוג משאב

בדוגמה הבאה מוצג אופן הבנייה של מסנן שמשתמש באופרטור AND כדי לסנן קודם את כל משאבי ה-Composition, ואז לסנן את אלה שהתאריך שלהם מאוחר יותר מתאריך ושעה שצוינו.

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

הגדרת מסנן משאבי FHIR

אתם יכולים להשתמש במסנן כדי לבדוק אם משאב FHIR קיים במאגר הנתונים של חיפוש מבוסס סוכנים. לדוגמה, אפשר לחפש משאב DocumentReference עם המזהה 6112d1ac-c6bd-4755-d689-bfb71d59afc5 באמצעות המסנן הבא.

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