בניית מודלים של הפעלה

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

  • הפעלה ראשית – זוהי ההפעלה היחידה שנדרשת לפרויקט Actions. משתמשים אומרים ביטוי שדומה ל-"Ok Google, talk to <display name>" כדי להתאימן לכוונה הזו. בדרך כלל, ההנחיה הזו מברכת את המשתמש עם הודעת פתיחה.

  • הפעלות של קישורי עומק – הפעלות אופציונליות שמאפשרות להגדיר ביטויי אימון לפי כוונה מותאמת אישית, כדי שהמשתמשים יוכלו לבצע קישור עומק לחלק ספציפי בשיחה. משתמשים יכולים לומר ביטוי שדומה למילה "Ok Google, talk to <display name> to <deep linkhref>" כדי להתאים לסוגי הכוונות האלו (לדוגמה, "Ok Google, הסבר על עובדות על Google כדי לקבל עובדות על החברה")

  • אובייקטים מובנות מסוג Intent – הפעלות אופציונליות שמאפשרות לכם להשתמש במודלים של הפעלה שמוגדרים על ידי המערכת. באמצעות הצהרה על תמיכה ב-Intent מובנה, המשתמשים יכולים לגלות ולהפעיל את פרויקט Actions בלי לציין את השם המוצג. לדוגמה, משתמשים יכולים לומר "Ok Google, play a game", ו-Google Assistant יכולה להציג את הפעולה כאפשרות להפעלה.

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

יוצרים את ההפעלה הראשית

לכל פרויקט פעולות יש פתיחה ראשית שמוגדרת כברירת מחדל, שמשמשת כנקודת ברירת המחדל לכניסה לפרויקט הפעולות.מודל השפה להפעלה הזאת משויך לשם המוצג של הפרויקט, ולכן המשתמשים צריכים רק להגיד משפט שדומה ל-"Ok Google, tell to <display name> " כדי להשתמש בהפעלה הזו. כשמשתמשים מפעילים את הפעולות באופן הזה, זמן הריצה של Assistant תואם לכוונת המערכת של actions.intent.MAIN.

כדי ליצור את ההפעלה הראשית:

כדי ליצור הפעלות של קישורי עומק, צריך ליצור כוונות משתמש גלובליות באמצעות ביטויי אימון שמגדירים את קלט המשתמש שאתם רוצים להגדיר לקישור העומק. משתמשים אומרים את שם התצוגה בשילוב עם הביטוי של קישור העומק, כדי להפעיל קישור עומק (לדוגמה, "Ok Google, tell to <display name> to <deep link language>")

יצירת הפעלות משתמעות

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

טיפול באירועי הפעלה

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

הפעלה של תגובה לפעולה מאתר אחר (webhook)

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

הנחיות

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

כדי לטפל בהתאמת Intent של הפעלה באמצעות הנחיה:

מעבר לסצנה

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