סקירה כללית של כוונות (Dialogflow)

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

  • על ידי מילוי כוונה
  • באמצעות בקשה מ-Google Assistant למלא כוונה.

התהליך שבו מספקים מילוי של Intent שונה למפתחים Build with Dialogflow ולמפתחים שיוצרים באמצעות Actions SDK. עם זאת, בשני המקרים, תספקו את שם הכוונה ואת כתובת ה-URL של ה-webhook למילוי הזמנות. כך תבהירו ל-Actions on Google שאתם יכולים לתמוך בשאילתות משתמשים שתואמות ל-Intent.

כדי לבקש מימוש של Intent, צריך לציין את הכוונה באובייקט possibleIntents כשאתם מגיבים ל-Assistant. בבקשה שתשלחו לאחר מכן, Assistant תחזיר לכם את התוצאה של הכוונה המעובדת. למידע נוסף, כדאי לקרוא את הסקירה הכללית על שימוש במרכז העזרה.

כוונות נפוצות

בטבלה הבאה מתוארות כוונות ש-Assistant מבקשת מכם למלא.

שם Intent Usage אירוע ב-Dialogflow
actions.intent.MAIN חובה: כל חבילת פעולות מצהירה על Intent אחד בלבד, שמאפשר למשתמשים להתחיל שיחות. WELCOME או GOOGLE_ASSISTANT_WELCOME
actions.intent.TEXT לקבל ייצוג טקסט גולמי של בקשת המשתמש. האפשרות הזו נמצאת בשימוש ברוב הזמן במהלך שיחה עם משתמשים.
actions.intent.CANCEL אפשר לקבל את הכוונה הזו אם מביעים הסכמה לקבל כוונות ביטול בחבילת הפעולות. כשמשתמשים אומרים פקודת ביטול גלובלית כמו "quit", הכוונה הזו מתקבלת בבקשה הבאה למילוי הבקשה, כך שאתם יכולים להשיב בהודעה האחרונה ולבצע ניקוי בנתונים בלוגיקה של מילוי הבקשה. actions_intent_CANCEL
actions.intent.NO_INPUT אפשר לקבל את הכוונה הזו אם מביעים הסכמה לקבל אובייקטים מסוג Intent ללא קלט בחבילת הפעולות. אם משתמשים לא משיבים לבקשה, הכוונה הזו מתקבלת בבקשה הבאה למילוי הבקשה. actions_intent_NO_INPUT

עוזרים

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

שם Intent Usage אירוע ב-Dialogflow
actions.intent.PERMISSION עליכם לציין את השם המלא, המיקום המשוער או המיקום המדויק של המשתמש, או את כל ה-3. actions_intent_PERMISSION
actions.intent.OPTION קבלת הפריט שנבחר מממשק משתמש של רשימה או קרוסלה. לחלופין, אם המשתמש לא בוחר מהרשימה או מממשק המשתמש של הקרוסלה, המערכת תקבל קלט דיבור או טקסט שתואם למפתח ברשימה או בממשק המשתמש של הקרוסלה. actions_intent_OPTION
actions.intent.DATETIME מבקשים קלט של תאריך ושעה מהמשתמש. actions_intent_DATETIME
actions.intent.SIGN_IN נשלחת בקשה לתהליך קישור חשבון כדי לקשר חשבון של משתמש. actions_intent_SIGN_IN
actions.intent.PLACE קבלת כתובת או מיקום שמור מהמשתמש. actions_intent_PLACE
actions.intent.CONFIRMATION עליך לקבל אישור מהמשתמש (לדוגמה, תשובה לשאלות של כן או לא). actions_intent_CONFIRMATION
actions.intent.NEW_SURFACE מבקשת מהמשתמש הרשאה להעביר את השירות לפלטפורמה אחרת של Assistant. actions_intent_NEW_SURFACE

אובייקטים מובנים של Intent

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

כוונות נוספות

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

עוזרים בביצוע עסקאות

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

שם Intent Usage אירוע ב-Dialogflow
actions.intent.DELIVERY_ADDRESS מבקשים מהמשתמש קלט של כתובת למשלוח. actions_intent_DELIVERY_ADDRESS
actions.intent.TRANSACTION_REQUIREMENTS_CHECK לבדוק אם אתם עומדים בכל הדרישות לעסקה. actions_intent_TRANSACTION_REQUIREMENTS_CHECK
actions.intent.TRANSACTION_DECISION המערכת שואלת את המשתמש אם העסקה צריכה להתבצע. actions_intent_TRANSACTION_DECISION
actions.intent.DIGITAL_PURCHASE_CHECK מאמת את תצורת הטרנזקציה של המשתמש. השירות משמש למניעת הצעת מוצרים דיגיטליים למשתמשים שהעסקה תיכשל. actions_intent_DIGITAL_PURCHASE_CHECK
actions.intent.COMPLETE_PURCHASE מתחיל בקשת רכישה. תוצאות של תוצאת רכישה שמתארות אם העסקה הצליחה או נכשלה, ובאיזה אופן. actions_intent_COMPLETE_PURCHASE

כוונות המעורבות של המשתמשים

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

שם Intent מספקים מילוי הזמנות בקשת מילוי בקשה Usage אירוע ב-Dialogflow
actions.intent.REGISTER_UPDATE X המשתמש מתבקש להירשם לעדכונים. actions_intent_REGISTER_UPDATE
actions.intent.CONFIGURE_UPDATES X הכוונה מופיעה כאשר המשתמש מנסה להירשם לעדכונים (כלומר, יש לשלוח Intent מסוג REGISTER_UPDATE). actions_intent_CONFIGURE_UPDATES

קהלים בהתאמה אישית עם כוונת רכישה

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

למידע נוסף, קראו את המאמר הגדרת פעולות ב-Dialogflow או שימוש ב-Actions SDK. מידע נוסף על חבילות פעולות זמין בחומר העזר בנושא חבילות פעולות.

Intents של בית חכם

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