REST Resource: projects.locations.collections.dataStores.servingConfigs

משאב: ServingConfig

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

ייצוג ב-JSON 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "answerGenerationSpec": {
    object (AnswerGenerationSpec)
  },

  // Union field vertical_config can be only one of the following:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of list of possible types for union field vertical_config.
}
שדות
name

string

אי אפשר לשנות. שם ייחודי מלא projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

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

השדה הזה חייב להיות מחרוזת בקידוד UTF-8, עם מגבלת אורך של 128 תווים. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.
solutionType

enum (SolutionType)

חובה. אי אפשר לשנות. מציין את סוג הפתרון שאפשר לשייך אליו הגדרת תצורה להצגת מודעות.
modelId

string

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

חובה אם הערך של SolutionType הוא SOLUTION_TYPE_RECOMMENDATION.
diversityLevel

string

מידת הגיוון שבה רוצים להשתמש בתוצאות של מודל ההמלצות, למשל medium-diversity או high-diversity. ערכים נתמכים כרגע:

  • no-diversity
  • low-diversity
  • medium-diversity
  • high-diversity
  • auto-diversity

אם לא מציינים, אנחנו בוחרים ברירת מחדל על סמך סוג מודל ההמלצות. ערך ברירת המחדל: no-diversity.

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_RECOMMENDATION.
rankingExpression

string

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

ביטוי הדירוג הוא פונקציה אחת או כמה פונקציות שמחוברות באמצעות '+'.

  • rankingExpression = function, { " + ", function };

פונקציות נתמכות:

  • ‫double * relevanceScore
  • ‫double * dotProduct(embedding_field_path)

משתני פונקציה:

  • ‫relevanceScore: מילות מפתח מוגדרות מראש, שמשמשות למדידת הרלוונטיות בין השאילתה למסמך.
  • embedding_field_path: שדה הטמעת המסמך שמשמש עם וקטור הטמעת השאילתה.
  • ‫dotProduct: פונקציית הטמעה בין embedding_field_path לבין וקטור ההטמעה של השאילתה.

ביטוי הדירוג לדוגמה:

אם במסמך יש שדה הטמעה doc_embedding, ביטוי הדירוג יכול להיות 0.5 * relevanceScore + 0.3 * dotProduct(doc_embedding).
createTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של יצירת ServingConfig.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון של ServingConfig.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
filterControlIds[]

string

אמצעי בקרה של מסננים לשימוש בנתיב ההצגה. כל אמצעי הבקרה של המסננים שהופעלו יחולו. אמצעי הבקרה של המסננים צריכים להיות באותו מאגר נתונים כמו הגדרת ההצגה. אפשר להוסיף עד 20 אמצעי בקרה של מסננים.
boostControlIds[]

string

אמצעי בקרה לשיפור הביצועים לשימוש בנתיב הצגת המודעות. המערכת תחיל את כל אמצעי הבקרה להגברת התנועה שהופעלו. אמצעי הבקרה להגברת התנועה חייבים להיות באותו מאגר נתונים כמו הגדרת ההצגה. אפשר להוסיף עד 20 אמצעי בקרה להגברת התנועה.
redirectControlIds[]

string

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

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_SEARCH.
synonymsControlIds[]

string

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

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_SEARCH.
onewaySynonymsControlIds[]

string

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

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_SEARCH.
dissociateControlIds[]

string

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

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_SEARCH.
replacementControlIds[]

string

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

אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_SEARCH.
ignoreControlIds[]

string

מפרטים של התעלמות מתנאים. אם כמה תנאי התעלמות תואמים, כל אמצעי הבקרה התואמים להתעלמות ברשימה יופעלו. הסדר לא משנה. מספר המפרטים המקסימלי הוא 100.
promoteControlIds[]

string

מפרט של מבצעים עם תנאי.

מספר המפרטים המקסימלי הוא 100.
answerGenerationSpec

object (AnswerGenerationSpec)

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

object (MediaConfig)

ה-MediaConfig של הגדרת ההצגה.
genericConfig

object (GenericConfig)

‫GenericConfig של הגדרת ההצגה.

