Scene

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

ייצוג YAML 
onEnter: 
  object (EventHandler)
intentEvents: 
  - object (IntentEvent)
conditionalEvents: 
  - object (ConditionalEvent)
slots: 
  - object (Slot)
onSlotUpdated: 
  object (EventHandler)
שדות
onEnter

object (EventHandler)

handler להפעיל כשעוברים לסצנה הזו.
intentEvents[]

object (IntentEvent)

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

object (ConditionalEvent)

רשימת האירועים להפעלה על סמך הצהרות מותנות. המערכת מבצעת הערכה אחרי מילוי הטופס או מיד אחרי on_load אם אין טופס בסצנה הזו (ההערכה מתבצעת רק פעם אחת). רק האירוע התואם הראשון יופעל.
slots[]

object (Slot)

רשימה של משבצות זמן ממוינות. כל יחידת קיבולת (Slot) מגדירה את סוג הנתונים שהיא תזהה ותצורה שלה כדי להתאים אישית את חוויית הרזולוציה הזו (למשל, הנחיות).
onSlotUpdated

object (EventHandler)

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

משבצת

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

ייצוג YAML 
name: string
type: 
  object (ClassReference)
required: boolean
promptSettings: 
  object (PromptSettings)
commitBehavior: 
  object (CommitBehavior)
config: value
defaultValue: 
  object (DefaultValue)
שדות
name

string

חובה. השם של המשבצת.
type

object (ClassReference)

חובה. מצהירה על סוג הנתונים במשבצת הזו.
required

boolean

זה שינוי אופציונלי. השדה הזה מציין אם צריך למלא את המשבצת לפני ההתקדמות. המשבצות הנדרשות שלא ימולאו יקפיצו למשתמש הנחיה מותאמת אישית.
promptSettings

object (PromptSettings)

זה שינוי אופציונלי. רושם הנחיות לשלבים שונים של מילוי יחידות קיבולת (Slot).
commitBehavior

object (CommitBehavior)

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

value (Value format)

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

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

{ "@type": "type.googleapis.com/ google.actions.transactions.v3.CompletePurchaseValueSpec", "skuId": { "skuType": "SKU_TYPE_IN_APP", "id": "$session.params.userSelectedSkuId", "packageName": "com.example.company" } }
defaultValue

object (DefaultValue)

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

PromptSettings

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

ייצוג YAML 
initialPrompt: 
  object (EventHandler)
noMatchPrompt1: 
  object (EventHandler)
noMatchPrompt2: 
  object (EventHandler)
noMatchFinalPrompt: 
  object (EventHandler)
noInputPrompt1: 
  object (EventHandler)
noInputPrompt2: 
  object (EventHandler)
noInputFinalPrompt: 
  object (EventHandler)
שדות
initialPrompt

object (EventHandler)

להציג בקשה לערך של מיקום המשבצת עצמו. לדוגמה: "באיזה גודל רצית?"
noMatchPrompt1

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

object (EventHandler)

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

CommitBehavior

הודעה שמתארת את התנהגות השמירה שמשויכת למשבצת אחרי שהיא מולאה.

ייצוג YAML 
writeSessionParam: string
שדות
writeSessionParam

string

פרמטר הסשן שיכתוב את הערך של מיקום המודעה אחרי שהוא ממולא. שימו לב: בשלב זה אין תמיכה בנתיבים בתצוגת עץ. "$$" משמש לכתיבה של ערך המיקום לפרמטר של סשן שיש לו שם זהה לזה של מיקום המשבצת. לדוגמה: WriteSessionParam = "fruit" תואם ל- "$session.params.fruit". WritesessionParam = "ticket" תואם ל-"$session.params.ticket".

DefaultValue

הגדרה לאכלוס ערך ברירת מחדל למשבצת הזו.

ייצוג YAML 
sessionParam: string
constant: value
שדות
sessionParam

string

זה שינוי אופציונלי. פרמטר הסשן שישמש לאתחול ערך מיקום המשבצת, אם יש לו ערך שאינו ריק. הסוג של הערך חייב להתאים לסוג של המשבצת. שימו לב: בשלב זה אין תמיכה בנתיבים בתצוגת עץ. לדוגמה: sessionParam = "fruit" תואם ל-$session.params.fruit. sessionParam = "ticket" תואם אל $session.params.ticket.
constant

value (Value format)

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