במהלך תור שיחה של נציג, הנציג צריך להשיב למשתמש הקצה בתשובה לשאלה, בשאילתה לקבלת מידע או בסיום הסשן. יכול להיות שהנציג יצטרך גם לפנות לשירות שלכם כדי ליצור תשובות דינמיות או לבצע פעולות בתור. מילוי הבקשה משמש לביצוע כל הפעולות האלה.
מילוי בקשה יכול להכיל כל אחד מהבאים:
- הודעות תשובה סטטיות.
- קריאות לפעולה מאתר אחר (webhook) כדי לקבל תשובות דינמיות ו/או לבצע פעולות.
- הגדרות קבועות מראש של פרמטרים כדי להגדיר או לשנות ערכי פרמטרים.
במהלך התור של הנציג, אפשר (ולפעמים רצוי) לקרוא לכמה מילויים של בקשות, וכל אחד מהם יכול ליצור הודעת תגובה. Dialogflow CX שומר את התשובות האלה בתור תשובות. כשהתור של הנציג מסתיים, Dialogflow CX שולח את התשובות לפי הסדר למשתמש הקצה.
תרחישים לדוגמה של ניהול הזמנות
מילוי בקשות מאפשר לכם לספק הודעות תגובה במקומות הבאים:
- מילוי של כניסה לדף
- מסלולים
- גורמים מטפלים באירועים
- הנחיות ראשוניות לטפסים
- רכיבי handler של בקשות חוזרות בטפסים
בכל אחד מהמקרים האלה, ייפתח במסוף חלונית לעריכת מילוי הבקשה.

