הגדרת שדות

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

הגדרות השדות עוזרות לקבוע איך Agent Search משתמש בשדות בתוצאות שלו. אפשר להשתמש בכרטיסייה Schema במסוףGoogle Cloud כדי לקבוע את הגדרות שדות התצורה.

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

הגדרות השדה

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

הגדרה הגדרה מטרה תרחיש לדוגמה
ניתן להוסיף לאינדקס

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

אי אפשר להגדיר שדות מסוג Object לערך Indexable.

סימון שדה בתור Indexable מאפשר חיפושים מהירים יותר.

חשוב לדעת: סימון שדה כ-Indexable מגדיל את אינדקס החיפוש ויכול להאט את תהליך ההוספה לאינדקס.

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

שדות שהכי סביר שיהיו קשורים לחיפושים מסומנים כ-Searchable. שדה יכול להיות ניתן לחיפוש בלי שניתן יהיה להוסיף אותו לאינדקס או לאחזר אותו.

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

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

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

מערכת כרטיסי התמיכה של ספק אינטרנט שומרת כל כרטיס כמסמך מובנה. אם המסמכים האלה מכילים שדות טקסט שניתן לחפש בהם, כמו issue_description או resolution_notes, נציג התמיכה יכול לבצע שאילתה שקשורה לתוכן בשדות האלה, כמו איך לפתור את הבעיה של מהירות אינטרנט איטית אחרי איפוס המודם. המערכת תציג את המסמכים שמכילים את אחד ממונחי החיפוש האלה, כולל modem,‏ internet,‏ speed, באחד מהשדות issue_description או resolution_notes או בשניהם.

Prefix matchable
(גרסת טרום-השקה (Preview))

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

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

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

יש לכם שדה, ticket_id, שמשתמש בפורמט כמו <country-code><city-code><number>. לדוגמה, UKLON100, UKMAN100, UKMAN101 ו-USNY200. כדי למצוא את כל הכרטיסים ממנצ'סטר (בריטניה), אפשר להגדיר את השדה ticket_id כך שיתאים לתחילית, ואז להשתמש במסנן ticket_id: STARTS_WITH("UKMAN"), שמחזיר את UKMAN100 ו-UKMAN101.

התאמה חלקית
(גרסת טרום-השקה)

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

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

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

אתם רוצים לסנן לפי אזורים באירופה. השמות של region כוללים את Central Europe ו-Eastern Europe. אם המסנן הוא region: ANY("Europe"), לא יתקבלו התאמות. עם זאת, אם השדה region מוגדר כניתן להתאמה חלקית, אפשר לסנן לפי region: CONTAINS("Europe") ולקבל התאמות ל-Central Europe ול-Eastern Europe.

תאימות לחיפוש תוך כדי הקלדה
(גרסת טרום-השקה)

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

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

מידע נוסף זמין בקטע הפיכת שדות לזמינים לחיפוש תוך כדי הקלדה שבהמשך.

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

במאגר נתונים של סרטים, מגדירים את השדה title בתור saytCompatible. כשמשתמש מקליד b, תוצאות החיפוש כוללות באופן דינמי את Batman Begins,‏ Batman Returns ו-Bats, שמדורגות בהתאם לשאילתה של המשתמש. כשהמשתמש מרחיב את השאילתה ל-bat, שלושת המסמכים נשארים בתוצאות, אבל הדירוג שלהם משתנה בהתאם לקידומת הארוכה יותר. הרחבת השאילתה ל-batm משמיטה את Bats כי האסימון הראשון של הכותרת שלו לא מתחיל ב-batm, כך שרק Batman Begins ו-Batman Returns נשארים, ומדורגים מחדש.

