פעולות שיחה

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

סקירה כללית

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

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

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

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

הפעלה

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

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

• "Ok Google, לדבר עם עובדות על Google"
• "Ok Google, לדבר עם עובדות על Google כדי להשיג עובדות של החברה"
• "Ok Google, לדבר עם עובדות על Google כדי לקבל עובדות על ההיסטוריה"

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

איור 2. דוגמה להפעלה העיקרית

איור 2 מתאר את תהליך ההפעלה הראשי הטיפוסי:

1. כשמשתמשים מבקשים פעולה, הם בדרך כלל מבקשים מ-Assistant לעשות זאת לפי השם המוצג שלכם.
2. Assistant תואמת לבקשה של המשתמש עם הכוונה המתאימה שתואמת לבקשה. במקרה כזה הערך יהיה actions.intent.MAIN.
3. הפעולה מקבלת הודעה על ההתאמה לכוונה ומגיבות להודעה המתאימה כדי להתחיל שיחה עם המשתמש.

שיחה

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

איור 3. דוגמה לשיחה

איור 3 מתאר פנייה אופיינית לשיחה:

1. כשמשתמשים אומרים משהו, ממשק ה-NLU של Assistant תואם לכוונה המתאימה. כוונה להתאים לכוונה אם מודל השפה של הכוונה הזו יכול להיות זהה או מדויק לקלט של משתמש. כדי להגדיר את מודל השפה, צריך לציין ביטויים לאימון או דוגמאות לדברים שהמשתמשים ירצו לומר. Assistant משתמשת במשפטי האימון האלה ומרחיבה אותם כדי ליצור את מודל השפה של הכוונה.
2. כאשר ה-NLU של Assistant תואם לכוונה, הוא יכול לחלץ פרמטרים מהקלט. לפרמטרים האלה משויכים סוגים, כמו תאריך או מספר. אתם מוסיפים הערות לחלקים ספציפיים במשפטי האימון של כוונה, כדי לציין את הפרמטרים שאתם רוצים לחלץ.
3. מסך ולאחר מכן מעבד את הכוונה המותאמת. אפשר לחשוב על סצנות כפעולות הלוגיות של ביצוע פעולה, תוך ביצוע העבודה הקשה והפעלת הלוגיקה הנדרשת כדי לקיים שיחה. הסצנות פועלות בלופ, ומספקות מחזור חיים גמיש של ביצוע שמאפשר לבצע פעולות כמו לאמת פרמטרים של כוונה, לבצע מילוי משבצות, לשלוח הודעות בחזרה למשתמש ועוד.
4. בדרך כלל, כשסצינה מסתיימת, היא שולחת למשתמשים הנחיה להמשיך את השיחה או לסיים אותה לפי הצורך.

טיפול בהזמנות

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

איור 4. דוגמה לשיחה

איור 4 שמתאר איך אפשר להשתמש בתכונה 'מילוי הזמנות' כדי ליצור בקשות, דרך נפוצה לשימוש במילוי הזמנות:

1. בנקודות מסוימות של ביצוע הפעולה, היא יכולה להפעיל webhook ששולח בקשה ל-handler רשום ל-webhook (שירות המשלוחים) עם מטען ייעודי (payload) בפורמט JSON.
2. מילוי הבקשה שלכם מעבד את הבקשה, למשל קריאה ל-API ל-REST כדי לבצע חיפוש נתונים או אימות נתונים מסוימים מהמטען הייעודי (payload) של JSON. אחת מהדרכים הנפוצות ביותר להשתמש במילוי הזמנות היא ליצור הודעה דינמית בזמן הריצה, כדי שהשיחות יותאמו יותר למשתמש הנוכחי.
3. מילוי ההזמנה מחזיר פעולה לביצוע, שמכילה מטען ייעודי (payload) של JSON. ניתן להשתמש בנתונים מהמטען הייעודי (payload) כדי להמשיך את ביצוע הטופס ולהגיב למשתמש.