יצירת אפליקציית חיפוש בתחום הבריאות

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

זהירות:

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

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

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

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

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

בדף הזה מתוארת השיטה השנייה.

מידע על תדירות ייבוא הנתונים

אפשר לייבא נתוני FHIR R4 למאגר נתונים בדרכים הבאות:

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

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

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

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

  • מספר הכתיבות בסטרימינג של FHIR או BigQuery שממתינות בכל דקה. מידע נוסף זמין במאמר מכסות ומגבלות.
  • מספר פעולות הקריאה של FHIR לדקה בכל אזור. מידע נוסף מופיע במאמר בנושא מכסות של Cloud Healthcare API FHIR.

אפשר לבחור את תדירות ייבוא הנתונים בזמן יצירת מאגר הנתונים, ואי אפשר לשנות את ההגדרה הזו בהמשך.

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

לפני שיוצרים את אפליקציית החיפוש בתחום הבריאות, חשוב להבין את הנקודות הבאות:

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

• הכנת נתוני FHIR להטמעה.

• התכונה Agent Search for healthcare מספקת שירותי חיפוש רק באזור הגיאוגרפי המורכב מאזורים רבים בארה"ב (us). לכן, אפליקציית החיפוש ומאגרי הנתונים שלכם בתחום הבריאות צריכים להיות ממוקמים באזור הגיאוגרפי המורכב מאזורים רבים us.

• אם אתם מייבאים נתונים בתחום הבריאות ממאגר FHIR של Cloud Healthcare API בפרויקט אחד Google Cloud למאגר נתונים של חיפוש מבוסס סוכנים בפרויקט אחר Google Cloud ואתם משתמשים ב-VPC Service Controls, שני הפרויקטים צריכים להיות באותו גבולות גזרה.

יצירת אפליקציה

אפשר ליצור אפליקציה לחיפוש מידע רפואי במסוף Google Cloud או באמצעות ה-API. כדי ליצור אפליקציה לחיפוש מידע בתחום הבריאות, פועלים לפי השלבים הבאים:

ההרשאות שנדרשות למשימה הזו

מקצים את התפקידים הבאים ב-Identity and Access Management (IAM) לחשבון השירות [e-mail] בפרויקט שמכיל את מאגר הנתונים של חיפוש מבוסס סוכנים:

מטרה	תפקידים
כדי לבצע ייבוא חד-פעמי של נתוני FHIR מחנויות FHIR ב-Cloud Healthcare API.	BigQuery Job User (roles/bigquery.jobUser) עריכה של נתוני BigQuery‏ (roles/bigquery.dataEditor) אדמין של חנות FHIR בתחום הבריאות (roles/healthcare.fhirStoreAdmin)
כדי לבצע ייבוא בהזרמה של נתוני FHIR מחנויות FHIR ב-Cloud Healthcare API באותו Google Cloud פרויקט.	BigQuery Job User (roles/bigquery.jobUser) עריכה של נתוני BigQuery‏ (roles/bigquery.dataEditor) אדמין של חנות FHIR בתחום הבריאות (roles/healthcare.fhirStoreAdmin) קריאת משאב FHIR בתחום הבריאות (roles/healthcare.fhirResourceReader)
כדי לבצע ייבוא של נתוני FHIR ממאגרי FHIR ב-Cloud Healthcare API בפרויקט Google Cloud אחר.	BigQuery Job User (roles/bigquery.jobUser) עריכה של נתוני BigQuery‏ (roles/bigquery.dataEditor) אדמין של חנות FHIR בתחום הבריאות (roles/healthcare.fhirStoreAdmin) קריאת משאב FHIR בתחום הבריאות (roles/healthcare.fhirResourceReader)
כדי לייבא נתוני FHIR שמפנים לקבצים ב-Cloud Storage. ההרשאות האלה מוענקות כברירת מחדל אם הקבצים שאליהם יש הפניה נמצאים באותו פרויקט של אפליקציית Agent Search. Google Cloud	אדמין של אובייקטים באחסון (roles/storage.objectAdmin)
כדי להתאים אישית את הסכימה כשיוצרים מאגר נתונים כדי להגדיר את האפשרות לאינדוקס, לאחזור ולחיפוש של משאבי FHIR ורכיבים.	אדמין של אובייקטים באחסון (roles/storage.objectAdmin)

צריך להקצות את התפקידים הבאים של ניהול זהויות והרשאות גישה (IAM) ל[e-mail]חשבון השירות בפרויקט שמכיל את מאגר הנתונים של Cloud Healthcare API FHIR R4:

מטרה	תפקידים
כדי לבצע ייבוא של נתוני FHIR ממאגרי FHIR ב-Cloud Healthcare API בפרויקט Google Cloud אחר.	אדמין של חנות FHIR בתחום הבריאות (roles/healthcare.fhirStoreAdmin) קריאת משאב FHIR בתחום הבריאות (roles/healthcare.fhirResourceReader)