ניתן לסינון דינמי מספק מסננים מותאמים להקשר כדי לטרגט טוב יותר את החיפושים של המשתמשים. הגדרת שדה כ-Dynamic Facetable מאפשרת למערכת ליצור באופן אוטומטי מסננים אינטראקטיביים (מאפיינים) על סמך הערכים הייחודיים שקיימים בשדה. הגדרת שדה לערך Dynamic facetable מאפשרת למשתמשים לצמצם באופן דינמי את תוצאות החיפוש על ידי בחירת קטגוריות או מאפיינים שנגזרים ישירות מהנתונים שהוטמעו, בלי צורך להגדיר מראש באופן ידני כל אפשרות סינון אפשרית. כך המשתמשים יכולים לצמצם את החיפוש לתוכן ספציפי מאוד מהאינטרנט.
כדי להשיג תוצאות טובות יותר, כדאי להשתמש ב-Dynamic Facetable עם Searchable. כך אפשר לשפר גם את ה-recall של החיפוש וגם את האיכות של ה-facets שמוצעים למשתמש.
דפים במאגר מידע פנימי של הארגון, כמו מדיניות משאבי אנוש, נקלטים עם נתונים כמו department, document_type או last_modified_date. אם השדות האלה מתויגים בתור dynamic facetable, חיפוש של עובד אחר מונח כמו החזר הוצאות יוצר באופן דינמי מסננים אינטראקטיביים על סמך התוצאות הרלוונטיות שנמצאו. במקרה כזה, בממשק האינטרנט יכולים להופיע מאפיינים כמו מחלקה: כספים, נסיעות, סוג מסמך: מדיניות, שאלות נפוצות או תאריך השינוי האחרון: הרבעון הזה, השנה שעברה.
ניתן לאחזור כששאילתת חיפוש מוצאת תוכן תואם, מנוע החיפוש יכול לשלוף את הערכים של השדות שניתנים לאחזור כדי להציג אותם או להשתמש בהם באפליקציה. כלומר, המידע מהמסמך המקורי מוצג כחלק מתוצאות החיפוש. שדות מפתח (מזהים ייחודיים של מסמכים) מוגדרים כניתנים לאחזור. שדות שניתן לאחזר מספקים הקשר לחיפוש על ידי הבחנה בין שדות שניתן להציג את הערכים שלהם לבין שדות שנועדו לשימוש רק בלוגיקת החיפוש, אבל הערכים הגולמיים שלהם לא אמורים להופיע למשתמש. בחיפוש מוצרים באתר של מוכר, השדות product_id,‏ name,‏ price ו-image_url הם שדות אופייניים שרוצים להגדיר כניתנים לאחזור. מצד שני, אפשר להוסיף את internal_tracking_code לאינדקס ולסנן אותו למטרות ניהוליות בלבד, אבל לא לאחזר אותו בתוצאות חיפוש שגלויות לכולם.
Completable מאפשרת להשתמש בתוכן של שדה מסוים כדי להציע שאילתות חיפוש. מידע נוסף זמין במאמר הגדרת השלמה אוטומטית.

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

אם השדה completable מוגדר לערכים product_name,‏ brand ו-category, כשהמשתמש מקליד Tech, ההצעות של ההשלמה האוטומטית יכולות להציג:
  • ‫TechCo (מהשדה brand)
  • ‫TechCo UltraBook X1 (מהשדה product_name)
  • טכנולוגיה GameMaster Pro (מוצר אחר מהתחום category)
ניתן לסינון מאפשר להשתמש בשדה כדי לסנן את תוצאות החיפוש המומלצות, ולקבוע אילו תוצאות חיפוש יוצגו למשתמשים. במאמר סינון המלצות מוסבר איך מסננים המלצות. הגדרת שדה ל-Filterable עוזרת להתאים אישית את ההמלצות למשתמשים. חשוב לזכור שחלות מגבלות סינון. הגדרת מסנן לפי שפה ודרמה יכולה להיראות כך: language_code: ANY("en", "fr") OR categories: ANY("drama").

ההבדלים בין הגדרות נפוצות

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

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

בפועל, שדות רבים שחיוניים לחוויית המשתמש (כמו שמות, תיאורים ופרטים אישיים מזהים) מוגדרים לעיתים קרובות כ-indexable, searchable ו-retrievable.

מגבלות

להגדרות השדות יש את המגבלות הבאות:

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

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

עדכון הגדרות השדות

כדי לעדכן את הגדרות השדה:

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

    אפליקציות AI

  2. לוחצים על שם האפליקציה שרוצים לערוך.

  3. לוחצים על נתונים.

  4. לוחצים על הכרטיסייה Schema. בכרטיסייה הזו מוצגות הגדרות השדה הנוכחיות.

    הכרטיסייה Schema לא תופיע אם מאגר הנתונים מכיל נתוני אתר בסיסיים או נתונים לא מובְנים בלי מטא-נתונים.

  5. לוחצים על Edit.

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

  7. לוחצים על Save כדי לעדכן את השינויים.

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

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

  • אתם מעבירים נתונים מפלטפורמת חיפוש קיימת שכבר משתמשת בשדות משוקללים.

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

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

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

