דפים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

צור דף

כדי ליצור דף:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud .
  3. בוחרים את הסוכן.
  4. בקטע Flows (תהליכים), בוחרים תהליך לדף.
  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 שמופעל כשדף הופך לפעיל בפעם הראשונה.
  • פרמטרים: אלה ערכי הפרמטרים בטופס בדף שמתעדים קלט מובנה ממשתמש הקצה.
  • נתיבים: יכול להיות שהפונקציות האלה לטיפול במצבים יופעלו כשהדף פעיל. פרטים נוספים מופיעים במאמר בנושא נתיבי 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
הבא
מעבדי מצב