מידע על אפליקציות ומאגרי נתונים

בדף הזה מתוארות אפליקציות ומאגרי נתונים של Agent Search.

ב-Agent Search, אתם יוצרים אפליקציית חיפוש או המלצות ומחברים אותה למאגר נתונים. פרויקט ב- Google Cloud יכול להכיל כמה אפליקציות.

הקשר בין אפליקציות למאגרי נתונים

הקשר בין אפליקציות למאגרי נתונים תלוי בסוג האפליקציה:

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

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

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

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

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

אחרי שמקשרים מאגר נתונים לאפליקציה, אי אפשר לנתק אותו.

השיטה ליצירת האפליקציה ולהטמעת הנתונים

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

  • לגבי נתוני אתרים, אתם יכולים להשתמש במסוף Google Cloud או ב-API. כדי להשתמש בנתוני אתר שנוצרו באמצעות ה-API, צריך לצרף אותם לאפליקציה שבה מופעלות תכונות Enterprise במסוף Google Cloud .

  • בנתונים מובְנים או לא מובְנים, אפשר להשתמש במסוף או ב-API שלGoogle Cloud .

  • לנתוני בריאות, אתם יכולים להשתמש במסוף Google Cloud או ב-API.

מסמכים

בכל מאגר נתונים יש רשומת נתונים אחת או יותר, שנקראות מסמכים. המשמעות של מסמך משתנה בהתאם לסוג הנתונים במאגר הנתונים:

  • אתר. מסמך הוא דף אינטרנט.

  • נתונים מובְנים. מסמך הוא שורה בטבלה או רשומת JSON שתואמת לסכימה מסוימת. אתם יכולים לספק את הסכימה בעצמכם או לאפשר ל-Agent Search להפיק את הסכימה מהנתונים שהוטמעו.

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

  • נתונים לא מובְנים. מסמך הוא קובץ בכל אחד מהפורמטים הבאים: TXT,‏ PDF,‏ HTML,‏ DOCX,‏ PPTX,‏ XLSX ו-XLSM.

  • נתוני FHIR בתחום הבריאות. מסמך הוא משאב נתמך של FHIR R4. במאמר הזה מפורטים משאבי FHIR R4 שנתמכים בחיפוש מבוסס סוכנים.

פעולות CRUD במאגרי נתונים

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

אתם יכולים לנהל מסמכים או רשומות ספציפיים במאגר נתונים באמצעות ה-API:

  • יצירה: הוספת מסמכים נפרדים להסתעפות של מאגר נתונים באמצעות השיטה documents.create.
  • קריאה (אחזור ורשימה): אחזור של מסמך ספציפי לפי המזהה שלו באמצעות ה-method‏ documents.get, או הצגת רשימה של מסמכים ב-branch באמצעות ה-method‏ documents.list.
  • עדכון: שינוי שדות, תוכן או מטא-נתונים של מסמך קיים באמצעות השיטה documents.patch. אפשר גם לבצע פעולת עדכון או הוספה (upsert) (הוספה אם לא נמצא) על ידי הגדרת השדה allowMissing לערך true.
  • מחיקה סלקטיבית: מחיקה סלקטיבית של רשומות ספציפיות באמצעות השיטה documents.delete, במקום למחוק את כל מאגר הנתונים.

מאגרי נתונים ואפליקציות

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

נתונים מהאתר

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