רמות משקל

המשקלים מחולקים לרמות הבאות:

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

עדכון הסכימה והוספה מחדש לאינדקס

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

הגדרת רמות משקל בשדות

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

אפשר להגדיר את המשקל של שדה החיפוש רק דרך ה-API. התכונה הזו לא זמינה במסוף Google Cloud .

כדי להגדיר משקלים, צריך לעדכן את הסכימה של מאגר הנתונים באמצעות השיטה projects.locations.dataStores.schemas.patch ב-API.

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

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

    "summary": {
       "type": "string",
       "searchable": true,
       "weight": "high"
     },
     "uri": {
       "type": "string",
       "searchable": true,
       "weight": "low"
     },
    

    בדוגמה הזו, השדה summary מוגדר למשקל גבוה מהרגיל והשדה uri מוגדר למשקל נמוך יותר. כדי להחזיר את המשקל לערך ברירת המחדל, מגדירים אותו ל-default.

    הערכים המותרים לפרמטר המשקל הם:

    • very_low
    • low
    • default
    • high
    • very_high
  3. מחכים עד שההוספה מחדש לאינדקס תסתיים ובודקים את התנהגות החיפוש.

הפיכת שדות לזמינים להתאמה חלקית ולהתאמה לפי קידומת (גרסת טרום-השקה (Preview))

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

עדכון הסכימה והוספה מחדש לאינדקס

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

עדכון הסכימה להתאמה חלקית ולהתאמה לפי קידומת

כדי לציין שדות שזמינים להתאמה לפי תחילית או להתאמה חלקית, צריך לעדכן את הסכימה של מאגר הנתונים באמצעות השיטה projects.locations.dataStores.schemas.patch ב-API.

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

  2. פועלים לפי ההוראות לעדכון הסכימה באופן פרוגרמטי. מגדירים את הפרמטרים שניתנים להתאמה ל-true בסכימה, כמו בדוגמאות הבאות:

    "zone": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true
     },
     "region": {
       "type": "string",
       "searchable": true,
       "partialMatchable": true
     },
     "model": {
       "type": "string",
       "searchable": true,
       "prefixMatchable": true,
       "partialMatchable": true
     },
    

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

  3. מחכים עד שההוספה מחדש לאינדקס תסתיים.

פרטים על התאמת קידומת

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

לוגיקת הנורמליזציה וההתאמה

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

  1. אותיות קטנות: כל התווים מומרים לאותיות קטנות. כך ההתאמה לא תלוית-רישיות.

  2. חיתוך של 12 תווים: המערכת מתייחסת רק ל-12 התווים הראשונים של המחרוזת. המערכת מתעלמת מכל התווים שחורגים מהמגבלה הזו למטרות התאמה של קידומת.

איך זה עובד

בזמן יצירת האינדקס, המערכת יוצרת אסימוני קידומת ל-12 התווים הראשונים בשדה שמסומן כ-prefixMatchable. לערך כמו asia-south1-c, האינדקס מאחסן אסימונים עבור a, as, asi, asia, asia- וכן הלאה, עד התו ה-12 (asia-south1-).

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

דוגמאות

בדוגמאות הבאות אפשר לראות איך הנורמליזציה של 12 תווים משפיעה על תוצאות החיפוש:

  • התאמות רחבות: STARTS_WITH("A") תואם לכל ערך שמתחיל באות "a" (לא תלוי-רישיות), כמו asia,‏ australia או africa.

  • תחיליות חלקיות: STARTS_WITH("asia-south") תואם גם ל-asia-south1-a וגם ל-asia-southeast1-b כי שניהם מתחילים במחרוזת של 10 התווים שצוינה.

  • התנהגות החיתוך: מכיוון שרק 12 התווים הראשונים תואמים, STARTS_WITH("asia-south1-a") תואם לערך השדה asia-south1-c. זה קורה כי שתי המחרוזות מנורמלות לאותה תחילית באורך 12 תווים: asia-south1-.

פרטים על התאמה חלקית

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

לוגיקת הנירמול והטוקניזציה