MediaConfig

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

  • ‫demote_content_watched: ערך הסף להורדת הדירוג של תוכן שנצפה. הלקוחות יכולים לציין אם להשתמש בהורדה של תוכן שנצפה או להשתמש בדף פרטים שנצפה. כדי להשתמש בהורדה בדרגה של תוכן שנצפה, הלקוחות צריכים לציין את מספר הדקות או את אחוז הצפייה שמעל הסף. אם התוכן יעבור את הסף, הוא יורד בדרגה בתוצאת ההמלצה.
  • ‫promote_fresh_content: מספר הימים שבהם תוכן חדש מקודם. הלקוחות יכולים לציין אם הם משתמשים במבצע על תוכן עדכני. אם התוכן פורסם בתוך ימי המינימום, הוא יקודם בתוצאות ההמלצות. אפשר להגדיר את הערך הזה רק אם SolutionType הוא SOLUTION_TYPE_RECOMMENDATION.
ייצוג ב-JSON 
{
  "demotionEventType": string,
  "demoteContentWatchedPastDays": integer,
  "contentFreshnessCutoffDays": integer,

  // Union field demote_content_watched can be only one of the following:
  "contentWatchedPercentageThreshold": number,
  "contentWatchedSecondsThreshold": number
  // End of list of possible types for union field demote_content_watched.
}
שדות
demotionEventType

string

מציין את סוג האירוע שמשמש להורדת דירוג של תוצאת המלצה. ערכים נתמכים כרגע:

  • ‫view-item: הפריט נצפה.
  • ‫media-play: הפעלה או המשך של צפייה בסרטון, הפעלה של שיר וכו'.
  • ‫media-complete: סיימו לצפות בסרטון, להאזין לשיר וכו' או הפסיקו באמצע.

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

integer

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

integer

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

number

מציין את אחוז הצפייה בתוכן שמעל סף ההורדה בדרגה. ערך הסף חייב להיות בין 0 ל-1.0 (כולל).
contentWatchedSecondsThreshold

number

מציין את סף דקות הצפייה בתוכן לצורך הורדת דירוג.

GenericConfig

מציינת את ההגדרות שנדרשות ל-Generic Discovery.נכון לעכשיו, אנחנו תומכים ב:

  • ‫contentSearchSpec: הגדרה לחיפוש כללי של תוכן.
ייצוג ב-JSON 
{
  "contentSearchSpec": {
    object (ContentSearchSpec)
  }
}
שדות
contentSearchSpec

object (ContentSearchSpec)

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

AnswerGenerationSpec

המפרט ליצירת תשובות.

ייצוג ב-JSON 
{
  "userDefinedClassifierSpec": {
    object (UserDefinedClassifierSpec)
  }
}
שדות
userDefinedClassifierSpec

object (UserDefinedClassifierSpec)

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

UserDefinedClassifierSpec

המפרט של מסווג שהוגדר על ידי המשתמש.

ייצוג ב-JSON 
{
  "enableUserDefinedClassifier": boolean,
  "preamble": string,
  "modelId": string,
  "taskMarker": string,
  "topP": number,
  "topK": string,
  "temperature": number,
  "seed": integer
}
שדות
enableUserDefinedClassifier

boolean

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

string

זה שינוי אופציונלי. ההקדמה שתשמש לסיווג שהוגדר על ידי המשתמש.
modelId

string

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

string

זה שינוי אופציונלי. סמן המשימה שישמש לסיווג שהוגדר על ידי המשתמש.
topP

number

זה שינוי אופציונלי. ערך ה-top-p שישמש לסיווג שהוגדר על ידי המשתמש.
topK

string (int64 format)

זה שינוי אופציונלי. ערך ה-k העליון שישמש לסיווג שהוגדר על ידי המשתמש.
temperature

number

זה שינוי אופציונלי. ערך רמת האקראיות שישמש למסווג שהוגדר על ידי המשתמש.
seed

integer

זה שינוי אופציונלי. ערך ה-seed שישמש לסיווג שהוגדר על ידי המשתמש.

Methods

answer

 שיטת מענה לשאילתה.

create

 יוצר ServingConfig.

delete

 מחיקת ServingConfig.

get

 מקבל ServingConfig.

list

 רשימה של כל אובייקטי ServingConfig שמקושרים ל-DataStore הזה.

patch

 עדכון של ServingConfig.

recommend

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

searchLite

 מבצע חיפוש.

streamAnswer

 שיטת מענה לשאילתה (סטרימינג).