לדוגמה, אפשר לספק תבניות URL כמו example.com/faq/* ו-example.com/events/* ולהפעיל חיפוש בנתונים שנסרקו מדפי האינטרנט האלה שתואמים לתבנית. הנתונים האלה כוללים טקסט, תמונות שמתויגות עם מטא-נתונים ונתונים מובְנים אחרים, כמו תגי meta, מאפייני PageMap ונתונים של schema.org.

אפשר גם לציין תבניות URL לחלקים של אתרים שרוצים להחריג, לדוגמה, example.com/events/members-only/* או example.com/events/past-*. כתובות URL שהוחרגו מקבלות עדיפות על פני כתובות URL שנכללו.

יש שני סוגים של מאגרי נתונים של אתרים:

  • חיפוש בסיסי באתר:

    • מספק יכולות חיפוש באינדקס הקיים של חיפוש Google באתרים הכלולים.
    • לא נדרש אימות דומיין.

  • התהליך המתקדם להוספת אתרים לאינדקס:

    • הוא מספק יכולות חיפוש מתקדמות באינדקס שנוצר על סמך אחד מהבאים:
      • הבעלים של אפליקציית Agent Search יכולים לשלוח קובצי Sitemap ולתחזק אותם כדי לקבוע אילו דפי אינטרנט יתווספו לאינדקס. מידע נוסף זמין במאמר הוספה לאינדקס ורענון של דפי אינטרנט באמצעות קובצי Sitemap. התהליך הזה שומר על עדכניות האינדקס בלי התערבות ידנית.
      • בעלי האפליקציה Agent Search יכולים לבצע הוספה ראשונית לאינדקס שמשקפת את אינדקס החיפוש של חיפוש Google, ואז להרחיב את הכיסוי של האינדקס על ידי סריקה חוזרת של האתרים בכל פעם שצריך, כדי לשמור על עדכניות. למידע נוסף, ראו רענון דפי אינטרנט. היכולות המתקדמות של התהליך המתקדם להוספת אתרים לאינדקס מפורטות במאמר התהליך המתקדם להוספת אתרים לאינדקס.
    • בעלי מאגרי הנתונים של Agent Search צריכים לאמת את הדומיינים שאליהם שייכים האתרים הכלולים. מידע נוסף זמין במאמר אימות דומיינים של אתרים.
    • מאפשר להוסיף נתונים מובְנים לסכימה של מאגר הנתונים. אתר מכיל נתונים לא מובנים, אבל אתם יכולים להוסיף לדפי האינטרנט נתונים מובנים בצורת תגי meta, מאפייני PageMap ונתונים של schema.org. אחר כך אתם יכולים להשתמש בנתונים המובְנים האלה כדי לערוך את הסכימה של מאגר הנתונים, כמו שמוסבר במאמר שימוש בנתונים מובְנים להוספה מתקדמת של אתרים לאינדקס.

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

לחיפוש באתר:

נתונים מובְנים

מאגר נתונים עם נתונים מובְנים מאפשר חיפוש סמנטי או המלצות על נתונים מובְנים. אתם יכולים לייבא נתונים מ-BigQuery או מ-Cloud Storage. אפשר גם להעלות באופן ידני נתוני JSON מובְנים דרך ה-API.

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

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

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

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

כדי לקבל המלצות בהתאמה אישית:

נתונים מובְנים למדיה

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

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

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

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

נתונים לא מובְנים

מאגר נתונים לא מובְנים מאפשר חיפוש סמנטי בנתונים כמו מסמכים ותמונות.

מאגרי נתונים לא מובְנים תומכים במסמכים בפורמטים TXT,‏ PDF,‏ HTML,‏ DOCX,‏ PPTX,‏ XLSX ו-XLSM.

חיפוש Google מספק תוצאות בצורה של 10 כתובות URL ותשובות מסוכמות לשאילתות בשפה טבעית. צריך להעלות את המסמכים לקטגוריה של Cloud Storage עם הרשאות גישה מתאימות. לדוגמה, מוסד פיננסי יכול לאפשר חיפוש במאגר הפרטי שלו של פרסומי מחקר פיננסי, או שחברת ביוטכנולוגיה יכולה לאפשר חיפוש או המלצות במאגר הפרטי שלה של מחקר רפואי.

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

בחיפוש:

נתוני FHIR בתחום הבריאות

אפליקציית חיפוש בתחום הבריאות משתמשת בנתוני FHIR R4 שיובאו ממאגר FHIR של Cloud Healthcare API. במאמר סכימת הנתונים של Healthcare FHIR R4 מפורטת רשימה של משאבי FHIR R4 שנתמכים ב"חיפוש מבוסס סוכנים". מאגר נתונים של FHIR R4 צריך לעמוד בדרישות מסוימות כדי שאפשר יהיה להשתמש בו כמקור נתונים למאגר נתונים של Agent Search. למידע נוסף, קראו איך מכינים נתוני FHIR בתחום הבריאות להטמעה.

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

מידע על חיפוש משולב

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

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

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

המגבלות הבאות חלות:

  • הוספה והסרה של מאגרי נתונים:
    • כדי להפעיל חיפוש משולב באפליקציה, צריך לחבר אליה לפחות שני מאגרי נתונים במהלך יצירת האפליקציה.
    • אתם יכולים להוסיף או להסיר מאגרי נתונים מאפליקציית חיפוש משולב, אבל לאפליקציה חייבים להיות לפחות שני מאגרי נתונים מקושרים בכל שלב.
    • אם מקשרים מאגר נתונים אחד לאפליקציית חיפוש במהלך יצירת האפליקציה, אי אפשר להוסיף או להסיר את מאגר הנתונים הזה.
  • כדי להשתמש במאגרי נתונים של אתרים בחיפוש משולב, צריך להפעיל בהם הוספה מתקדמת של אתרים לאינדקס. מידע נוסף על התהליך המתקדם להוספת אתרים לאינדקס
  • אין תמיכה במאגרי נתונים שמכילים נתונים לא מובְנים שיובאו באמצעות BigQuery.
  • אין תמיכה בחיפוש תמונות (באמצעות השדה params עם searchType: 1).
  • בחיפוש משולב אפשר להשתמש בשדות הבאים בבקשות חיפוש:
    • boostSpec
    • contentSearchSpec
    • dataStoreSpecs
    • facetSpecs
    • filter
    • languageCode
    • offset
    • oneBoxPageSize
    • orderBy
    • query
    • pageSize
    • pageToken
    • relevanceScoreSpec
    • relevanceThreshold
    • session
    • sessionSpec
    • spellCorrectionSpec
    • userInfo
    • userPseudoId
  • בחיפוש משולב אפשר להשתמש בשדות הבאים ב-DataStoreSpec:
    • dataStore
    • ‫boostSpec: אם צוינו מפרטי חיזוק גם ל-SearchRequest וגם ל-dataStoreSpecs, שני מפרטי החיזוק יחולו על תוצאות החיפוש
    • filter: אם צוינו מסננים גם ל-SearchRequest וגם ל-dataStoreSpecs, שני המסננים יחולו על תוצאות החיפוש.
  • באפליקציות משולבות אפשר לבצע פעולות CRUD (יצירה, קריאה, עדכון ומחיקה) על הגדרות להצגת תוצאות. אפשר להוסיף או לעדכן רק את השדות הבאים בהגדרת הצגה:
    • boostControlIds
    • displayName
    • filterControlIds
    • genericConfig:
      • contentSearchSpec
    • name
    • solutionType
    • synonymsControlIds
  • באפליקציות של חיפוש משולב יש תמיכה בפעולות CRUD באמצעי הבקרה הבאים:
    • boostAction
    • synonymAction
    • filterAction
  • אפשר להוסיף עד 50 מאגרי נתונים לכל אפליקציית חיפוש.
  • אם במאגר נתונים אחד משתמשים בהגדרת CMEK, צריך להשתמש באותה הגדרת CMEK גם בכל שאר מאגרי הנתונים.