דפים

אפשר לתאר ולדמיין שיחה (סשן) ב-Dialogflow CX כמכונת מצבים. המצבים של סשן מיוצגים על ידי דפים.

לכל זרימה, מגדירים הרבה דפים, והדפים המשולבים יכולים לנהל שיחה מלאה בנושאים שהזרימה מיועדת להם. בכל רגע נתון, דף אחד בלבד הוא הדף הנוכחי, הדף הנוכחי נחשב פעיל, והתהליך שמשויך לדף הזה נחשב פעיל. לכל תהליך יש דף התחלה מיוחד. כשתהליך הופך לפעיל בפעם הראשונה, דף ההתחלה הופך לדף הנוכחי. בכל תור בשיחה, הדף הנוכחי יישאר ללא שינוי או יעבור לדף אחר.

אתם מגדירים כל דף לאיסוף מידע מהמשתמשים הרלוונטי למצב השיחה שמיוצג בדף. לדוגמה, יכול להיות שתיצרו את הדפים (בכחול) בתרשים שלמטה לזרימת הזמנת אוכל של סוכן משלוחי פיצה. הצומת Start בתרשים מייצג את דף ההתחלה של התהליך Food Order. בסיום התהליך, המשתמש מועבר לתהליך האישור.

דוגמה לתרשים עם כמה זרימות.

מחזור החיים של דף

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

תרשים של מחזור החיים של דף.

הנה פרטים על התהליך:

  1. אם יש רכיב entry fulfillment בדף, הוא מופעל. כל התשובות הסטטיות שמופיעות ב-fulfillment מתווספות לתור התשובות.

    אם האפשרות תגובה חלקית מופעלת, מערכת Dialogflow CX מרוקנת את תור התגובות ושולחת את כל ההודעות בתור כחלק מהתגובה למתקשר באמצעות Streaming API.

    אם יש ל-fulfillment ווּבְּהוּק, הווּבְּהוּק מופעל, ויכול להיות שיתווספו תגובות נוספות לתור. התשובות הנוספות האלה לא גורמות לניקוי מיידי של תור התשובות.

  2. אם בדף יש פרמטרים של טופס, יכול להיות שהם ימולאו מראש:

  3. אם יש בטווח מטפלי מצב, הם מוערכים בהתאם לכללי סדר ההערכה של המטפלים. הפעולות האלה יכולות לכלול מסלולים, גורמים שמטפלים באירועים או גורמים שמטפלים בהצגת הנחיות חוזרות, שמופעלים מהאיטרציה הקודמת של הלולאה. אם מתבצעת קריאה ל-state handler כלשהו, יכול להיות שאחת מהפעולות הבאות או שתיהן יקרו:

    • אם יש מילוי ל-handler, הוא מופעל. כל התשובות הסטטיות שמופיעות ב-fulfillment מתווספות לתור התשובות. אם מופעלים תגובה חלקית ו-webhook, הם גם יופעלו.
    • אם קיים דף או תהליך יעד לטיפול, הסשן עובר ליעד והדף הופך ללא פעיל.

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

    • בדף יש טופס.
    • יש פרמטרים נדרשים בטופס שעדיין לא מולאו.
    • לא בוצע מעקב אחרי reprompt handler בשלב 3.
    • אם מופעלים מילוי חלקי ו-webhook, הם יופעלו.

  5. ההודעות שנותרו בתור התשובות נשלחות למשתמש הקצה, והנציג ממתין לקלט ממשתמש הקצה.

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

ניווט במחזור החיים של הדף

הכלי לצפייה בשלבי ההרצה של הסימולטור מאפשר לעבור בין השלבים של תור ספציפי בשיחה, ובכל שלב הוא מציג את הרכיבים הרלוונטיים של הכלי לבניית סוכנים. בדוגמה הבאה, קלט של משתמש קצה 'I would like to rent a car' (אני רוצה לשכור רכב) מפעיל חמישה שלבי ביצוע ומעבר:

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

  2. מופעל מסלול מעבר לכוונת המשתמש car_rental.reservation_create. הצופה בשלבי הביצוע מציג את המסלול הזה במרכז, ובו אפשר לראות שהיעד של המעבר הוא הדף Pickup Location. שלב 2 בביצוע הדף.

  3. הנציג נכנס לדף Pickup Location. שלב 3 בהפעלת הדף.

  4. הסוכן מעריך את מילוי הערך בדף Pickup Location. ה-fulfillment ריק, ולכן לא קורה כלום. שלב 4 בביצוע הדף.

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

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

ביטול האמירה.

צור דף

