Flows

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

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

תהליך ברירת המחדל להתחלה

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

הערה: אי אפשר למחוק את הזרימה שמוגדרת כברירת מחדל להתחלת השיחה.

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

00000000-0000-0000-0000-000000000000

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

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

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

• הפצת כוונות
• שימוש בtrue תנאי פשוט בנתיב עם תגובה של מילוי או יעד מעבר לדף רגיל עם מילוי של כניסה
• אירועים בהתאמה אישית

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

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

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

מעבר אל הפניית Flow API

בוחרים פרוטוקול וגרסה להפניה ל-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 API

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

API

למידע על תהליכי עבודה, אפשר לעיין בget ובpatch/update לגבי הסוג Flow. מעבר אל הפניית Flow API

בוחרים פרוטוקול וגרסה להפניה ל-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. כניסה להפניית Page API

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

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

סגירה

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

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

מידע נוסף על אופן השימוש בנתונים ברמות שונות זמין במאמר בנושא רמות השימוש בנתונים.

הגדרות של תהליך

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

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

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

  1. אי אפשר ליצור, לערוך או למחוק דפים.
  2. אי אפשר ליצור, לערוך או למחוק גרסאות.
  3. אי אפשר ליצור, לערוך או למחוק קבוצות של נתיבי ניתוב ברמת הזרימה.
  4. לא ניתן למחוק קבוצות ניתוב ברמת הסוכן שאליהן יש הפניה בתהליך נעול או בכל דף בתהליך נעול, אבל עדיין אפשר לערוך אותן.
  הערה: אי אפשר לשנות את ההגדרה הזו אם הנעילה מופעלת ברמת הסוכן.

• הגדרות מתקדמות של דיבור: ההגדרות המתקדמות של הדיבור יכולות לבטל את הגדרות הדיבור של הסוכן.

• הגדרות של התאמת דיבור: הגדרות של התאמת דיבור ברמת התהליך. מידע נוסף זמין במאמר בנושא התאמה ידנית של דיבור.

• פרמטרים של קלט: פרמטרים מתוך מדריך הפעולות למשימה שזמינים בתהליך.

• פרמטרים להחזרה: פרמטרים שהזרימה מחזירה למדריך הפעולות של המשימה.

מידע נוסף על אופן השימוש בנתונים ברמות שונות זמין במאמר בנושא רמות השימוש בנתונים.

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

המסוף

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

API

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

בוחרים פרוטוקול וגרסה להפניה ל-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 API

בוחרים פרוטוקול וגרסה להפניה ל-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. פותחים את הכרטיסייה ML.
6. כדי לאמן זרימה אחת, לוחצים על אימון בשורה המתאימה.
7. כדי לאמן כמה תהליכים, מסמנים את תיבות הסימון שלהם ואז לוחצים על Train selected flow NLU model (אימון מודל ה-NLU של התהליך הנבחר).

API

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

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

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

סגירה

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

יש שתי דרכים לייצא זרימת נתונים:

• ייצוא נתונים: האפשרות הזו מייצאת את התהליך כנתונים גולמיים שאפשר לייבא לכל סוכן. המשאבים שאליהם יש הפניה בתהליך (intent, ישויות ו-webhook) נכללים בייצוא. כשמבצעים את השלבים שבהמשך, בוחרים בפורמט נתונים גולמיים.

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

  הערה: ייצוא דיאגרמות לא זמין לסוכנים שמשתמשים ב-CMEK.

אפשר לייצא זרימת נתונים באחת מהאפשרויות הבאות:

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

כדי לייצא זרימת עבודה:

המסוף

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

API

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

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

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

סגירה

ייבוא של זרימה

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

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

כדי לייבא רצף פעולות:

המסוף

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

API

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

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

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

סגירה