- משאב: ChannelConfig
- ייצוג ב-JSON
- OperationsConfig
- UpsellStrategy
- UpsellConfig
- GreetingOffer
- OfferMessage
- MessageConfig
- ClosingOffer
- ClosingMessage
- CelUpsell
- SuggestedModifierGroup
- שלום
- FeaturesConfig
- OrderPickup
- OrderDineIn
- NameCollection
- GetOrderPrices
- EndSessionWithCheckoutRequest
- EnableAddressCollection
- SupportCashPayment
- InteractionMode
- DisambiguationStrategy
- DisambiguationMapping
- סוג
- TargetItem
- TargetModifier
- מדינה
- סוג
- SupplementalInstructions
- טון
- Methods
משאב: ChannelConfig
הגדרת ערוץ מייצגת הגדרה של אסטרטגיה תפעולית. מחזור החיים של הגדרת הערוץ: * טיוטה: הגדרה נמצאת במצב טיוטה כשאין לה כללי יישום של הגדרות משויכים והיא לא מוגדרת כברירת המחדל של המותג. * ACTIVE: הגדרה נמצאת במצב פעיל כשהיא משויכת לכלל כלשהו של אפליקציית הגדרות או מוגדרת כברירת המחדל של המותג. * כשהוא פעיל, זמן הריצה מחיל את הגדרת הערוץ על החנויות התואמות. כדי להבטיח גמישות, הקשר בין הגדרת הערוץ לבין כלל החלת ההגדרות הוא אחד לרבים בכל רמת משאב: * ברמת המותג, יש קשר של אחד לרבים בין הגדרות הערוץ לבין כללי החלת ההגדרות. * ברמת החנות, יש עוד קשר של אחד לרבים בין הגדרות הערוצים לבין כללי החלת ההגדרות. אם אפשר להחיל כמה הגדרות של ערוצים, זמן הריצה קובע איזו הגדרה להחיל לפי סדר העדיפות הבא (האחרון מבטל את הקודם במקרה של התנגשות): 1. ברירת מחדל 2 ברמת המותג. קישור ברמת המותג 3. ברירת המחדל ברמת החנות היא 4. קישור ברמת החנות
| ייצוג ב-JSON |
|---|
{ "name": string, "displayName": string, "createTime": string, "updateTime": string, "operationsConfig": { object ( |
| שדות | |
|---|---|
name |
מזהה. שם הגדרת הערוץ. פורמט: projects/{project}/locations/{location}/brands/{brand}/channelConfigs/{channelConfig} |
displayName |
זה שינוי אופציונלי. שם תצוגה אופציונלי להגדרת הערוץ הזו בממשקי משתמש. הערך מוגבל ל-63 תווים. |
createTime |
פלט בלבד. השעה שבה נוצרה הגדרת הערוץ הזו. השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
updateTime |
פלט בלבד. השעה שבה הגדרת הערוץ עודכנה לאחרונה. השימוש הוא ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות אחרי הנקודה העשרונית. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-Z. לדוגמה: |
operationsConfig |
זה שינוי אופציונלי. האסטרטגיה התפעולית של הגדרת הערוץ. |
state |
פלט בלבד. הסטטוס של הגדרת הערוץ. |
type |
חובה. סוג הגדרת הערוץ. |
supplementalInstructions |
זה שינוי אופציונלי. הוראות נוספות להגדרת הערוץ. |
tone |
זה שינוי אופציונלי. טון הדיבור של הנציג. |
configApplicationRules[] |
פלט בלבד. כללי הגדרת האפליקציה שמשויכים להגדרת הערוץ הזו. |
OperationsConfig
הגדרות לקביעת אסטרטגיה תפעולית.
| ייצוג ב-JSON |
|---|
{ "displayName": string, "description": string, "upsellStrategy": { object ( |
| שדות | |
|---|---|
displayName |
זה שינוי אופציונלי. השם של האסטרטגיה התפעולית הזו. |
description |
זה שינוי אופציונלי. תיאור של האסטרטגיה התפעולית הזו. |
upsellStrategy |
זה שינוי אופציונלי. הגדרת ההתנהגות של מכירת מוצר או שירות נוסף. |
greetings[] |
זה שינוי אופציונלי. הודעות פתיחה בהתאמה אישית (לכל שפה). |
defaultLanguageCode |
זה שינוי אופציונלי. שפת ברירת המחדל שבה משתמשים כדי לתת שירות ללקוחות. |
featuresConfig |
זה שינוי אופציונלי. הגדרת התכונות של הנציג. |
interactionMode |
זה שינוי אופציונלי. מצב האינטראקציה של הנציג. |
disambiguationStrategy |
זה שינוי אופציונלי. הגדרת האסטרטגיה של בקרת הפגת העמימות. |
UpsellStrategy
מגדיר את האסטרטגיה למכירת מוצר או שירות משודרג (upsell).
| ייצוג ב-JSON |
|---|
{
"maxUpsellOffers": integer,
"maxUpsellDeclines": integer,
"maxItemsInCart": integer,
"upsells": [
{
object ( |
| שדות | |
|---|---|
maxUpsellOffers |
זה שינוי אופציונלי. המספר המקסימלי של הצעות למכירת מוצר או שירות משודרג שיוצגו בכל סשן. |
maxUpsellDeclines |
זה שינוי אופציונלי. מספר הפעמים המקסימלי שלקוח יכול לדחות הצעה לשדרוג לפני שהמערכת תדלג על הצעות נוספות לשדרוג בסשן הנוכחי. |
maxItemsInCart |
זה שינוי אופציונלי. מספר הפריטים המקסימלי שמותר להוסיף לעגלת הקניות לפני שהמערכת תדלג על הצעות נוספות למכירת מוצר או שירות משודרג בסשן הנוכחי. |
upsells[] |
זה שינוי אופציונלי. מכירות ה-upsell שהוגדרו. |
cateringGuidelines |
זה שינוי אופציונלי. מייצג קבוצה של טקסט שמייצג את חישובי ההצגה שנוצרו אופליין ואת כללי ההזמנה הקבוצתית לתפריט הזה. הקראה על ידי מודל ה-LLM לשיחות. |
UpsellConfig
מגדיר את התצורה של מופע מכירת אפסל.
| ייצוג ב-JSON |
|---|
{ "displayName": string, "priority": integer, "skipOnMultiQuantityUpsoldFromItem": boolean, "skipOnPreviousTurnUpsell": boolean, "disabled": boolean, // Union field |
| שדות | |
|---|---|
displayName |
זה שינוי אופציונלי. שם למכירת אפסייל. משמש להצגה בממשק המשתמש, וגם לצבירת מדדים ולניתוח נתונים. |
priority |
חובה. מספר שמייצג את סדר העדיפויות של הגדרת המכירה השדרוגית ביחס לכל שאר ההגדרות של UpsellConfigs ב-UpsellStrategy נתון. המערכת תנסה להציג קודם את הצעות המכירה של UpsellConfigs עם עדיפות גבוהה יותר, ורק אחר כך את אלה עם עדיפות נמוכה יותר.
|
skipOnMultiQuantityUpsoldFromItem |
זה שינוי אופציונלי. אם לדלג על הגדלת המכירה הזו, אם הכמות של הפריט שממנו משדרגים גדולה מ-1. ההגדרה הזו רלוונטית רק לסוגי ה-upsell הבאים: - פריט לקומבו - הגדלת קומבו - תוספת - שתייה בקומבו - הגדלת פריט - וריאציית קומבו - פריט שמופעל |
skipOnPreviousTurnUpsell |
זה שינוי אופציונלי. האם לדלג על הגדלת המכירה הזו, אם התור הקודם בשיחה היה הגדלת מכירה. |
disabled |
זה שינוי אופציונלי. מציין אם סוג המכירה השיווקית מושבת. אם הערך הוא True, לא יוצג ניסיון למכור מוצר או שירות משודרג (upsell). ההגדרה הזו שימושית להשבתת סוג של מכירת אפסל כחלק משינוי של כלל להחלת הגדרות. |
שדה של איחוד upsell_type_config. ההגדרה הספציפית לסוג של מכירת השדרוג. הערך upsell_type_config יכול להיות רק אחד מהבאים: |
|
greetingOffer |
מכירת פריטים ספציפיים כחלק מהודעת הפתיחה של הנציג. |
closingOffer |
להציע פריטים ספציפיים אחרי שהלקוח השלים את ההזמנה. |
celUpsell |
כלל מכירת אפסייל שמוערך באופן דינמי על סמך Common Expression Language (CEL). |
GreetingOffer
מכירת פריטים ספציפיים כחלק מהודעת הפתיחה של הנציג.
| ייצוג ב-JSON |
|---|
{
"messages": [
{
object ( |
| שדות | |
|---|---|
messages[] |
חובה. הודעות פתיחה למכירת מוצר או שירות לא קשור (upsell). |
OfferMessage
הגדרות נפוצות להודעות פתיחה וסגירה של מבצעים.
| ייצוג ב-JSON |
|---|
{
"displayName": string,
"messageFrequency": number,
"upsoldItems": [
string
],
"messageConfigs": [
{
object ( |
| שדות | |
|---|---|
displayName |
זה שינוי אופציונלי. השם שיוצג ויופיע בניתוח הנתונים. |
messageFrequency |
זה שינוי אופציונלי. חלק מהזמן שבו צריך להשתמש בהודעה הזו. לדוגמה: אם הערך של messageFrequency הוא 0.2, ההודעה הזו תוצג ב-20% מהסשנים. אם כל הערכים של messageFrequency לא מוגדרים (0.0), כל הודעה תוצג בשיעור של 1/n מהסשנים, כאשר n הוא מספר האובייקטים מסוג OfferMessage שהוגדרו לסוג המבצע. אם רק חלק מהערכים של messageFrequency מוגדרים, המערכת לא תשתמש ב-OfferMessages עם ערכי messageFrequency שלא הוגדרו. |
upsoldItems[] |
זה שינוי אופציונלי. שמות הפריטים שמוצעים למכירה בהודעה הזו. צריך להגדיר את השדה הזה או את upsoldItemIds, אבל לא את שניהם. |
messageConfigs[] |
חובה. הודעות שיווקיות לפי שפה. |
upsoldItemIds[] |
זה שינוי אופציונלי. המזהים של הפריטים שמוצעים למכירה בהודעה הזו. צריך להגדיר את זה או את upsoldItems, אבל לא את שניהם. |
MessageConfig
הודעה בשפה ספציפית שמשמשת למכירת מוצר או שירות לא קשור (upsell).
| ייצוג ב-JSON |
|---|
{ "languageCode": string, "messageText": string } |
| שדות | |
|---|---|
languageCode |
חובה. קוד השפה שבה ההודעה הזו תוצג. קוד שפה בתקן BCP-47, כמו "en-US" או "fr-CA". |
messageText |
חובה. טקסט ההודעה בשפה ספציפית. |
ClosingOffer
להציע פריטים ספציפיים אחרי שהלקוח השלים את ההזמנה.
| ייצוג ב-JSON |
|---|
{
"closingMessages": [
{
object ( |
| שדות | |
|---|---|
closingMessages[] |
חובה. סגירת המבצעים למכירת מוצרים או שירותים נוספים שרוצים להחיל. |
ClosingMessage
סגירת ההגדרה של הודעת המכירה השיווקית.
| ייצוג ב-JSON |
|---|
{
"offerMessage": {
object ( |
| שדות | |
|---|---|
offerMessage |
חובה. הגדרת הודעת ההצעה. |
skipTerms[] |
זה שינוי אופציונלי. המערכת תדלג על הגדלת המכירה הזו אם אחד מהמונחים האלה מופיע בשם של פריט שכבר נמצא בהזמנה של הלקוח. |
CelUpsell
מייצג כלל שחושב מראש ומגדיר באילו תנאים הקשריים צריך להציע למשתמש באופן יזום מכירת פריטים נוספים.
| ייצוג ב-JSON |
|---|
{
"conditionExpression": string,
"suggestedMenuItems": [
string
],
"triggerReason": string,
"priority": integer,
"suggestedModifiers": [
string
],
"suggestedModifierGroups": [
{
object ( |
| שדות | |
|---|---|
conditionExpression |
חובה. מחרוזת CEL (Common Expression Language) שמוערכת ביחס למצב הסשן הנוכחי ( |
suggestedMenuItems[] |
חובה. השמות הסמנטיים של הפריטים שיוצעו אם הכלל הזה יופעל. |
triggerReason |
זה שינוי אופציונלי. הוראה בשפה טבעית שניתנת למודל ה-LLM לשיחה, שמסבירה למה מתבצעת מכירת השדרוג הזו, כדי שהמודל יוכל לנסח מכירת שדרוג טבעית. לדוגמה: |
priority |
זה שינוי אופציונלי. ה- |
suggestedModifiers[] |
זה שינוי אופציונלי. השמות הסמנטיים של ה-modifiers שיוצעו אם הכלל הזה יופעל. |
suggestedModifierGroups[] |
זה שינוי אופציונלי. קבוצות השינויים שיוצעו אם הכלל הזה יופעל. |
maxModifierPerGroup |
זה שינוי אופציונלי. המספר המקסימלי של הצעות לשינויים בכל קבוצה. |
suggestionOnly |
זה שינוי אופציונלי. לא מכירת אפסל אמיתית, אלא רק כדי להציג למשתמש את האפשרויות המוצעות. |
SuggestedModifierGroup
קבוצת שינויים מוצעת.
| ייצוג ב-JSON |
|---|
{ "name": string, "suggestedModifiers": [ string ] } |
| שדות | |
|---|---|
name |
זה שינוי אופציונלי. השם הסמנטי של קבוצת השינויים. |
suggestedModifiers[] |
זה שינוי אופציונלי. השמות הסמנטיים של המגבילים שיוצעו בקבוצה הזו. |
ברכות
מייצג הודעות פתיחה בשפה ספציפית.
| ייצוג ב-JSON |
|---|
{ "languageCode": string, "greetingPhrases": [ string ] } |
| שדות | |
|---|---|
languageCode |
זה שינוי אופציונלי. קוד השפה של ביטויי הפתיחה. קוד שפה בתקן BCP-47, כמו "en-US" או "fr-CA". |
greetingPhrases[] |
זה שינוי אופציונלי. רשימה של ביטויי ברכה בשפה שצוינה. |
FeaturesConfig
הגדרות של תכונות הנציג. רשימת feature flag שמשמשת ליצירת הוראות וכלים בהתאמה אישית של הסוכן.
| ייצוג ב-JSON |
|---|
{ "orderPickup": { object ( |
| שדות | |
|---|---|
orderPickup |
זה שינוי אופציונלי. הגדרת התכונה "איסוף הזמנה". |
orderDineIn |
זה שינוי אופציונלי. הגדרת התכונה "הזמנה לאכילה במקום". |
nameCollection |
זה שינוי אופציונלי. הגדרת התכונה "איסוף שמות". |
confirmOrderInfoAtStart |
זה שינוי אופציונלי. אם לאשר את פרטי ההזמנה בתחילת הסשן. הוצא משימוש: הוחלף על ידי confirmOrderInfoOnFinalize. |
confirmOrderInfoOnFinalize |
זה שינוי אופציונלי. אם לאשר את פרטי ההזמנה כשמסיימים את ההזמנה. |
getOrderPrices |
זה שינוי אופציונלי. הגדרת התכונה "קבלת מחירי הזמנות". |
endSessionWithCheckoutRequest |
זה שינוי אופציונלי. סיום הסשן עם הגדרת התכונה "בקשה להוצאת פריט". |
enableAddressCollection |
זה שינוי אופציונלי. הפעלת ההגדרה של תכונת איסוף הכתובות למשלוח. |
supportCashPayment |
זה שינוי אופציונלי. תמיכה בהגדרת התכונה "תשלום במזומן". |
budgetBasedOrdering |
זה שינוי אופציונלי. האם להפעיל הזמנה על סמך תקציב. |
OrderPickup
בסוג הזה אין שדות.
הלקוחות יכולים להזמין אוכל לאיסוף עצמי באמצעות הנציג.
OrderDineIn
בסוג הזה אין שדות.
הלקוחות יכולים להזמין אוכל דרך הנציג לאכילה במקום
NameCollection
בסוג הזה אין שדות.
הנציג יכול לאסוף את שם הלקוח במהלך השיחה.
GetOrderPrices
בסוג הזה אין שדות.
הסוכן יכול לקבל את מחירי ההזמנות מהקופה.
EndSessionWithCheckoutRequest
בסוג הזה אין שדות.
הסוכן יכול לסיים את הסשן עם בקשת תשלום.
EnableAddressCollection
בסוג הזה אין שדות.
הנציג יכול לאסוף את הכתובת למשלוח של הלקוח במהלך הסשן.
SupportCashPayment
בסוג הזה אין שדות.
הסוכן יכול לתמוך בתשלום במזומן.
InteractionMode
מצב האינטראקציה של הנציג.
| טיפוסים בני מנייה (enum) | |
|---|---|
INTERACTION_MODE_UNSPECIFIED |
מצב האינטראקציה לא צוין. |
ORDER_TAKING |
הסוכן משתתף בשיחה דו-כיוונית כדי לקבל הזמנות. |
LISTEN_ONLY |
הנציג רק מקשיב ולא מדבר. |
DisambiguationStrategy
הגדרת האסטרטגיה של בקרת הפגת העמימות.
| ייצוג ב-JSON |
|---|
{
"mappings": [
{
object ( |
| שדות | |
|---|---|
mappings[] |
זה שינוי אופציונלי. מיפויי הפגת העמימות שהוגדרו. |
DisambiguationMapping
כלל מיפוי לתיקון מונחים לא חוקיים או להבהרת פריטים לא ברורים.
| ייצוג ב-JSON |
|---|
{ "type": enum ( |
| שדות | |
|---|---|
type |
חובה. סוג הפעולה של כלל הפגת העמימות. |
customerTerms[] |
חובה. אמירות של לקוחות או מחרוזות של קיצורי דרך. כל מונח של לקוח מוגבל ל-100 תווים. |
targets[] |
חובה. פריטים בתפריט היעד עם מבנה מלא להצעה או להבהרה, כולל מגדירים בתצוגת עץ. |
customInstruction |
זה שינוי אופציונלי. הוראות מותנות מותאמות אישית או רמזים לניסוח (אופציונלי). |
סוג
סוג הפעולה של כלל הפגת העמימות.
| טיפוסים בני מנייה (enum) | |
|---|---|
TYPE_UNSPECIFIED |
סוג הכלל לא צוין. |
SINGLE_TARGET |
משמש למיפויים של יעד יחיד (מקשי קיצור, הגדרות של שילובים מותאמים אישית או מילים נרדפות חוקיות). |
INVALID_ITEM |
משמש לפריטים לא חוקיים, לפריטים שחסרים במלאי או למוצרים של מתחרים. |
DISAMBIGUATION |
משמש לקלט לא ברור שדורש הבהרה בין כמה אפשרויות יעד חוקיות. |
TargetItem
יעד חלופי לפריט מובנה.
| ייצוג ב-JSON |
|---|
{
"itemName": string,
"modifiers": [
{
object ( |
| שדות | |
|---|---|
itemName |
חובה. שם הפריט בקטלוג התפריט. |
modifiers[] |
זה שינוי אופציונלי. גורמי שינוי מובְנים שאפשר לצרף ליעד הזה. |
itemId |
זה שינוי אופציונלי. המזהה הייחודי של הפריט בקטלוג התפריט (קישור ישיר אל menu.proto). |
TargetModifier
משתנה מובנה שצריך להחיל על פריט היעד.
| ייצוג ב-JSON |
|---|
{ "modifierName": string, "modifierGroupName": string, "modifierId": string, "modifierGroupId": string } |
| שדות | |
|---|---|
modifierName |
חובה. שם השינוי שתואם ישירות לרשומה בקטלוג. |
modifierGroupName |
זה שינוי אופציונלי. שם אופציונלי של קבוצת שינויים כדי לקשר את השינוי. |
modifierId |
זה שינוי אופציונלי. המזהה הייחודי של השינוי בקטלוג התפריט (קישור ישיר אל menu.proto). |
modifierGroupId |
זה שינוי אופציונלי. המזהה הייחודי של קבוצת השינויים בקטלוג התפריט. |
מדינה
הסטטוס של הגדרת הערוץ.
| טיפוסים בני מנייה (enum) | |
|---|---|
STATE_UNSPECIFIED |
הסטטוס לא צוין. |
DRAFT |
הגדרת הערוץ היא טיוטה ועדיין לא מוכנה לשימוש. |
ACTIVE |
הגדרת הערוץ פעילה ואפשר להשתמש בה. |
PROMOTED |
הגדרת הערוץ מקודמת. |
סוג
סוג הגדרת הערוץ.
| טיפוסים בני מנייה (enum) | |
|---|---|
TYPE_UNSPECIFIED |
לא צוין סוג. |
UPSELL_STRATEGY |
הגדרת הערוץ מיועדת לאסטרטגיית מכירת מוצר או שירות נוסף (upsell). |
AGENT_CUSTOMIZATION |
הגדרת הערוץ מיועדת להתאמה אישית של הנציג. |
SupplementalInstructions
הגדרות להוראות נוספות.
| ייצוג ב-JSON |
|---|
{ "freeformInstructions": string } |
| שדות | |
|---|---|
freeformInstructions |
זה שינוי אופציונלי. הוראות חופשיות שכלולות בהנחיה. |
טון
טון הדיבור של הנציג.
| טיפוסים בני מנייה (enum) | |
|---|---|
TONE_UNSPECIFIED |
הטון לא צוין. |
CONCISE_AND_DIRECT |
הסוכן עונה בצורה תמציתית וישירה. |
PROFESSIONAL_AND_FORMAL |
הטון של הנציג מקצועי ורשמי. |
FRIENDLY |
הטון של הסוכן ידידותי. |
Methods |
|
|---|---|
|
יוצר ChannelConfig. |
|
מחיקת ה-ChannelConfig שצוין. |
|
מקבל ChannelConfig. |
|
הצגת רשימה של ChannelConfigs. |
|
עדכון של ChannelConfig שצוין. |
|
מקדם את הגדרת הערוץ שצוינה. |