צריך להקצות את התפקידים הבאים של ניהול זהויות והרשאות גישה (IAM) ל[e-mail]חשבון השירות בפרויקט שמכיל את מאגר הנתונים של Cloud Healthcare API FHIR R4:

מטרה	תפקידים
כדי לבצע ייבוא בהזרמה של נתוני FHIR מחנויות FHIR ב-Cloud Healthcare API באותו Google Cloud פרויקט.	BigQuery Job User (roles/bigquery.jobUser) עריכה של נתוני BigQuery‏ (roles/bigquery.dataEditor)
כדי להתאים אישית את הסכימה כשיוצרים מאגר נתונים כדי להגדיר את האפשרות לאינדוקס, לאחזור ולחיפוש של משאבי FHIR ורכיבים.	אדמין של אובייקטים באחסון (roles/storage.objectAdmin)

המסוף

1. נכנסים לדף AI Applications במסוף Google Cloud .

   אפליקציות AI

2. בדף אפליקציות, לוחצים על אפליקציה חדשה.

3. בדף יצירת אפליקציה, בקטע חיפוש בתחום הבריאות, לוחצים על יצירה.

4. בחלונית Search app configuration (הגדרת אפליקציית החיפוש), בוחרים באפשרות Healthcare (שירותי בריאות).

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

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

6. בשדה Your app name, מזינים שם לאפליקציה.

7. בשדה השם החיצוני של החברה או הארגון, מזינים את השם הנפוץ של החברה או הארגון. אין צורך לכלול סיומות כמו Inc או LLC. השדה הזה שימושי למודל שפה גדול (LLM) כדי לזהות את החברה שהאפליקציה מייצגת.

8. בקטע Access Transparency, בוחרים באפשרות Disable search metrics for this app כדי להשבית את רישום המדדים עבור האפליקציה הנוכחית. אי אפשר לשנות את ההגדרה הזו אחרי יצירת האפליקציה.

9. לוחצים על Continue.

10. כדי להתחבר למאגר נתונים, בדף מאגרי נתונים, מבצעים אחת מהפעולות הבאות:

    • בוחרים מאגר נתונים קיים של נתוני בריאות לייבוא באצווה או מחבר נתונים קיים לייבוא בסטרימינג. כדי ליצור מאגר נתונים או מחבר נתונים לפני שיוצרים אפליקציה, אפשר לעיין במאמר יצירת מאגר נתונים של נתוני בריאות.
    • יוצרים מאגר נתונים (לייבוא אצווה חד-פעמי) או מחבר נתונים, שהוא מופע של מאגר נתונים (לייבוא בסטרימינג):
      1. לוחצים על יצירת מאגר נתונים.
      2. בחלונית בחירת מקור נתונים, בוחרים באפשרות Healthcare API (FHIR) כמקור הנתונים.
      3. כדי לייבא נתונים ממאגר FHIR, מבצעים אחת מהפעולות הבאות:
         • בוחרים את מאגר ה-FHIR מתוך רשימת מאגרי ה-FHIR הזמינים:
           1. מרחיבים את השדה FHIR store.
           2. ברשימה הזו, בוחרים מערך נתונים שנמצא במיקום מותר, ואז בוחרים מאגר FHIR שמשתמש ב-FHIR בגרסה R4.
         • מזינים את מאגר ה-FHIR באופן ידני:
           1. מרחיבים את השדה FHIR store.
           2. לוחצים על הזנת מאגר FHIR באופן ידני.
           3. בתיבת הדו-שיח FHIR store name (שם מאגר FHIR), מזינים את השם המלא של מאגר FHIR בפורמט הבא:

              project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

           4. לוחצים על Save.
      4. בקטע סנכרון, בוחרים באחת מהאפשרויות הבאות. אי אפשר לשנות את הבחירה הזו אחרי שיוצרים את מאגר הנתונים.
         • חד-פעמי: כדי לבצע ייבוא חד-פעמי של נתונים באצווה. למידע נוסף על ייבוא מצטבר, אפשר לעיין במאמר רענון נתונים בתחום הבריאות.
         • סטרימינג: כדי לבצע ייבוא של נתונים בסטרימינג כמעט בזמן אמת. כדי להזרים נתונים, צריך ליצור מחבר נתונים, שהוא סוג של מאגר נתונים. כדי להגדיר מאגר נתונים של סטרימינג באמצעות API בארכיטקטורת REST, צריך לפנות ל-Customer Engineer.
      5. בקטע מה הסכימה של הנתונים האלה?, בוחרים באחת מהאפשרויות הבאות:
         • סכימה מוגדרת מראש של Google: כדי לשמור את הגדרות הסכימה שהוגדרו על ידי Google, כמו זמינות להוספה לאינדקס, קלות החיפוש ואפשרות אחזור, עבור משאבי FHIR ורכיבים נתמכים. אחרי שבוחרים באפשרות הזו, אי אפשר לעדכן את הסכימה אחרי שיוצרים את מאגר הנתונים. אם רוצים לשנות את הסכימה אחרי יצירת מאגר הנתונים, בוחרים באפשרות סכימה בהתאמה אישית.
           1. לוחצים על Continue.
           2. בשדה Your data store name, מזינים שם למאגר הנתונים.
           3. לוחצים על יצירה.

           מאגר הנתונים שיצרתם מופיע בדף מאגרי נתונים.

         • סכימה מותאמת אישית: כדי להגדיר את תצורות הסכימה שלכם, כמו זמינות להוספה לאינדקס, קלות החיפוש ואפשרות לאחזור, עבור רכיבי FHIR ומשאבים נתמכים. כדי להגדיר סכימה שאפשר להגדיר, צריך לפנות למהנדס הלקוחות.
           1. לוחצים על Continue.
           2. בודקים את הסכימה, מרחיבים כל שדה ועורכים את ההגדרות של השדה.
           3. לוחצים על הוספת שדות חדשים כדי להוסיף שדות חדשים במשאבי FHIR הנתמכים. אי אפשר להסיר את השדות שמופיעים בסכימה שהוגדרה על ידי Google.
           4. לוחצים על Continue.
           5. בשדה Your data connector name (השם של מחבר הנתונים), מזינים שם למחבר הנתונים.
           6. לוחצים על יצירה.

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

      6. לוחצים על Continue.
      7. בוחרים את מאגר הנתונים או את מחבר הנתונים שיצרתם.