כדי ליצור דף:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud .
  3. בוחרים את הסוכן.
  4. בוחרים זרימה לדף בקטע זרימות.
  5. בקטע דפים, לוחצים על לחצן ההוספה .
  6. מזינים שם תצוגה לדף.
  7. לוחצים על לחצן ההגדרות לצד השם המוצג של הדף.
  8. לוחצים על עריכה.
  9. מזינים את השדות בלוח העריכה של הדף שמופיע.
  10. לוחצים על Save.

API

אפשר לעיין בשיטה create עבור הסוג Page.

בוחרים פרוטוקול וגרסה עבור הפניה לדף:

פרוטוקול V3 V3beta1
REST משאב דף משאב דף
RPC ממשק הדף ממשק הדף
C++‎ PagesClient לא זמין
C#‎ PagesClient לא זמין
המשך PagesClient לא זמין
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP לא זמין לא זמין
Python PagesClient PagesClient
Ruby לא זמין לא זמין

נתוני הדף

כדי לגשת לנתונים של דף:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud של הסוכן.
  3. בוחרים את הסוכן.
  4. לוחצים על התהליך בקטע תהליכים.
  5. הדפים של התהליך מאוכלסים בקטע דפים.
  6. לוחצים על לחצן ההגדרות לצד השם המוצג של הדף.
  7. לוחצים על עריכה.
  8. מזינים את השדות בלוח העריכה של הדף שמופיע.
  9. לוחצים על שמירה כדי לשמור את השינויים.

API

אפשר לעיין בשיטות get ו-patch/update של הסוג Page.

בוחרים פרוטוקול וגרסה עבור הפניה לדף:

פרוטוקול V3 V3beta1
REST משאב דף משאב דף
RPC ממשק הדף ממשק הדף
C++‎ PagesClient לא זמין
C#‎ PagesClient לא זמין
המשך PagesClient לא זמין
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP לא זמין לא זמין
Python PagesClient PagesClient
Ruby לא זמין לא זמין

הנתונים הבאים משויכים לדפים:

  • השם המוצג: שם הדף שקריא לבני אדם.
  • Entry fulfillment (גם נקרא Entry dialogue): זהו הfulfillment שמופעל כשדף הופך לפעיל.
  • פרמטרים: אלה ערכי הפרמטרים בטופס בדף שמתעדים קלט מובנה ממשתמש הקצה.
  • נתיבים: יכול להיות שהקריאה ל-state handlers האלה תתבצע כשהדף פעיל. פרטים נוספים מופיעים במאמר בנושא נתיבי handler ברמת הדף
  • קבוצות של מסלולים: יכול להיות שיהיה אפשר להתקשר למסלולים האלה כשהדף פעיל. לפרטים נוספים, אפשר לעיין במאמר בנושא קבוצות ניתוב
  • גורמים מטפלים באירועים: יכול להיות שהגורמים המטפלים באירועים האלה יופעלו כשהדף פעיל. פרטים נוספים זמינים במאמר בנושא Page-level event handlers

הגדרות הדף

ההגדרות הבאות זמינות לדפים:

כדי לגשת להגדרות הדף:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud .
  3. בוחרים את הסוכן.
  4. מעבירים את העכבר מעל הדף בקטע דפים.
  5. לוחצים על לחצן האפשרויות .
  6. בוחרים באפשרות הגדרות הדף.
  7. מעיינים בהגדרות או עורכים אותן.
  8. לוחצים על שמירה כדי לשמור את השינויים.

API

אפשר לעיין בשיטות get ו-patch/update של הסוג Page.

בוחרים פרוטוקול וגרסה עבור הפניה לדף:

פרוטוקול V3 V3beta1
REST משאב דף משאב דף
RPC ממשק הדף ממשק הדף
C++‎ PagesClient לא זמין
C#‎ PagesClient לא זמין
המשך PagesClient לא זמין
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP לא זמין לא זמין
Python PagesClient PagesClient
Ruby לא זמין לא זמין

מחיקת דף

כדי למחוק דף:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud .
  3. בוחרים את הסוכן.
  4. בוחרים את התהליך של הדף בקטע תהליכים.
  5. בקטע דפים, לוחצים על לחצן ההגדרות לצד השם המוצג של הדף.
  6. בוחרים את האפשרות Delete.

API

אפשר לעיין בשיטה delete עבור הסוג Page.

בוחרים פרוטוקול וגרסה עבור הפניה לדף:

פרוטוקול V3 V3beta1
REST משאב דף משאב דף
RPC ממשק הדף ממשק הדף
C++‎ PagesClient לא זמין
C#‎ PagesClient לא זמין
המשך PagesClient לא זמין
Java PagesClient PagesClient
Node.js PagesClient PagesClient
PHP לא זמין לא זמין
Python PagesClient PagesClient
Ruby לא זמין לא זמין

הקודם
Flows
הבא
State handlers