אובייקטים מסוג 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 של בית חכם
אם אתם בונים פעולה בבית חכם, התמיכה בכוונות היא קצת שונה. למידע נוסף, עיינו במסמכי התיעוד בנושא כוונות לבית חכם.