החיפוש מבוסס הסוכנים מנרמל וממיר לאסימונים גם את ערך השדה (במהלך הוספה לאינדקס) וגם את מחרוזת השאילתה (במהלך החיפוש):

  • המרת אותיות רישיות לאותיות קטנות: המערכת ממירה את התווים לאותיות קטנות. כך ההתאמה לא תלוית-רישיות.

  • המרת אסימונים: "חיפוש מבוסס סוכנים" מפצל את המחרוזת לאסימונים (מילים) נפרדים באמצעות רווחים ותווים אחרים כמפרידים.

    • תווי הפרדה סטנדרטיים: רווחים וסימני פיסוק נפוצים משמשים כתווי הפרדה, כולל מקפים (-), קווים נטויים (/), פסיקים (,), נקודות (.), כוכביות (*), סוגריים מסולסלים ({ }), סוגריים מרובעים ([ ]), סוגריים עגולים (( )) וגרשיים (').

    • תווים שאינם מפרידים: אמפרסנד (&) וקו תחתון (_) לא משמשים כמפרידים. המערכת מתייחסת לתווים שמחוברים באמצעות הסמלים האלה כאל אסימון אחד.

    • תו תוחם של אימייל (@): הסמל @ משמש כתו תוחם מיוחד שעוזר לזהות כתובות אימייל. המערכת יוצרת אסימונים לרכיבים הבודדים וגם לצורות המשולבות. לדוגמה, המחרוזת support+tier1@example.com תומר לטוקנים support,‏ tier1,‏ example,‏ com,‏ support+tier1@example.com ו-support@example.com.

איך זה עובד

בזמן יצירת האינדקס, בשדה שמסומן כ-partialMatchable, המערכת מבצעת נורמליזציה וטוקניזציה של ערך השדה ומאחסנת את הטוקנים שנוצרו באינדקס. לדוגמה, הוא ממיר את הערך 25-meter, outdoor, swimming pool בשדה ל-[25, meter, outdoor, swimming, pool].

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

דוגמאות

הדוגמאות הבאות ממחישות איך הטוקניזציה משפיעה על תוצאות ההתאמה החלקית:

  • התאמת אסימונים בסיסית: אם ערך השדה הוא 25-meter, outdoor, swimming pool, המסנן CONTAINS("Outdoor pool") תואם. המערכת יוצרת טוקנים מהשאילתה: [outdoor, pool], ששניהם קיימים בטוקנים של השדה.

  • חוסר תלות בסדר: המסנן CONTAINS("pool outdoor") תואם גם לערך השדה 25-meter, outdoor, swimming pool כי המערכת בודקת את הנוכחות של כל אסימון בלי קשר לסדר שלהם.

  • התאמה של כתובת אימייל: אם בשדה מסוים מאוחסנת כתובת האימייל support+tier1@example.com, מסננים כמו CONTAINS("support"),‏ CONTAINS("example.com") או CONTAINS("support@example.com") יתאימו כולם בהצלחה בגלל הטוקניזציה המיוחדת של הסמל @.

הפיכת שדות לזמינים לחיפוש תוך כדי הקלדה (תצוגה מקדימה)

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

מידע על חיפוש תוך כדי הקלדה של מדיה

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

ההגדרה של השדה saytCompatible מרחיבה את התכונה "חיפוש תוך כדי הקלדה" לכל אפליקציית חיפוש, ומאפשרת לסמן את שדות הסכימה הספציפיים כדי לענות על שאילתות חלקיות. אפליקציות מדיה יכולות להמשיך להשתמש ב-searchAsYouTypeSpec.condition כמו קודם. אפליקציות שהן לא אפליקציות מדיה צריכות שדות saytCompatible בסכימה.

השלמה אוטומטית וחיפוש תוך כדי הקלדה

התכונה "חיפוש תוך כדי הקלדה" שונה מהשלמה אוטומטית:

  • ההשלמה האוטומטית חוזה מחרוזות של שאילתות, והיא מופעלת על ידי הגדרת השדה completable.
  • התכונה Search-as-you-type מחזירה מסמכים מדורגים, והיא מופעלת על ידי הגדרת השדה saytCompatible.

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

מגבלות

הפיכת שדות לsaytCompatible כפופה למגבלות הבאות:

  • אי אפשר לסמן יותר משלושה שדות בכל סכימה בתור saytCompatible. אם תגדירו שדה רביעי, ה-API יחזיר את השגיאה INVALID_ARGUMENT כשתתקנו את הסכימה.
  • הערך saytCompatible תקף רק בשדות מסוג string. אם מגדירים את המאפיין בשדות number,‏ integer,‏ boolean,‏ object או datetime, ה-API מחזיר שגיאת INVALID_ARGUMENT.
  • רק 12 הטוקנים הראשונים של ערך השדה נוספים לאינדקס, וכל טוקן תורם חלקי קידומת עד 10 התווים הראשונים שלו. ערכים ארוכים יותר עדיין נוספים לאינדקס, אבל אי אפשר להגיע לסוף שלהם באמצעות קידומת.

עדכון הסכימה והוספה מחדש לאינדקס

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

עדכון הסכימה של "חיפוש תוך כדי הקלדה"

כדי לסמן שדות כ-saytCompatible באמצעות השיטה projects.locations.dataStores.schemas.patch, מבצעים את הפעולות הבאות:

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

  2. פועלים לפי ההוראות לעדכון הסכימה באופן פרוגרמטי. מגדירים את saytCompatible ל-true בשדות שרוצים להפעיל בשביל התכונה, כמו בדוגמה הזו:

    "title": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
     "channel_name": {
       "type": "string",
       "retrievable": true,
       "saytCompatible": true
     },
    

    בדוגמה הזו, השדות title ו-channel_name מסומנים כ-saytCompatible. אם מגדירים את saytCompatible בשדה שהסוג שלו הוא לא string, ה-API מחזיר שגיאת INVALID_ARGUMENT. כך גם אם מגדירים את ביותר משלושה שדות בסכימה.

  3. מחכים עד שההוספה מחדש לאינדקס תסתיים.

שליחת בקשת חיפוש בזמן ההקלדה

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

כדי לשלוח בקשת חיפוש תוך כדי הקלדה:

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

  2. בגוף הבקשה, מגדירים את searchAsYouTypeSpec.condition לערך ENABLED. הפעולה הזו מפעילה את התכונה "חיפוש בזמן ההקלדה" בבקשה.

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

    • ‫fields[i].key: שדה סכימה שמסומן כ-saytCompatible. הפניה לשדה שאינו saytCompatible לא מחזירה תרומה של חיפוש תוך כדי הקלדה מהשדה הזה.
    • ‫fields[i].weight: החשיבות היחסית של השדה בציון של "חיפוש תוך כדי הקלדה". ברירת המחדל היא 1.0.
    • ‫scoreThreshold: מסמכים שהציון שלהם בחיפוש תוך כדי הקלדה נמוך מהערך הזה לא נכללים. ברירת המחדל היא ללא סף.
  4. שולחים את הבקשה. בדוגמה הבאה מוצגת הצורה של searchAsYouTypeSpec שמאפשרת חיפוש תוך כדי הקלדה, מגדירה את ההיקף שלו לשני שדות עם משקלים שונים ומגדירה ציון מינימלי:

    "searchAsYouTypeSpec": {
      "condition": "ENABLED",
      "fields": [
        { "key": "title", "weight": 1.2 },
        { "key": "channel_name" }
      ],
      "scoreThreshold": 0.5
    }
    

פרטים על חיפוש תוך כדי הקלדה

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

לוגיקת הנירמול והטוקניזציה

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

  • המרת אותיות רישיות לאותיות קטנות: המערכת ממירה את התווים לאותיות קטנות. כך ההתאמה לא תלוית-רישיות.

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

  • גבולות לכל שדה: רק 12 האסימונים הראשונים של ערך השדה נוספים לאינדקס של "חיפוש תוך כדי הקלדה". כל אחד מהאסימונים האלה תורם קטעי קידומת עד 10 התווים הראשונים שלו.

דוגמה

אם השדה actor_name מסומן כ-saytCompatible ולמסמך יש את הערך Christian Bale, שאילתה של chr מגיעה למסמך דרך קטע הקידומת באורך 3 של האסימון christian, והרחבת השאילתה ל-chris עדיין תואמת דרך קטע הקידומת באורך 5. השאילתה bale תואמת גם היא, באמצעות קטע הקידומת באורך 4 של האסימון השני בערך השדה. הדירוג מתעדכן בכל הקשה על מקש בזמן שהמשתמש מקליד.

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