דפים

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

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

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

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

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

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

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

התהליך כולל את השלבים הבאים:

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

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

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

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

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

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

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

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

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

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

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

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

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

  2. מופעל מסלול מעבר ל-Intent‏ 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. הדפים של התהליך מאוכלסים בקטע Pages.
  6. לוחצים על כפתור ההגדרות לצד השם המוצג של הדף.
  7. לוחצים על עריכה.
  8. ממלאים את השדות בחלונית העריכה של הדף שמופיעה.
  9. לוחצים על שמירה כדי לשמור את השינויים.

API

אפשר לעיין ב-methods‏ 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 לא זמין לא זמין

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

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

הגדרות הדף

אלה ההגדרות שאפשר לקבוע לדפים:

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

המסוף

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

API

אפשר לעיין ב-methods‏ 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
הבא
מעבדי מצב