בדף הזה מוסבר איך לבנות אפליקציית Google Chat שיכולה להבין שפה טבעית ולענות באמצעותה באמצעות Dialogflow. במדריך הזה נעשה שימוש ב-Dialogflow CX, שמשולב ישירות עם Google Chat. אפשר גם להשתמש ב-Dialogflow ES כדי ליצור אפליקציית Google Chat של Dialogflow ES. לשם כך, צריך לפעול לפי ההוראות במדריך Dialogflow ES Google Chat.
לדוגמה, אפליקציית צ'אט שעוזרת לאנשים לשכור מכוניות. משתמש יכול לכתוב, למשל, "אני רוצה לשכור רכב". אפליקציית Chat עשויה להגיב בשאלה כמו "איפה תרצה לאסוף את הרכב?" וכך להתחיל שיחה עם המשתמש שדומה לשיחה עם בן אדם, שבה אפליקציית Chat מבינה את המשתמש ומגיבה לו בדיבור אנושי בזמן הזמנת השכרת הרכב.
זו רק דוגמה אחת. אפליקציות Chat של Dialogflow שימושיות בכל מיני אינטראקציות. אם נדרשת בו דיבור אנושי טבעי, צריך להשתמש באפליקציית Dialogflow Chat. הסוכנים המוכנים מראש עוזרים להתחיל במהירות ומציגים את היכולות של Dialogflow, כמו:
- הזמנת טיסות
- קביעת תורים לרופאים
- הזמנת משלוח אוכל
- לענות על שאלות לגבי קטלוג מוצרים קמעונאי, למשל אם פריטים זמינים בצבעים אחרים
-
איור 1. בחירת נציג מוכן מראש לאפליקציית צ'אט ב-Dialogflow. -
איור 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, מקבל את ההודעה ומעבד אותה כדי ליצור תגובה.
- אפשר גם להשתמש בווּבק של 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 (ברירת מחדל של התחלת זרימה).
- בדף, בוחרים באפשרות דף הפתיחה.
- בסרגל הכתיבה של שיחה עם נציג, מקלידים
Helloומקישים על Enter. הנציג מציג את עצמו. - כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.
הסוכן של Dialogflow CX נוצר. חוזרים למסוף Dialogflow CX. לוחצים על תפריט > Dialogflow CX.
בקטע סוכנים, לוחצים על > העתקת השם. חשוב לשמור את השם הזה, כי תצטרכו אותו כשמגדירים את אפליקציית Chat.
יצירת אפליקציה ל-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 Chat מציגה את עצמה.
- כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.
שיחה לדוגמה עם בוט
כדי לבדוק את אפליקציית הצ'אט של Dialogflow CX במסוף Dialogflow CX או ב-Google Chat, צריך לנהל את השיחה הבאה. ההסבר עוזר לכם להבין איך סוכן Dialogflow CX מפרש את השפה הטבעית של המשתמש ומפיק תשובה בשפה טבעית משלו בכל שלב בשיחה. השיחה לדוגמה הזו מבוססת על נציג וירטואלי מוכן מראש בשם Travel: car rental (נסיעות: השכרת רכב).
| Dialog | הסבר |
|---|---|
|
משתמש קצה: שלום נציג: שלום! אני סוכן וירטואלי להשכרת רכב. אוכל לעזור לך ליצור הזמנה חדשה להשכרת רכב. איך אוכל לעזור לך היום? |
|
|
משתמש קצה: אני רוצה לשכור רכב. נציג: איפה היית רוצה לאסוף את הרכב? |
|
|
משתמש קצה: לאס וגאס נציג: בסדר, האיסוף יהיה בלאס וגאס. נציג: האם מיקום ההחזרה שונה ממיקום האיסוף? |
|
|
משתמש קצה: כן. אחזיר את הרכב בלוס אנג'לס. נציג: בסדר, נקודת המסירה שלך תהיה בלוס אנג'לס. נציג: לאילו תאריך ושעה ברצונך לאסוף את הרכב? |
|
|
משתמש קצה: אני רוצה לאסוף את הרכב ב-5 במרץ בצהריים. נציג: לאילו תאריך ושעה ברצונך להחזיר את הרכב? |
|
|
משתמש קצה: 15 במרץ בצהריים. נציג: כדי לוודא: תאסוף את הרכב ב לאס וגאס בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותו בלוס אנג'לס בתאריך 2024-03-15 בשעה 12:00 האם זה נכון? |
|
|
משתמש קצה: כן, תודה. נציג: מצוין! עכשיו נבחר רכב. נציג: היית רוצה לשכור רכב חסכוני או רכב יוקרתי? |
|
|
משתמש קצה: משלוח בסיסי, בבקשה. נציג: תרצה את מכונית המצילה או את משאית המצילה? |
|
|
משתמש קצה: 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, יש מגבלות ושיקולים לגבי
- אובייקטים של אירועים ב-Chat
- אירועים בדף הבית של האפליקציה: עדיין אין תמיכה באירועים מסוג
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 של אירוע האינטראקציה בצ'אט, הוא יכול לעשות זאת באמצעות webhook של Dialogflow כדי לבדוק את המטען הייעודי (payload) בפרמטר השאילתה.
- כדי להציג תיבת דו-שיח מסוכן Dialogflow, צריך להשיב עם מטען ייעודי (payload) יחיד של JSON בהתאמה אישית שמכיל אובייקט
RenderActionsעם הניווטpushCard. - כדי לעבד נתונים שמוזנים מכרטיסים, אפשר להשתמש בwebhook של Dialogflow ולהגיב באמצעות מטען ייעודי (payload) יחיד של JSON מותאם אישית שמכיל את הפעולה המתאימה.
create במשאב spaces.messages ב-Chat API פעם אחת לכל הודעה.פתרון בעיות
כדי לנפות באגים באפליקציית 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 בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט 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 עם אפליקציית צ'אט.