בדף הזה מוסבר איך ליצור אפליקציית Google Chat שיכולה להבין שפה טבעית ולענות באמצעותה באמצעות Dialogflow. במדריך הזה נעשה שימוש ב-Dialogflow CX, שיש לו שילוב ישיר עם Google Chat. אפשר גם להשתמש ב-Dialogflow ES כדי ליצור אפליקציית Google Chat ל-Dialogflow ES. לשם כך, צריך לפעול לפי ההוראות במדריך בנושא Dialogflow ES Google Chat.
לדוגמה, אפליקציית צ'אט שעוזרת לאנשים לשכור מכוניות. משתמש יכול לכתוב, "אני רוצה לשכור רכב". אפליקציית Chat עשויה להגיב בשאלה כמו "איפה תרצה לאסוף את הרכב?" וכך להתחיל שיחה עם המשתמש שדומה לשיחה עם בן אדם, שבה אפליקציית Chat מבינה את המשתמש ומגיבה לו בדיבור אנושי בזמן הזמנת השכרת הרכב.
זו רק דוגמה אחת. אפליקציות צ'אט של Dialogflow שימושיות בכל מיני אינטראקציות. אם נדרשת שיחה טבעית עם בן אדם, צריך להשתמש באפליקציית צ'אט של Dialogflow. סוכנים מוכנים מראש עוזרים להתחיל במהירות ומציגים את היכולות של Dialogflow, כמו:
- להזמנת טיסות
- קביעת תורים לרופאים
- הזמנת משלוח אוכל
- לענות על שאלות לגבי קטלוג מוצרים קמעונאי, למשל אם פריטים זמינים בצבעים אחרים
-
איור 1. בחירת סוכן מוכן מראש לאפליקציית Dialogflow Chat. -
איור 2. בדיקת הנציג ב-Dialogflow CX כדי לוודא שהלוגיקה וההגדרה של הנציג פועלות כמצופה. בדיאגרמה מוצגת קבוצה עוקבת של דפים לפי נושאים שקשורים לשלבים ספציפיים בשיחה, כמו הגדרת מיקום לאיסוף ולהחזרה של רכב שכור, ומוגדר הלוגיקה שמקשרת ביניהם. השיחה נבדקת בסימולטור. -
איור 3. הגדרה של אפליקציית Chat לעיבוד תשובות באמצעות סוכן Dialogflow CX בדף ההגדרה של Chat API במסוף Google Cloud. -
איור 4. שיחה עם אפליקציית Dialogflow Chat ב-Google Chat על הזמנת רכב להשכרה.
מטרות
- מגדירים את הסביבה.
- יוצרים ופורסים סוכן Dialogflow CX.
- יצירה ופריסה של אפליקציה ל-Chat שמבוססת על סוכן Dialogflow CX.
- בודקים את אפליקציית Chat.
דרישות מוקדמות
- חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
- פרויקט ב-Google Cloud שהחיוב בו מופעל. כדי לבדוק אם החיוב מופעל בפרויקט קיים, אפשר לעיין במאמר אימות סטטוס החיוב של הפרויקטים. כדי ליצור פרויקט ולהגדיר חיוב, אפשר לעיין במאמר בנושא יצירת פרויקט ב-Google Cloud.
ארכיטקטורה
התרשים הבא מציג את הארכיטקטורה של אפליקציית צ'אט שנבנתה באמצעות Dialogflow:
בתרשים שלמעלה, משתמש שמקיים אינטראקציה עם אפליקציית צ'אט של Dialogflow, נהנה מזרימת המידע הבאה:
- משתמש שולח הודעה באפליקציית Chat, בצ'אט ישיר או במרחב ב-Chat.
- נציג וירטואלי של Dialogflow, שמאוחסן ב-Google Cloud, מקבל את ההודעה ומעבד אותה כדי ליצור תשובה.
- אפשר גם להשתמש בווּבק (webhook) של Dialogflow כדי שהסוכן של Dialogflow יוכל ליצור אינטראקציה עם שירותים חיצוניים של צד שלישי, כמו מערכת לניהול פרויקטים או כלי לניהול כרטיסים.
- סוכן Dialogflow שולח תשובה בחזרה לשירות של אפליקציית Chat ב-Chat.
- התשובה נשלחת למרחב ב-Chat.
הגדרת הסביבה
לפני שאתם משתמשים בממשקי Google API, אתם צריכים להפעיל אותם בפרויקט ב-Google Cloud. בכל פרויקט אפשר להפעיל ממשק API אחד או יותר.במסוף Google Cloud, מפעילים את Google Chat API ואת Dialogflow API.
מוודאים שמפעילים את ממשקי ה-API בפרויקט הנכון ב-Cloud ולוחצים על הבא.
מוודאים שמפעילים את ממשקי ה-API הנכונים ולוחצים על הפעלה.
יצירת סוכן Dialogflow CX
נציג וירטואלי של Dialogflow CX הוא נציג וירטואלי שמטפל בשיחות מקבילות עם משתמשי הקצה. זהו מודול להבנת שפה טבעית שמבין את הניואנסים של השפה האנושית. Dialogflow מתרגם טקסט של משתמשי קצה במהלך שיחה לנתונים מובנים שהאפליקציות והשירותים שלכם יכולים להבין. אתם מתכננים ויוצרים סוכן Dialogflow שיטפל בסוגי השיחות שנדרשים למערכת שלכם.
נציג ב-Dialogflow הוא כמו נציג אנושי במוקד טלפוני. אתם מאמנים את שניהם לטפל בתרחישי שיחה צפויים, והאימון לא צריך להיות מפורט מדי.
כך יוצרים את סוכן Dialogflow CX:
במסוף Dialogflow CX, פותחים את Dialogflow CX Console. לוחצים על תפריט > Dialogflow CX.
בוחרים פרויקט ב-Google Cloud. כדי למצוא את הפרויקט, יכול להיות שתצטרכו ללחוץ על הכול ואז לחפש אותו.
עכשיו אפשר לבחור סוכן וירטואלי מוכן מראש או ליצור סוכן וירטואלי משלכם. אם אתם מעדיפים לעיין בפרטים על התאמה אישית של נציגים בהמשך, אתם יכולים לבחור אחד מהנציגים המוכנים מראש, שיעזרו לכם להבין מה נציגים יכולים לעשות.
כדי לבחור סוכן מובנה מראש, פועלים לפי השלבים הבאים:
- לוחצים על שימוש בסוכנים מוכנים מראש.
בוחרים סוכן מובנה. במדריך הזה, בוחרים באפשרות נסיעות: השכרת רכב.
הסוכנים מקבלים דירוג של מתחילים, בינוניים או מתקדמים, בהתאם למספר התכונות שהסוכן משתמש בהן ולמורכבות של לוגיקת השיחה שלו. בחירה בסוכן ביניים או בסוכן מתקדם עשויה לדרוש התאמות אישיות והגדרות ספציפיות לסוכן, כולל הפעלת תכונות וממשקי API במסוף Google Cloud.
לוחצים על ייבוא כסוכן.
כדי ליצור סוכן משלכם, פועלים לפי השלבים הבאים:
- לוחצים על יצירת סוכן.
- בוחרים באפשרות יצירה אוטומטית כדי ליצור סוכן מאגר נתונים, או באפשרות יצירה משלך כדי ליצור סוגים אחרים של סוכנים.
הוראות מפורטות ליצירת סוכן זמינות במאמר יצירת סוכן Dialogflow CX.
קובעים את ההגדרות הבסיסיות של הסוכן:
- בשדה Display name, מזינים את השם לתצוגה.
- בוחרים את המיקום המועדף. אם רוצים לשנות את הגדרות המיקום המתקדמות, לוחצים על עריכה.
- בוחרים את אזור הזמן.
- בוחרים את שפת ברירת המחדל של הנציג. אי אפשר לשנות את שפת ברירת המחדל של נציג אחרי שיוצרים אותו.
לוחצים על יצירה. Dialogflow CX מתחיל ליצור את הסוכן, ואז מציג את זרימת ההתחלה שמוגדרת כברירת מחדל של הסוכן.
אפשר גם להתאים אישית את הסוכן. הוראות מפורטות ליצירת סוכן מותאם אישית זמינות במאמר יצירת סוכן Dialogflow CX.
מומלץ לבדוק את הסוכן:
- לוחצים על בדיקת הסוכן.
- בוחרים באפשרות בדיקת הסוכן בסביבה.
- בקטע Environment (סביבה), בוחרים באפשרות Draft (טיוטה).
- ב-Flow, בוחרים באפשרות Default Start Flow (ברירת מחדל של תהליך התחלה).
- בדף, בוחרים באפשרות דף הפתיחה.
- בשורת הכתיבה של Talk to agent, מקלידים
Helloומקישים על Enter. הסוכן מגיב בהצגה עצמית. - כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.
סוכן Dialogflow CX נוצר. חוזרים למסוף Dialogflow CX. לוחצים על תפריט > Dialogflow CX.
בקטע סוכנים, לוחצים על > העתקת השם. חשוב לשמור את השם הזה, כי תצטרכו אותו כשמגדירים את אפליקציית Chat.
יצירת אפליקציית צ'אט וקישור שלה לסוכן Dialogflow
אחרי שיוצרים סוכן Dialogflow CX, פועלים לפי השלבים הבאים כדי להפוך אותו לאפליקציית צ'אט:
במסוף Google Cloud, עוברים אל Google Chat API. מחפשים את Google Chat API ולוחצים על Google Chat API ואז על ניהול.
לוחצים על Configuration (הגדרה) ומגדירים את אפליקציית Chat:
- בשדה App name, מזינים
Dialogflow App. - בקטע כתובת ה-URL של הדמות, מזינים את הערך
https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png. - בשדה תיאור, מזינים
Responds to real human conversation. - בקטע פונקציונליות, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
- בקטע הגדרות חיבור, בוחרים באפשרות Dialogflow.
- בקטע הגדרות Dialogflow, בוחרים באפשרות Dialogflow CX.
- בשדה Agent or Environment resource name (שם המשאב של הסוכן או הסביבה), מדביקים את שם הסוכן של Dialogflow CX שהעתקתם בסוף השלב יצירת סוכן Dialogflow CX.
- הופכים את אפליקציית Chat לזמינה לאנשים ולקבוצות ספציפיים בדומיין ומזינים את כתובת האימייל.
- בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.
- בשדה App name, מזינים
לוחצים על שמירה.
אפליקציית Chat מוכנה לקבל הודעות ב-Chat ולענות להן.
בדיקת אפליקציית Chat
בודקים את אפליקציית הצ'אט של Dialogflow CX על ידי שליחת הודעה אליה ב-Google Chat.
פותחים את Google Chat באמצעות חשבון Google Workspace שציינתם כשנוספתם כבודקים מהימנים.
- לוחצים על שיחה חדשה.
- בשדה הוספת אדם אחד או יותר, מקלידים את השם של אפליקציית Chat.
בוחרים את אפליקציית Chat מתוך התוצאות. ייפתח צ'אט ישיר.
בצ'אט אישי החדש עם האפליקציה, כותבים
Helloולוחצים עלenter.אפליקציית הצ'אט של Dialogflow מציגה את עצמה.
- כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.
דוגמה לשיחה עם בוט
כדי לבדוק את אפליקציית הצ'אט של Dialogflow CX במסוף Dialogflow CX או ב-Google Chat, צריך לנהל את השיחה הבאה. ההסבר עוזר לכם להבין איך סוכן Dialogflow CX מפרש את השפה הטבעית של המשתמש ומפיק תשובה בשפה טבעית משלו בכל שלב בשיחה. הדוגמה הזו לשיחה מבוססת על סוכן וירטואלי מוכן מראש בשם Travel: car rental (נסיעות: השכרת רכב).
| Dialog | הסבר |
|---|---|
|
משתמש קצה: שלום נציג: שלום! אני סוכן וירטואלי להשכרת רכב. אוכל לעזור לך ליצור הזמנה חדשה להשכרת רכב. איך אוכל לעזור לך היום? |
|
|
משתמש קצה: אני רוצה לשכור רכב. נציג: איפה היית רוצה לאסוף את הרכב? |
|
|
משתמש קצה: לאס וגאס נציג: אוקיי, האיסוף יהיה בלאס וגאס. נציג: האם מיקום ההחזרה שונה ממיקום האיסוף? |
|
|
משתמש קצה: כן. אחזיר את הרכב בלוס אנג'לס. סוכן: בסדר, נקודת המסירה שלך תהיה בלוס אנג'לס. נציג: לאילו תאריך ושעה ברצונך לאסוף את הרכב? |
|
|
משתמש קצה: אני רוצה לאסוף את הרכב ב-5 במרץ בצהריים. נציג: לאילו תאריך ושעה ברצונך להחזיר את הרכב? |
|
|
משתמש קצה: 15 במרץ בצהריים. נציג: כדי לוודא: תאסוף את הרכב ב Las Vegas בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותו ב-Los Angeles בתאריך 2024-03-15 בשעה 12:00 האם זה נכון? |
|
|
משתמש קצה: כן, תודה. נציג: מצוין! עכשיו נבחר רכב. נציג: היית רוצה לשכור רכב חסכוני או רכב יוקרה? |
|
|
משתמש קצה: מחלקת תיירים, בבקשה. נציג: רוצה את מכונית Cymbal או את משאית Cymbal? |
|
|
משתמש קצה: Cymbal Truck. נציג: עגלת המטען של Cymbal עולה 50.33 USD ליום. היא מתאימה ל-4 אנשים ומגיעה עם רדיו AM/FM. רוצה להמשיך לתשלום? משתמש קצה: כן, בבקשה. |
|
|
נציג: באיזה סוג כרטיס תרצה להשתמש? משתמש קצה: אלטוסטרטוס נציג: עליך להזין את מספר הכרטיס. משתמש קצה: 1234 1234 1234 1234 נציג: מה השם שמופיע על הכרטיס? משתמש קצה: צ'ארלי נציג: מהי כתובת החיוב? משתמש קצה: 1800 Amphibious Blvd. Mountain View, CA נציג: מהו המיקוד לחיוב? משתמש קצה: 94045 נציג: תאסוף את Cymbal Car בלאס וגאס, בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותה, בתאריך 2024-03-15 בשעה 12:00. הסכום הכולל לנסיעה הזו יהיה 175.38$. נציג: תודה שבחרת לשכור מאיתנו, שיהיה לך יום נעים! |
|
שליחת הודעות בכרטיסים מ-Dialogflow
Dialogflow יכול להשיב עם הודעות טקסט או עם כרטיסים. כדי להשיב עם הודעת כרטיס, צריך לציין אותה כמטען ייעודי (payload) בהתאמה אישית בfulfillment.
קובץ ה-JSON הבא מראה איך לשלוח הודעת כרטיס כמטען ייעודי (payload) בהתאמה אישית ב-fulfillment:
json
{ "hostAppDataAction": { "chatDataAction": { "createMessageAction": {
"message": { "cardsV2": [{
"cardId": "createCardMessage",
"card": {
"header": {
"title": "A card message!",
"subtitle": "Sent from Dialogflow",
"imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
"imageType": "CIRCLE"
},
"sections": [{ "widgets": [{ "buttonList": { "buttons": [{
"text": "Read the docs!",
"onClick": { "openLink": {
"url": "https://developers.google.com/workspace/chat"
}}
}]}}]}]
}
}]}
}}}}
מגבלות ושיקולים
- כשמשתמשים בתוספים של Google Workspace עם Dialogflow, יש
מגבלות ושיקולים
לגבי אובייקטים של אירועים בצ'אט:
- אירועים בדף הבית של האפליקציה: עדיין אין תמיכה באירועים מסוג
APP_HOME. - Dialogflow Query Input: הטקסט שנשלח כקלט לשאילתה לסוכן Dialogflow תלוי בסוג האירוע:
-
MESSAGE: הערך של השדהargumentTextמהודעת הצ'אט. -
APP_COMMAND: המחרוזת"APP_COMMAND_PAYLOAD". -
ADDED_TO_SPACE: המחרוזת"ADDED_TO_SPACE_PAYLOAD". -
REMOVED_FROM_SPACE: המחרוזת"REMOVED_FROM_SPACE_PAYLOAD". -
CARD_CLICKED: המחרוזת"BUTTON_CLICKED_PAYLOAD". -
WIDGET_UPDATED: המחרוזת"WIDGET_UPDATED_PAYLOAD"(משמשת להשלמה אוטומטית).
-
- מטען ייעודי (payload) מלא של האירוע: מטען ייעודי (payload) מלא של JSON של אירוע האינטראקציה בצ'אט נשלח אל Dialogflow בשדה
WebhookRequest.payload. אפשר לגשת לזה ב-webhook של Dialogflow. מידע נוסף זמין במאמרי העזרה בנושא בקשות webhook ב-Dialogflow CX.
- אירועים בדף הבית של האפליקציה: עדיין אין תמיכה באירועים מסוג
- שיקולים לגבי תגובה לפקודות וקבלת נתונים מכרטיסים או מתיבות דו-שיח:
- אם סוכן Dialogflow צריך לעבד את מטען ה-JSON של אירוע האינטראקציה בצ'אט, הוא יכול לעשות זאת באמצעות Dialogflow webhook כדי לבדוק את המטען הייעודי (payload) בהתאמה אישית בפרמטר השאילתה.
- כדי להציג תיבת דו-שיח מסוכן Dialogflow, צריך להשיב עם מטען ייעודי (payload) יחיד של JSON בהתאמה אישית שמכיל אובייקט
RenderActionsעם הניווטpushCard. - כדי לעבד נתונים שהוזנו מכרטיסים, אפשר להשתמש בwebhook של Dialogflow ולהגיב באמצעות מטען ייעודי (payload) יחיד של JSON בהתאמה אישית שמכיל את הפעולה המתאימה.
- אין תמיכה בתצוגה מקדימה של קישורים.
- אם סוכן Dialogflow משיב בהודעה אחת בלבד, ההודעה נשלחת ל-Google Chat באופן סינכרוני. אם הנציג ב-Dialogflow מגיב עם כמה הודעות, כל ההודעות נשלחות ל-Chat באופן אסינכרוני על ידי קריאה לשיטה
createבמשאבspaces.messagesב-Chat API פעם אחת לכל הודעה. - כשמשתמשים בשילוב של Dialogflow CX עם Chat, הסוכן של Dialogflow ואפליקציית Chat צריכים להיות מוגדרים באותו פרויקט בענן של Google Cloud. אם אתם צריכים להגדיר את Dialogflow ואת Chat בפרויקטים שונים ב-Cloud, אתם יכולים להגדיר שרת ביניים כדי לאפשר את החיבור. כאן ב-GitHub אפשר לראות דוגמה לשילוב של Chat עם Dialogflow CX.
פתרון בעיות
כדי לנפות באגים באפליקציית Chat, כדאי להתחיל בבדיקת יומני השגיאות. האפליקציה הזו משתמשת ב-Dialogflow, ולכן יש לכם כמה משאבים לרישום ביומן ולפתרון בעיות:
יומנים של תוספים ל-Google Workspace: יומני שאילתות שמכילים מידע מפורט על ההתנהגות של התוסף, כולל האינטראקציות שלו עם Chat. פרטים נוספים זמינים במאמר בנושא יומני שאילתות לתוספים ל-Google Workspace.
שגיאות באפליקציית Google Chat: לפתרון בעיות כלליות באפליקציית Chat, אפשר לעיין במאמר פתרון בעיות באפליקציית Chat.
Dialogflow CX Cloud Logging: מוודאים ש-Cloud Logging מופעל בהגדרות של סוכן Dialogflow כדי לתעד יומני ביצוע מפורטים, כולל שגיאות מהסוכן ומהאינטראקציות עם התגובה לפעולה מאתר אחר (webhook). איך מפעילים ומגדירים את התכונה הזו במסמכי התיעוד של סוכן Dialogflow CX אפשר לצפות ביומנים האלה ב-Logs Explorer במסוף Google Cloud.
היסטוריית שיחות ב-Dialogflow CX: אפשר לעיין באינטראקציות קודמות כדי להבין את זרימת השיחה ולזהות איפה מתרחשות בעיות. מידע נוסף על היסטוריית השיחות
פתרון בעיות כלליות ב-Dialogflow: לבעיות כלליות יותר ב-Dialogflow, אפשר לעיין במדריך לפתרון בעיות ב-Dialogflow CX.
הסרת המשאבים
כדי להימנע מחיובים בחשבון Google Cloud בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט בענן.
- במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete .
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
נושאים קשורים
- Dialogflow CX משתמש בגישה של מכונת מצבים לעיצוב סוכנים ב-Dialogflow, וכך מאפשר לכם שליטה ברורה ומפורשת בשיחה, חוויית משתמש טובה יותר וזרימת עבודה טובה יותר לפיתוח. כשיוצרים אפליקציית צ'אט של Dialogflow, מומלץ להשתמש ב-Dialogflow CX.
- מידע נוסף על יצירה והגדרה של סוכנים זמין במאמר סוכני Dialogflow CX.
- הוראות מפורטות ליצירה ולהגדרה של סוכנים זמינות במאמר יצירת סוכן Dialogflow CX.
- Dialogflow ES היא דרך נוספת להשתמש ב-Dialogflow עם אפליקציית צ'אט.