ניהול מודלים

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

המלצות כלליות לגבי איכות המודל

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

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

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

רוב המודלים מניבים את הביצועים הכי טובים עם נתונים של צפיות בדפי מוצרים, צפיות בדף הבית ואירועי add-to-cart לפחות במשך שלושה חודשים.

למודל 'נקנים ביחד לעיתים קרובות', מומלץ להשתמש בהיסטוריית רכישות של שנה עד שנתיים. במודל הזה נדרש אחד מהדברים הבאים:

  • בממוצע, 10 מקרים לכל פריט בקטלוג (עם חלון של שנה של אירועים מסוג purchase-complete).

  • גם 90 ימים של אירועי השלמת רכישה בשנה האחרונה וגם 1,000 אירועי השלמת רכישה באותה שנה.

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

כוונון מודל

המודל של AI Commerce Search משתמש בנתוני הקלט שאתם מספקים כדי לשנות את ההיפרפרמטרים לאימון.

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

הגדרת תדירות כוונון של מודל

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

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

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

כדי לערוך את הגדרת סטטוס הכוונון של מודל:

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

    אפשר לראות את סטטוס ההתאמה של כל מודל בקטע סטטוס ההתאמה.

  2. לוחצים על שם המודל כדי לראות את דף הפרטים שלו.

  3. לוחצים על עריכה לצד סטטוס ההתאמה.

  4. מהרשימה הנפתחת, בוחרים הגדרה:

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

  5. לוחצים על סיום כדי לשמור את ההגדרה.

curl

שולחים בקשת Models.patch באמצעות ה-API. מידע נוסף מופיע במאמר בנושא הפניית ה-API של Models.patch.

פרטים על כל השדות של Models מופיעים בModels הפניית ה-API.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
  "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

שיפור מודל באופן ידני

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

כדי לכוונן מודל באופן ידני:

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

  2. לוחצים על שם המודל כדי לראות את דף הפרטים שלו.

  3. לוחצים על התאמה ידנית בסרגל הלחצנים.

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

curl

שולחים בקשת Models.tune באמצעות ה-API. מידע נוסף מופיע במאמר בנושא הפניית ה-API של Models.tune.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

השהיה והמשך של אימון מודל

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

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

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

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

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

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

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

  2. כדי להשהות מודל פעיל (סטטוס ההדרכה הוא הדרכה), לוחצים על השהיה .

  3. כדי להפעיל מודל שהושהה (סטטוס האימון הוא PAUSED), לוחצים על המשך .

curl

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

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

כדי להפעיל מודל מושהה, שולחים בקשת Models.resume באמצעות ה-API.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

הצגת פרטי המודל

אפשר לראות את פרטי המודל במסוף או באמצעות ה-method Models.get API.

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

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

  2. בדף Models (מודלים) מפורטים כל המודלים וסטטוס האימון והשאילתות שלהם.

  3. לוחצים על שם המודל כדי לראות את דף הפרטים שלו.

curl

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

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

הצגת רשימת המודלים

אפשר לראות רשימה של המודלים במסוף או באמצעות שיטת Models.list API.

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

  2. בדף Models (מודלים) מפורטים כל המודלים וסטטוס האימון והשאילתות שלהם.

curl

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

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

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

מחיקת מודל

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

מחיקת מודל במסוף או באמצעות שיטת ה-API‏ Models.delete.

המסוף

  1. עוברים לדף Models (מודלים) במסוף AI Commerce Search ב-Gemini Enterprise for Customer Experience.

    כניסה לדף Models

  2. לוחצים על שם המודל שרוצים למחוק כדי לפתוח את דף הפרטים שלו.

  3. לוחצים על מחיקה בסרגל הלחצנים.

  4. מזינים מחדש את שם המודל ולוחצים על אישור.

curl

שולחים בקשת Models.delete באמצעות ה-API. מידע נוסף מופיע במאמר בנושא הפניית ה-API של Models.delete.

פרטים על כל השדות של Models מופיעים בModels הפניית ה-API.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'