11. אופציונלי: כדי לראות רשימה של מאגרי נתונים שלא זמינים, לוחצים על למה?.

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

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

12. לוחצים על יצירה.

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

REST

1. יצירת מאגר נתונים רפואיים וייבוא נתונים רפואיים אליו.

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

   מונח מרכזי: בחיפוש מבוסס סוכנים, המונח אפליקציה יכול לשמש לחלופין למונח מנוע בהקשר של ממשקי 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"]
       }
   }'
   

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

   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
   • ‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים שרוצים ליצור.
   • APP_DISPLAY_NAME: השם המוצג של אפליקציית חיפוש מבוסס סוכנים שרוצים ליצור.
   • ‫DATA_STORE_ID: המזהה של מאגר נתונים קיים של חיפוש סוכנים שרוצים להוסיף לאפליקציית חיפוש הסוכנים.
   • ‫SEARCH_ADD_ON: שדה אופציונלי שבו מציינים אם רוצים להשתמש בתכונות מתקדמות של מודלים גדולים של שפה (LLM), כמו חיפוש עם תשובות מ-AI גנרטיבי, באפליקציה הזו. כדי להפעיל תכונות מתקדמות של מודלים גדולים של שפה, מזינים את הערך SEARCH_ADD_ON_LLM. אם אתם לא רוצים להשתמש בתכונות המתקדמות של LLM, אתם יכולים לציין SEARCH_ADD_ON_UNSPECIFIED או להסיר את השדה searchAddOns. מידע נוסף זמין במאמר תכונות מתקדמות של מודלים גדולים של שפה (LLM).

   תשובה

   אתם אמורים לקבל תגובת JSON שדומה לזו: אם הערך של השדה done הוא true, המשמעות היא שהפעולה ליצירת האפליקציה הושלמה. אם הערך הוא false, פעולת יצירת האפליקציה נכשלה.

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

אימות יצירת האפליקציה

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

• ב Google Cloud מסוף: בוחרים את האפליקציה ומאמתים את הפרטים שלה.
• משתמשים ב-method‏ engines.get דרך API בארכיטקטורת REST כדי לקבל את הפרטים של מאגר נתוני הבריאות.

כדי לאמת את יצירת מאגר הנתונים ואת ייבוא הנתונים, מבצעים את השלבים הבאים.

המסוף

1. נכנסים לדף AI Applications במסוף Google Cloud .

   אפליקציות AI

2. בדף Apps (אפליקציות), בודקים אם האפליקציה שיצרתם מופיעה ברשימת האפליקציות.

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

4. בוחרים את מאגר הנתונים ומאמתים את הפרטים של מאגר הנתונים.

REST

1. מאמתים את יצירת האפליקציה.

   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"
   

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

   • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
   • ‫APP_ID: המזהה של אפליקציית חיפוש מבוסס סוכנים.

   תשובה

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

   {
     "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. אימות של יצירת מאגר נתונים וייבוא נתוני FHIR

המאמרים הבאים

• מחפשים נתוני בריאות באפליקציית החיפוש של שירותי הבריאות.
• רענון נתונים רפואיים.