תשובות של הסוכן (אפשרויות לדיאלוג)
הגדרת הודעות התגובה של הנציג בזמן התכנון, כשיוצרים מילוי בקשות. בזמן הריצה, התגובות האלה מתווספות לתור התגובות.
יש כמה סוגים של הודעות תגובה, שמתוארים בסעיפי המשנה הבאים. כשמשתמשים במסוף, בחלונית של מילוי הבקשה מופיע כרטיס ראשוני של Agent dialogue, אבל אפשר ללחוץ על Add dialogue response כדי להוסיף עוד כרטיסים לסוגים אחרים של הודעות תשובה.
תשובה בטקסט סטטי
הודעות תגובה עם טקסט סטטי מספקות למשתמש דיאלוג טקסטואלי. אם הקריאות ל-API לזיהוי כוונה או הקריאות לשילוב משתמשות בסינתזת דיבור, הטקסט הזה יוצר תוכן אודיו. בהודעות האלה, הטקסט שסופק משתמש ב-Speech Synthesis Markup Language (SSML).
אפשר להגדיר כמה כרטיסים של תגובות טקסט, ובכל כרטיס כמה תגובות טקסט. אם מגדירים כמה כרטיסים, הם משורשרים לתשובה אחת בזמן הריצה. אם מגדירים כמה תשובות בכרטיס, אחת מההודעות בכרטיס נבחרת באופן אקראי בזמן הריצה.
הודעות הטקסט האלה יכולות להכיל הפניות לפרמטרים ופונקציות מערכת מוטבעות.
מטען ייעודי (payload) מותאם אישית
חלק מהשילובים תומכים בתגובה של מטען ייעודי (payload) מותאם אישית כדי לטפל בתגובות עשירות. צריך לספק את המטענים הייעודיים האלה בפורמט JSON שמוגדר במסמכי התיעוד של השילוב. לדוגמה, ראו פורמט המטען הייעודי (payload) המותאם אישית של Dialogflow CX Messenger.
אפשר לכלול הפניות לפרמטרים ב-JSON של המטען הייעודי (payload) המותאם אישית. צריך להקיף אותם במירכאות כפולות כדי שהמערכת תתייחס אליהם כערכי מחרוזת JSON. לדוגמה:
{
"someField": "$session.params.date"
}
המטען הייעודי (payload) המותאם אישית ב-JSON מוגבל ל-24 רמות עומק.
אפשר גם לשלוח מטען ייעודי (payload) מותאם אישית לשילובים שאתם מפתחים. היא לא תעובד על ידי Dialogflow CX, ולכן צריך לטפל בה בלוגיקה העסקית שלכם.
מידע נוסף זמין במאמר תבניות של מטען ייעודי (payload) בהתאמה אישית.
העברה לנציג אנושי
התגובה הזו מאותתת למבצע הקריאה ל-API לזיהוי כוונה שצריך להעביר את השיחה לנציג אנושי. Dialogflow CX משתמש באות הזה רק כדי לזהות שיחות שהועברו למטרות מדידה, והוא לא משנה את מצב הסשן.
המערכת או השילוב שלכם יכולים להשתמש באות הזה כדי לבצע את הפעולות הנדרשות להעברת השיחה. ב-Dialogflow CX אין מבנה מסוים לנתונים האלה, אז אתם יכולים לבחור כל מבנה שמתאים למערכת שלכם.
מטא-נתונים של שיחה מוצלחת
התגובה הזו מאותתת למבצע הקריאה ל-API לזיהוי כוונה שהשיחה עם הסוכן של Dialogflow CX הצליחה. Dialogflow CX משתמש באות הזה כדי לזהות שיחות שהצליחו למטרות מדידה, והוא לא משנה את מצב הסשן בשום צורה.
המערכת או השילוב שלכם יכולים להשתמש באות הזה כדי לבצע את הפעולות הנדרשות. ב-Dialogflow CX אין מבנה מסוים לנתונים האלה, כך שאפשר לבחור כל מבנה שמתאים למערכת שלכם.
השמעת אודיו מוקלט מראש
התגובה הזו מפעילה קובץ אודיו בשילובים שתומכים בתכונה הזו.
יכול להיות שיהיו דרישות שונות לגבי פורמט קובץ האודיו בשילובים שונים. לדוגמה, ראו את הדרישות של Dialogflow CX Phone Gateway.
בשילובי טלפוניה של שותפים, כתובת ה-URL של קובץ האודיו צריכה להיות נגישה לשותף. השותף תמיד יכול לגשת לכתובת URL שזמינה באופן ציבורי, כמו קובץ ציבורי ב-Cloud Storage. השותף יכול גם לספק גישה מוגבלת לקובצי אודיו. פרטים נוספים זמינים במסמכי התיעוד של השותף.
טקסט פלט של אודיו
התגובה הזו דומה לתגובת text, אבל היא רלוונטית רק להמרת טקסט לדיבור. אם הנציג יכול לטפל גם בסשנים של טקסט וגם בסשנים של קול, אתם יכולים להשתמש בתגובות ייחודיות של טקסט וטקסט פלט של אודיו כדי ליצור חוויית משתמש שונה לטקסט לעומת קול. אם מספקים טקסט פלט של אודיו לסשן קולי, המערכת מתעלמת מהתשובות בטקסט פשוט.
אם הנציג שלכם מטפל גם בסשנים של טקסט וגם בסשנים של קול, ואתם רוצים את אותן הודעות תגובה, השתמשו בתגובות טקסט גם לסשנים של טקסט וגם לסשנים של קול.
הטקסט של פלט האודיו משורשר בדומה לתשובות טקסט. אם התשובות של פלט הטקסט של האודיו הן שילוב של טקסט ו-SSML, התוצאה המשורשרת מטופלת כ-SSML. באופן אידיאלי, כדאי להשתמש בטקסט או ב-SSML באופן עקבי.
תשובה מותנית
סוג התשובה הזה מספק תשובות מותנות:
הפורמט הכללי הוא:
if [condition] [response] elif [condition] [response] elif [condition] [response] else [response] endif
כאשר:
- הפורמט של
[condition]זהה לפורמט של תנאי הנתיב. -
[response]היא תשובה בטקסט. - הבלוקים
elifו-elseהם אופציונליים.
לדוגמה:
if $session.params.user-age >= 21 Ok, you may enter. else Sorry, you cannot enter. endif
גם [condition] וגם [response] יכולים להשתמש בפונקציות מערכת מוטמעות כדי ליצור ערכים דינמיים במהלך שיחות. למידע נוסף, ראו פונקציות מערכת ותנאי מסלול. הערך של [condition] נקבע לפי מצב הסשן בתחילת מילוי הבקשה. אם ה-[response] מסתמך על מצב הסשן, הוא נפתר על סמך מצב הסשן המעודכן בסוף המילוי.
בנציגים בכמה שפות, [condition] משותף לכל השפות, ו-[response] ספציפי לשפה. כשמשנים את [condition] בשפה אחת במסוף, החלק הזה מתעדכן בכל השפות של הנציג. הוא הופך לתנאי חדש, ולכן הערך של [response] נמחק בכל השפות, חוץ מהשפה שנבחרה כשעדכנתם את [condition].
העברת שיחה במערכת טלפוניה
העברת שיחות זמינה רק ב-Dialogflow CX Phone Gateway.
בחלק מהשילובים של שירותי הטלפוניה, אפשר לציין מספר טלפון בארה"ב להעברת שיחות. בזמן הריצה, כשסוכן CX של Dialogflow CX מפעיל מילוי בקשה עם העברת שיחה, השיחה מועברת למספר שצוין והטיפול של הסוכן מושהה.
תגובה של כלי מאגר הנתונים
סוג התשובה הזה מגדיר את התשובות של הנציג שמוחזרות מכלים מקושרים של מאגרי נתונים. אם הגדרתם כלי של מאגר נתונים ב-fulfillment הזה, כרטיס התגובה של הכלי של מאגר הנתונים יאוכלס באופן אוטומטי.
- קישורים למקורות: הגדרת המספר המקסימלי של ציטוטים שיוצגו למשתמש אחרי התשובה. ציטוט הוא קישור למקור המידע במאגר הנתונים, שמוצג כלחצן. ערך ברירת המחדל הוא 1.
- ציטוטים בגוף הטקסט: הגבלת מספר הציטוטים בגוף הטקסט שמוחזרים בכל משפט, במקום להציג רשימה של קישורים אחרי התשובה.
- מענה גנרטיבי כגיבוי: מגדירים את הנציג כך שינסה ליצור תשובה באמצעות AI אם מאגר הנתונים מחזיר תוצאה ריקה. אם הפעולה נכשלת, הנציג משתמש בתשובות סטטיות.
- תשובות סטטיות: בשדה האחרון, מזינים תשובות טקסט סטטיות שיישלחו למשתמש מילה במילה.
הודעות תגובה ספציפיות לערוץ
כשמגדירים מילוי בקשה, אפשר ליצור הודעות תגובה ספציפיות לערוץ כדי ליצור תגובות ממוקדות לצ'אט טקסט, לקול, ל-SMS או לשילובים ספציפיים שתומכים בערוצים. הודעות תגובה שלא ספציפיות לערוץ מסוים נקראות הודעות תגובה שמוגדרות כברירת מחדל.
בזמן הריצה, Dialogflow CX בוחר את הודעת התגובה שמוגדרת כברירת מחדל או הודעת תגובה ספציפית לערוץ, אם בבקשה לזיהוי כוונה צוין ערוץ. מומלץ להגדיר הודעות תגובה כברירת מחדל, גם אם אתם משתמשים בהודעות תגובה ספציפיות לערוץ. הודעות התגובה שמוגדרות כברירת מחדל משמשות כגיבוי אם המערכת לא מצליחה לספק ערוץ תקין.
שם הערוץ הוא שדה בהתאמה אישית שאפשר להגדיר בו כל טקסט. אם אתם משתמשים ב-Dialogflow CX API ישירות לקריאות בזמן ריצה, אתם יכולים להשתמש בכל שם ערוץ שתרצו. אם אתם משתמשים בשילוב קיים, אתם צריכים להשתמש בשמות הערוצים שהשילוב מזהה.
הגדרת הודעות תגובה ספציפיות לערוץ בזמן התכנון
כדי לספק הודעות תגובה ספציפיות לערוץ למילוי בקשות באמצעות המסוף:
- אחרי שמוסיפים הודעות תגובה שמוגדרות כברירת מחדל, לוחצים על הוספת ערוץ כדי להוסיף הודעות תגובה ספציפיות לערוץ. כדי להוסיף עוד ערוצים, לוחצים שוב על הוספת ערוץ.
כדי לספק הודעות תגובה ספציפיות לערוץ למילוי בקשות כשמשתמשים ב-API:
- מגדירים את השדה
Fulfillment.messages[i].channelלערוץ שנבחר לכל הודעת תגובה. אם השדה הזה לא מוגדר, התשובה נחשבת כהודעת תשובה שמוגדרת כברירת מחדל.
שימוש בהודעות תגובה ספציפיות לערוץ בזמן הריצה
אם אתם משתמשים בשילוב קיים שתומך בערוצים, השלבים האלה מבוצעים בהטמעה של השילוב.
כדי לקבל הודעת תגובה ספציפית לערוץ, צריך לציין את הערוץ בהודעת הבקשה לזיהוי הכוונה. אפשר לעיין בשדה queryParams.channel ב-method detectIntent של הסוג Sessions.
בוחרים פרוטוקול וגרסה להפניה לסשן:
| פרוטוקול | V3 | V3beta1 |
|---|---|---|
| REST | משאב הסשן | משאב הסשן |
| RPC | ממשק הסשן | ממשק הסשן |
| C++ | SessionsClient | לא זמין |
| C# | SessionsClient | לא זמין |
| המשך | SessionsClient | לא זמין |
| Java | SessionsClient | SessionsClient |
| Node.js | SessionsClient | SessionsClient |
| PHP | לא זמין | לא זמין |
| Python | SessionsClient | SessionsClient |
| Ruby | לא זמין | לא זמין |
אם בבקשה לא מוגדר ערוץ או אם לא נמצא ערוץ תואם למילוי הבקשה, Dialogflow CX מחזיר את הודעת התגובה שמוגדרת כברירת מחדל.
תבניות של מטען ייעודי (payload) מותאם אישית
אם אתם משתמשים במטענים ייעודיים מותאמים אישית לעיתים קרובות, כדאי להשתמש בתבניות של מטענים ייעודיים מותאמים אישית. מטעני ייעודיים מותאמים אישית הם לפעמים גדולים ומורכבים, ולכן השימוש בתבניות מפשט את תהליך היצירה של הנציג.
כדי שהתבניות האלה יהיו זמינות לבחירה כשיוצרים מילוי בקשות לסוכן, צריך לספק אותן בהגדרות הסוכן.
לדוגמה, אפשר להגדיר את המטען הייעודי (payload) ב-JSON של הכפתורים "כן" ו "לא" כתבניות של מטען ייעודי בהתאמה אישית. כשיוצרים מילוי בקשות שדורש את הכפתורים האלה, צריך לבחור את התבנית כשיוצרים את מילוי הבקשות.
כשבוחרים תבנית למטען ייעודי (payload) מותאם אישית של מילוי בקשה, התוכן של התבנית מוכנס למטען הייעודי. אחר כך אפשר לערוך את המטען הייעודי (payload) לפי הצורך.
אם משנים תבנית, השינויים לא מועברים באופן אוטומטי לכל המטענים הייעודיים (payloads) של מילוי הבקשה שבהם היא אוזכרה.
כדי ליצור תבנית מטען ייעודי (payload) בהתאמה אישית, עיינו בהגדרות הכלליות של הנציג.
כדי לבחור תבנית מטען ייעודי (payload) מותאמת אישית כשיוצרים מילוי בקשה, לוחצים על Select template כשיוצרים מטען ייעודי מותאם אישית למילוי בקשה.
קריאות ל-webhook
כשמילוי בקשה מפעיל webhook, הנציג שולח בקשה לשירות שלכם. ה-webhook יכול לבצע פעולות, לספק הודעות תגובה דינמיות, לשנות ערכי פרמטרים ולשנות את הדף הנוכחי.
ההגדרות הבאות של ה-webhook משמשות למילוי בקשות:
| X | פריט |
|---|---|
| הפעלת התגובה לפעולה מאתר אחר (webhook) | הפעולה הזו מפעילה את ה-webhook למילוי הבקשה. |
| תגובה לפעולה מאתר אחר (webhook) | בוחרים את המשאב של ה-webhook. |
| תג | תג הטקסט שאתם מספקים כאן יאכלס את השדה WebhookRequest.fulfillmentInfo.tag של בקשת ה-webhook שנשלחת לשירות ה-webhook שלכם. אפשר להשתמש בזה כדי לשלוט בהתנהגות של ה-webhook באופן שספציפי למילוי הבקשה. |
| החזרת תשובה חלקית | מאפשרת לבטל את ההפעלה של תשובה חלקית. פרטים נוספים זמינים במאמר בנושא הגדרות דיבור מתקדמות. |
הגדרות קבועות מראש של פרמטרים
אפשר להשתמש ב-fulfillment כדי לספק הגדרות קבועות מראש שמגדירות או משנות את ערכי הפרמטרים הנוכחיים. ההגדרות הקבועות מראש האלה מוחלות לפני פתרון הודעות תגובה סטטיות או קריאה ל-webhook.
אפשר גם להשתמש בפונקציות מערכת כדי להגדיר מראש פרמטר לערך שנוצר באופן דינמי.
הנה כמה דוגמאות:
הגדרת הפרמטר
nowלשעה הנוכחית:פרמטר ערך עכשיו $sys.func.NOW() הגדלת פרמטר קיים
counterב-1:פרמטר ערך מונה $sys.func.ADD($session.params.counter, 1) הגדרת הפרמטר
new-costלערך הפרמטרother-cost, תוך שמירה על הערך המלא של האובייקט המורכב:פרמטר ערך new-cost $sys.func.IDENTITY($session.params.other-cost)
כלים למאגרי נתונים
מידע נוסף על התכונה הזו זמין במאמרי העזרה בנושא כלים למאגרי נתונים.
הגדרות דיבור מתקדמות
הגדרות הדיבור המתקדמות האלה יכולות לשנות את הגדרות הדיבור של הדף, את הגדרות הדיבור של תהליך השיחה ואת הגדרות הדיבור של הנציג.
תור התגובות
במהלך התור של הנציג, אתם יכולים לקרוא לכמה מילוי בקשות, וכל אחד מהם יכול ליצור הודעת תגובה. התשובות האלה נשמרות ב-Dialogflow CX בתור תשובות.
תגובה חלקית ל-API לסטרימינג
כברירת מחדל, Dialogflow CX שולח תשובות מסודרות למשתמשי הקצה רק אחרי שהתור של הנציג מסתיים. אפשר גם להפעיל את האפשרות Return partial response במילוי הבקשה כדי להחזיר תשובות בתור כתשובה חלקית כשמשתמשים בממשקי ה-API לסטרימינג. מידע נוסף זמין במאמר מחזור החיים של דף.
לדוגמה, אם ה-webhook שלכם צפוי לפעול במשך זמן רב, אתם יכולים להוסיף תגובה סטטית למילוי הבקשה ולהפעיל תגובה חלקית. הפעולה הזו גורמת ל-Dialogflow CX לרוקן את תור התגובות ולשלוח את כל ההודעות כתגובה חלקית לפני הקריאה ל-webhook.
אין תמיכה בתשובה חלקית במקרים הבאים:
- קלט אודיו בסימולטור.
- יכול להיות ששילובי טלפוניה של שותפים לא תומכים בתגובה חלקית. כדי לוודא את זה, צריך לעיין במסמכי התיעוד של השותף.
כדי לבדוק את התכונה הזו בסימולטור, צריך להפעיל את האפשרות "תגובה חלקית".

