Flows

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

תהליכים משמשים להגדרת הנושאים האלה ונתיבי השיחה המשויכים. לכל נציג יש תהליך אחד שנקרא Default Start Flow. יכול להיות שהתהליך היחיד הזה הוא כל מה שצריך בשביל נציג פשוט. נציגים מורכבים יותר עשויים לדרוש תהליכים נוספים, וחברים שונים בצוות הפיתוח יכולים להיות אחראים על הבנייה והתחזוקה של התהליכים האלה. לדוגמה, התהליכים של נציג למשלוחי פיצה יכולים להיראות כך:

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

תהליך התחלה שמוגדר כברירת מחדל

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

כשמשתמשים ב-API, אפשר להפנות לתהליך ברירת המחדל באמצעות מזהה התהליך הבא:

00000000-0000-0000-0000-000000000000

דף הפתיחה של התהליך

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

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

הפניה לדף התחלה בבקשות API

כדי להפנות לדף הפתיחה של תהליך בבקשות API בזמן ריצה, משתמשים ב-START_PAGE כמזהה הדף.

כדי לבצע שינויים בזמן התכנון בדף התחלה באמצעות ה-API, משתמשים בשיטות ה-API‏ get ו-patch/update לסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

יצירת תהליך עבודה

כדי ליצור תהליך:

המסוף

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

API

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

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

נתוני זרימה

כדי לגשת לנתונים של תהליך:

המסוף

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

API

לגבי תהליכים, אפשר לעיין ב-get וב-patch/update לסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

פרוטוקול V3 V3beta1
REST משאב של תהליך משאב של תהליך
RPC ממשק Flow ממשק Flow
C++‎ FlowsClient לא זמין
C#‎ FlowsClient לא זמין
המשך FlowsClient לא זמין
Java FlowsClient FlowsClient
Node.js FlowsClient FlowsClient
PHP לא זמין לא זמין
Python FlowsClient FlowsClient
Ruby לא זמין לא זמין
לגבי דפים, אפשר לעיין בשיטות 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. בוחרים את הפרויקט הרצוי.
  3. מוצאים את הסוכן ברשימה.
  4. מציבים את הסמן מעל התהליך בקטע תהליכים.
  5. לוחצים על כפתור האפשרויות .
  6. לוחצים על הגדרות התהליך.
  7. מעיינים בהגדרות או עורכים אותן.
  8. לוחצים על שמירה כדי לשמור את השינויים.

API

אפשר לעיין ב-methods‏ get ו-patch/update של הסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

מחיקת תהליך

כדי למחוק תהליך:

המסוף

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

API

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

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

אימון של תהליך

כדי לאמן תהליך:

המסוף

  1. פותחים את מסוף Dialogflow CX.
  2. בוחרים את הפרויקט הרצוי.
  3. מוצאים את הסוכן ברשימה.
  4. לוחצים על Agent Settings.
  5. פותחים את הכרטיסייה ML.
  6. כדי לאמן תהליך אחד, לוחצים על אימון בשורה המתאימה.
  7. כדי לאמן כמה תהליכים, בוחרים אותם באמצעות תיבות הסימון ולוחצים על Train selected flow NLU model.

API

אפשר לעיין בשיטה train של הסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

ייצוא של תהליך

אפשר לייצא תהליך בשתי דרכים:

  • ייצוא נתונים: ייצוא של התהליך כנתונים גולמיים לייבוא לכל נציג. הייצוא כולל משאבים שהתהליך מפנה אליהם (כוונות, ישויות ו-webhooks). כשמבצעים את השלבים הבאים, צריך לבחור בפורמט נתונים גולמיים.
  • ייצוא דיאגרמה (גרסת טרום-השקה (Preview)): האפשרות הזו מייצאת את התהליך כדיאגרמה חזותית בפורמט draw.io XML, שאפשר לייבא לכלים כמו Lucidchart או diagrams.net. כשמבצעים את השלבים הבאים, בוחרים בפורמט הנתונים XML.

אפשר לייצא תהליך באמצעות האפשרויות הבאות:

  • Include referenced flows: ייצוא של תהליך היעד וכל התהליכים שמופנים באופן רקורסיבי ללא עומק מקסימלי. כל התהליכים שיוצאו והמעברים שלהם נשמרים במהלך הייבוא.

כדי לייצא תהליך:

המסוף

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

API

אפשר לעיין בשיטה export של הסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

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

ייבוא תהליך

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

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

כדי לייבא תהליך:

המסוף

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

API

אפשר לעיין בשיטה import של הסוג Flow.

בוחרים פרוטוקול וגרסה להפניה של Flow:

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