דפים

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

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

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

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

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

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

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

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

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

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

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

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

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