בדוגמה הבאה, נניח שלוקח ל-webhook 5 שניות להשלים את הפעולה, ולא הפעלתם את התכונה "תגובה חלקית". התור של הסוכן ב-Dialogflow CX בשיחה לא מסתיים עד שה-webhook מסתיים. במהלך 5 השניות האלה, התשובות ממתינות בתור ל-webhook, והן לא מוחזרות למשתמש הקצה עד שהתור מסתיים. התוצאה היא חוויית משתמש גרועה.
אם מפעילים את התכונה "תגובה חלקית" במילוי הבקשה הראשון, Dialogflow CX מחזיר את הודעת מילוי הבקשה הראשונה במהירות וקורא ל-webhook. אחרי שה-webhook מסתיים, Dialogflow CX מחזיר את התשובה הסופית. התרחיש הזה משפר את חוויית משתמש הקצה כי הוא מקבל הודעה על כך שצפויה המתנה קצרה. בנוסף, הקריאה ל-webhook מתבצעת במקביל לתגובה שנשלחת למשתמש הקצה.
שפת Markup לסינתזת דיבור (SSML)
אפשר להשתמש ב-Speech Synthesis Markup Language (SSML) בשדות למילוי בקשות של טקסט או פלט אודיו. כך אתם יכולים להתאים אישית את תגובת האודיו על ידי הוספת פרטים על הפסקות ועיצוב אודיו של ראשי תיבות, תאריכים, שעות, קיצורים או טקסט שצריך לצנזר.
פרטים על התחביר מופיעים במסמכי התיעוד של SSML להמרת טקסט לדיבור.