איך מפתחים אפליקציית Dialogflow CX ל-Google Chat שמבינה ומגיבה בשפה טבעית

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

לדוגמה, אפליקציה ל-Chat שעוזרת לאנשים לשכור מכוניות. משתמש יכול לכתוב, "אני רוצה לשכור רכב". אפליקציית Chat עשויה להגיב בשאלה כמו "איפה תרצה לאסוף את הרכב?" שמתחילה שיחה דמוית אדם עם המשתמש, שבה אפליקציית Chat מבינה ומגיבה בדיבור אנושי בזמן הזמנת השכרת הרכב.

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

  • הזמנת טיסות
  • קביעת תורים לרופא
  • הזמנת משלוח אוכל
  • לענות על שאלות לגבי קטלוג מוצרים קמעונאי, כמו אם פריטים זמינים בצבעים אחרים
  • דף הבחירה של סוכן Dialogflow מוכן מראש.
    איור 1. בחירת סוכן מוכן מראש לאפליקציית Dialogflow Chat.
  • בדיקת הסוכן ב-Dialogflow CX.
    איור 2. בודקים את הסוכן ב-Dialogflow CX כדי לוודא שהלוגיקה וההגדרה של הסוכן פועלות כמצופה. בדיאגרמה מוצגת קבוצה עוקבת של דפים בנושאים שקשורים לשלבים ספציפיים בשיחה, כמו הגדרת מיקום לאיסוף ולהחזרה של רכב להשכרה, ומוגדר הלוגיקה שמקשרת ביניהם. השיחה נבדקת בסימולטור.
  • הגדרת אפליקציית צ'אט של Dialogflow.
    איור 3. הגדרה של אפליקציית Chat לעיבוד תשובות באמצעות סוכן Dialogflow CX בדף ההגדרה של Chat API במסוף Google Cloud.
  • בדיקת אפליקציית הצ'אט של Dialogflow CX
    איור 4. שיחה על הזמנת רכב להשכרה עם אפליקציית הצ'אט של Dialogflow ב-Google Chat.

מטרות

  • מגדירים את הסביבה.
  • יוצרים ופורסים סוכן Dialogflow CX.
  • יצירה ופריסה של אפליקציה ל-Chat שמבוססת על סוכן Dialogflow CX.
  • בודקים את אפליקציית Chat.

דרישות מוקדמות

ארכיטקטורה

התרשים הבא מציג את הארכיטקטורה של אפליקציית צ'אט שנבנתה באמצעות Dialogflow:

ארכיטקטורה של אפליקציית Chat שהוטמעה באמצעות Dialogflow.

בתרשים שלמעלה, משתמש שמקיים אינטראקציה עם אפליקציית צ'אט של Dialogflow, נהנה מזרימת המידע הבאה:

  1. משתמש שולח הודעה באפליקציית Chat, בצ'אט ישיר או במרחב ב-Chat.
  2. סוכן וירטואלי של Dialogflow, ששייך ל-Google Cloud, מקבל את ההודעה ומעבד אותה כדי ליצור תשובה.
  3. אפשר גם להשתמש בווּבּהוּק של Dialogflow כדי שהסוכן של Dialogflow יוכל ליצור אינטראקציה עם שירותים חיצוניים של צד שלישי, כמו מערכת לניהול פרויקטים או כלי לניהול כרטיסים.
  4. סוכן Dialogflow שולח תשובה בחזרה לשירות של אפליקציית Chat ב-Chat.
  5. התשובה נשלחת למרחב ב-Chat.

הגדרת הסביבה

לפני שאתם משתמשים בממשקי Google API, אתם צריכים להפעיל אותם בפרויקט ב-Google Cloud. בכל פרויקט אפשר להפעיל ממשק API אחד או יותר.

  1. במסוף Google Cloud, מפעילים את Google Chat API ואת Dialogflow API.

    הפעלת ממשקי ה-API

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

  3. מוודאים שמפעילים את ממשקי ה-API הנכונים ולוחצים על הפעלה.

יצירת סוכן Dialogflow CX

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

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

כך יוצרים את סוכן ה-CX ב-Dialogflow CX:

  1. במסוף Dialogflow CX, פותחים את Dialogflow CX Console. לוחצים על תפריט > Dialogflow CX.

    כניסה למסוף Dialogflow CX

  2. בוחרים פרויקט ב-Google Cloud. כדי למצוא את הפרויקט, יכול להיות שתצטרכו ללחוץ על הכול ואז לחפש אותו.

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

    כדי לבחור סוכן מובנה מראש:

    1. לוחצים על שימוש בסוכנים מוכנים מראש.

    2. בוחרים סוכן מוכן מראש. במדריך הזה, בוחרים באפשרות נסיעות: השכרת רכב.

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

    3. לוחצים על ייבוא כסוכן.

    כדי ליצור סוכן משלכם, פועלים לפי השלבים הבאים:

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

    הוראות מפורטות ליצירת סוכן CX זמינות במאמר יצירת סוכן Dialogflow CX.

  4. קובעים את ההגדרות הבסיסיות של הסוכן:

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

  5. לוחצים על יצירה. ‫Dialogflow CX מתחיל ליצור את הסוכן, ואז מציג את זרימת ההתחלה שמוגדרת כברירת מחדל של הסוכן.

  6. אפשר גם להתאים אישית את הסוכן. הוראות מפורטות ליצירת סוכן CX זמינות במאמר יצירת סוכן Dialogflow CX.

  7. מומלץ לבדוק את הסוכן:

    1. לוחצים על בדיקת הסוכן.
    2. בוחרים באפשרות בדיקת הסוכן בסביבה.
    3. בקטע Environment (סביבה), בוחרים באפשרות Draft (טיוטה).
    4. ב-Flow, בוחרים באפשרות Default Start Flow (ברירת מחדל של תהליך התחלה).
    5. בדף, בוחרים באפשרות דף הפתיחה.
    6. בשורת הכתיבה של Talk to agent, מקלידים Hello ומקישים על Enter. הסוכן מציג את עצמו.
    7. כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.

  8. הסוכן של Dialogflow CX נוצר. חוזרים למסוף Dialogflow CX. לוחצים על תפריט > Dialogflow CX.

    כניסה למסוף Dialogflow CX

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

יצירת אפליקציית צ'אט וקישור שלה לסוכן Dialogflow

אחרי שיוצרים סוכן Dialogflow CX, פועלים לפי השלבים הבאים כדי להפוך אותו לאפליקציית צ'אט:

  1. במסוף Google Cloud, עוברים אל Google Chat API. מחפשים את Google Chat API ולוחצים על Google Chat API ואז על ניהול.

    ל-Chat API

  2. לוחצים על Configuration (הגדרה) ומגדירים את אפליקציית Chat:

    1. בשדה App name, מזינים Dialogflow App.
    2. בקטע כתובת ה-URL של האווטאר, מזינים את הערך https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    3. בשדה תיאור, מזינים Responds to real human conversation.
    4. בקטע פונקציונליות, בוחרים באפשרות הצטרפות למרחבים ולשיחות קבוצתיות.
    5. בקטע הגדרות חיבור, בוחרים באפשרות Dialogflow.
    6. בקטע הגדרות Dialogflow, בוחרים באפשרות Dialogflow CX.
    7. בשדה Agent or Environment resource name (שם המשאב של הסוכן או הסביבה), מדביקים את שם סוכן ה-CX של Dialogflow שהעתקתם בסוף השלב יצירת סוכן Dialogflow CX.
    8. האפליקציה הזו של Chat תהיה זמינה לאנשים ולקבוצות ספציפיים בדומיין שלכם, ואז מזינים את כתובת האימייל שלכם.
    9. בקטע יומנים, בוחרים באפשרות רישום שגיאות ביומן.

  3. לוחצים על שמירה.

אפליקציית Chat מוכנה לקבל הודעות ב-Chat ולענות עליהן.

בדיקת אפליקציית Chat

בודקים את אפליקציית הצ'אט של Dialogflow CX על ידי שליחת הודעה אליה ב-Google Chat.

  1. פותחים את Google Chat באמצעות חשבון Google Workspace שציינתם כשנרשמתם כבודקים מהימנים.

    מעבר אל Google Chat

  2. לוחצים על צ'אט חדש.
  3. בשדה Add 1 or more people (הוספת אדם אחד או יותר), מקלידים את השם של אפליקציית Chat.

  4. בוחרים את אפליקציית Chat מתוך התוצאות. ייפתח צ'אט ישיר.

  5. בצ'אט הישיר החדש עם האפליקציה, כותבים Hello ולוחצים על enter.

    אפליקציית הצ'אט של Dialogflow מציגה את עצמה בתגובה.

  6. כדי להשלים את הבדיקה, צריך לנהל את שיחת הבדיקה לדוגמה.

דוגמה לשיחה במבחן

כדי לבדוק את אפליקציית הצ'אט של Dialogflow CX במסוף Dialogflow CX או ב-Google Chat, צריך לנהל את השיחה הבאה. ההסבר עוזר להבין איך סוכן Dialogflow CX מפרש את השפה הטבעית של המשתמש ומפיק תשובה בשפה טבעית בכל שלב בשיחה. השיחה לדוגמה הזו מבוססת על סוכן מוכן מראש בשם Travel: car rental (תיירות: השכרת רכב).

Dialog הסבר
משתמש קצה: שלום
נציג: שלום! אני סוכן וירטואלי להשכרת רכב. אני יכול לעזור לך ליצור הזמנה חדשה להשכרת רכב. איך אוכל לעזור לך היום?
  1. מופעל המסלול Default Welcome Intent ב-Default Start Flow.
  2. ההשלמה של ה-state handler הזה ("היי! אני...") נוספת לתור התשובות.
  3. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: אני רוצה לשכור רכב.
נציג: מאיפה תרצה לאסוף את הרכב?
  1. המסלול של כוונת המשתמש car_rental.reservation_create בדף ההתחלה תואם.
  2. הסשן עובר לדף נקודת איסוף.
  3. הטופס בדף מיקום איסוף לא הושלם, ולכן הסוכן משתמש בפרמטר pickup_location כדי להציג למשתמש הנחיה ("איפה תרצה לאסוף את..."), הבקשה נוספת לתור התגובות.
  4. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: לאס וגאס
נציג: אוקיי, האיסוף יהיה בלאס וגאס.
נציג: האם מיקום ההחזרה שונה ממיקום האיסוף?
  1. קלט משתמש הקצה ממלא את הפרמטר pickup_location שנכלל בבקשה של הסוכן בתור הקודם של השיחה.
  2. המסלול של כוונת המשתמש car_rental.return_different_location בזרימת ההתחלה שמוגדרת כברירת מחדל מותאם.
  3. המסלול להשלמת הטופס בדף מיקום האיסוף מוערך ומופעל. יש לה מילוי בקשה ("Ok, your pickup..."), שנוסף לתור התגובות עם הפניות לפרמטרים שפוענחו לערכים בפועל שסופקו על ידי משתמש הקצה.
  4. ההפעלה עוברת לדף אישור מיקום.
  5. בדף אישור המיקום יש שדה למילוי פרטים ("האם מיקום המסירה שונה..."), הבקשה נוספת לתור התגובות.
  6. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: כן. אחזיר את הרכב בלוס אנג'לס.
סוכן: בסדר, נקודת המסירה שלך תהיה בלוס אנג'לס.
נציג: לאילו תאריך ושעה ברצונך לאסוף את הרכב?
  1. המסלול של כוונת המשתמש car_rental.return_different_location בזרימת ההתחלה שמוגדרת כברירת מחדל מותאם.
  2. הפעילות באתר עוברת לדף מיקום ההחזרה.
  3. הקלט של משתמש הקצה ממלא את הפרמטר drop_off_location שהסוכן ביקש בתור הקודם של השיחה.
  4. המסלול להשלמת הטופס בדף Drop Off Location מוערך ומופעל. היא כוללת ביצוע ("Ok, your drop off..."), שנוסף לתור התגובות.
  5. הפעילות באתר עוברת לדף משך ההשכרה.
  6. בדף משך ההשכרה יש ערכים חלקיים בטופס, ולכן המערכת מציגה למשתמש את הפרמטר pickup_date_time ("באיזה תאריך ובאיזו שעה תרצה לאסוף את..."), הבקשה נוספת לתור התגובות.
  7. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: אני רוצה לאסוף את הרכב ב-5 במרץ בצהריים.
נציג: לאילו תאריך ושעה ברצונך להחזיר את הרכב?
  1. קלט משתמש הקצה ממלא את הפרמטר pickup_date_time שנכלל בבקשה של הסוכן בתור הקודם של השיחה.
  2. בדף Rental Duration חסר ערך נוסף בטופס, ולכן המשתמש מתבקש להזין את הפרמטר drop_off_date_time ("What date and time would you like to drop off..."), הבקשה נוספת לתור התגובות.
  3. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: 15 במרץ בצהריים.
נציג: כדי לוודא:

תאסוף את הרכב ב לאס וגאס בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותו בלוס אנג'לס בתאריך 2024-03-15 בשעה 12:00

האם זה נכון?
  1. הקלט של משתמש הקצה ממלא את הפרמטר drop_off_date_time שהסוכן ביקש בתור הקודם של השיחה.
  2. הפעילות באתר עוברת לדף אישור משך ההשכרה.
  3. בדף Confirm Rental Duration (אישור משך ההשכרה) יש מילוי של פרטי הכניסה ("So to confirm..."), הבקשה נוספת לתור התגובות.
  4. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: כן, תודה.
נציג: מצוין! עכשיו נבחר רכב.
נציג: היית רוצה רכב חסכוני או רכב יוקרתי?
  1. הנתיב של כוונת המשתמש small_talk.confirmation.yes בדף Confirm Rental Duration מותאם.
  2. הנציג מאשר את הבחירה של המשתמש בהודעה ("מעולה! עכשיו נבחר…"), הבקשה נוספת לתור התגובות.
  3. הפעילות באתר עוברת לדף Vehicle Disambiguation.
  4. הטופס בדף Vehicle Disambiguation לא הושלם, ולכן הסוכן משתמש בפרמטר vehicle_type כדי להציג למשתמש הנחיה ("Would you like an economy or luxury..."), הבקשה נוספת לתור התגובות.
  5. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: משלוח בסיסי, בבקשה.
נציג: רוצה את מכונית הצלצלים או את משאית הצלצלים?
  1. הכוונה $session.params.vehicle_type="economy_vehicle" מתאימה למסלול.
  2. הסשן עובר לדף Economy Options (אפשרויות חסכוניות).
  3. בדף Economy Options (אפשרויות חסכוניות) יש רשומה של מילוי הזמנה (Would you like the...). הבקשה נוספת לתור התגובות.
  4. הסוכן שולח את תור התשובות למשתמש הקצה.
משתמש קצה: Cymbal Truck.
נציג: המחיר של Cymbal Truck הוא ‎50.33 USD ליום. היא מתאימה ל-4 אנשים ומגיעה עם רדיו AM/FM. רוצה להמשיך לתשלום?
משתמש קצה: כן, בבקשה.
  1. המסלול של כוונת $session.params.vehicle_type="Cymbal Truck" מותאם והפרמטר vehicle_model מתמלא.
  2. הסשן עובר לדף Confirm Cymbal Truck.
  3. בדף Confirm Cymbal Truck יש מילוי של הזמנה ("The Cymbal Truck is $50.33 per day..."), הבקשה נוספת לתור התגובות.
  4. הסוכן שולח את תור התשובות למשתמש הקצה.
  5. התשובה של המשתמש תואמת לנתיב small_talk.confirmation.yes.
נציג: באיזה סוג כרטיס תרצה להשתמש?
משתמש קצה: אלטוסטרטוס
נציג: עליך להזין את מספר הכרטיס.
משתמש קצה: 1234 1234 1234 1234
נציג: מה השם שמופיע על הכרטיס?
משתמש קצה: צ'ארלי
נציג: מהי הכתובת לחיוב?
משתמש קצה: רחוב שביל הפסגות 23, תל אביב-יפו
נציג: מהו המיקוד לחיוב?
משתמש קצה: 94045
נציג: תאסוף את רכב הצלצלים בלאס וגאס, בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותו, בתאריך 2024-03-15 בשעה 12:00. הסכום הכולל לנסיעה הזו יהיה 175.38$.
נציג: תודה ששכרת אצלנו, שיהיה לך יום נעים!
  1. הסשן עובר לדף תשלום.
  2. הטופס Payment לא הושלם, ולכן הנציג מבקש מהמשתמש את הפרמטרים card_type,‏ card_number, ‏ billing_name,‏ billing_street_address ו-billing_zip_code ("What card type will..."), התשובות האלה מתווספות ברצף לתור התשובות ונשלחות כשהמשתמש מגיב. התשובות של המשתמש מגדירות את ערך הפרמטר.
  3. הפעילות באתר עוברת לדף אישור השכרה.
  4. בדף אישור השכרת הרכב יש אישור על השלמת ההזמנה ("האיסוף יתבצע בתאריך..."), הבקשה נוספת לתור התגובות.
  5. הסוכן שולח את תור התשובות למשתמש הקצה.
  6. הסשן עובר לדף סיום הסשן.

שליחת הודעות עם כרטיסים מ-Dialogflow

‫Dialogflow יכול להשיב באמצעות הודעות טקסט או כרטיס. כדי להשיב עם הודעת כרטיס, צריך לציין אותה כמטען ייעודי (payload) מותאם אישית בביצוע.

קובץ ה-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 Chat עם Dialogflow, יש כמה מגבלות ושיקולים שצריך לקחת בחשבון לגבי אובייקטים של אירועים ב-Chat:
    • אירועים בדף הבית של האפליקציה: עדיין אין תמיכה באירועים מסוג APP_HOME.
    • קלט שאילתה ב-Dialogflow: הטקסט שנשלח כקלט שאילתה לסוכן 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 משיב בהודעה אחת בלבד, ההודעה נשלחת ל-Google Chat באופן סינכרוני. אם נציג Dialogflow מגיב עם כמה הודעות, כל ההודעות נשלחות ל-Chat באופן אסינכרוני על ידי קריאה לשיטה create במשאב spaces.messages ב-Chat API פעם אחת לכל הודעה.
  • כשמשתמשים בשילוב של Dialogflow CX עם Chat, הסוכן של Dialogflow ואפליקציית Chat צריכים להיות מוגדרים באותו פרויקט בענן של Google Cloud. אם אתם צריכים להגדיר את Dialogflow ואת Chat בפרויקטים שונים ב-Cloud, אתם יכולים להגדיר שרת ביניים כדי לאפשר את החיבור. מידע נוסף זמין בדוגמה לשילוב של Chat עם Dialogflow CX ב-GitHub.

פתרון בעיות

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

  • יומני רישום של תוספים ל-Google Workspace: אפשר להריץ שאילתות ביומני הרישום כדי לקבל מידע מפורט על ההתנהגות של אפליקציית Chat, כולל האינטראקציות שלה עם 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 בגלל השימוש במשאבים שנעשה במסגרת המדריך הזה, מומלץ למחוק את פרויקט בענן.

  1. במסוף Google Cloud, עוברים לדף Manage resources. לוחצים על תפריט > IAM & Admin > Manage Resources.

    כניסה ל-Resource Manager

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על מחיקה .
  3. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
  • ‫Dialogflow CX משתמש בגישה של מכונת מצבים לעיצוב סוכנים ב-Dialogflow. הגישה הזו מאפשרת לכם לשלוט בשיחה בצורה ברורה ומפורשת, לשפר את חוויית משתמשי הקצה ולשפר את תהליך העבודה של הפיתוח. כשיוצרים אפליקציית צ'אט של Dialogflow, מומלץ להשתמש ב-Dialogflow CX.
  • ‫Dialogflow ES היא דרך נוספת להשתמש ב-Dialogflow עם אפליקציית צ'אט.

אפליקציות ל-Chat שהן לא תוספים: יצירת אפליקציה ל-Google Chat ב-Dialogflow CX

אם אתם בונים או מתחזקים אפליקציית Chat שהיא לא תוסף ל-Google Workspace, שימו לב להבדלים הבאים בהגדרות, במטען הייעודי (payload) ובאירועים.

הגדרה של אפליקציית צ'אט ב-Dialogflow CX שלא מוגדרת כתוסף

כשמגדירים את Google Chat API במסוף Google Cloud:

  1. מבטלים את הסימון של Build this Chat app as a Google Workspace add-on (פיתוח אפליקציית Chat כתוסף ל-Google Workspace). תיפתח תיבת דו-שיח שבה תתבקשו לאשר את הפעולה. בתיבת הדו-שיח, לוחצים על השבתה.
  2. משלימים את שאר הגדרות התצורה של Dialogflow CX ולוחצים על שמירה.

שליחת הודעות עם כרטיסים מאפליקציית Chat של Dialogflow CX שהיא לא תוסף

באפליקציית Chat שהיא לא תוסף, מציינים אובייקט cardsV2 ברמה העליונה במטען הייעודי (payload) בהתאמה אישית ב-Dialogflow fulfillment:

json

{
  "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"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

מגבלות ושיקולים לגבי אפליקציות צ'אט של Dialogflow CX שאינן תוספים

  • אירועים של אינטראקציות בצ'אט נתמכים וצריך לקחת בחשבון את הנקודות הבאות:
    • אלה סוגי אירועי האינטראקציה שנתמכים:
      • MESSAGE
      • ADDED_TO_SPACE
      • CARD_CLICKED
    • באירועים מסוג MESSAGE או ADDED_TO_SPACE, קלט השאילתה שנשלח לסוכן Dialogflow תואם לערך של השדה argumentText בהודעה בצ'אט. אם ההודעה כוללת פקודה דרך שורת הפקודות, נעשה שימוש בערך של השדה text.
    • באירועים מסוג CARD_CLICKED, הקלט של השאילתה שנשלח לסוכן Dialogflow מעוצב כ-CARD_CLICKED.functionName, כאשר functionName תואם לערך של השדה function באובייקט Action שמצורף לרכיב הכרטיס האינטראקטיבי (כמו כפתור).
    • המטען הייעודי (payload) המלא בפורמט JSON של כל אירוע אינטראקציה ב-Chat נשלח ל-Dialogflow כמטען ייעודי (payload) מותאם אישית בפרמטרים של שאילתה, ואפשר לגשת אליו באמצעות webhook של Dialogflow על ידי שליחת שאילתה לגבי הערך של השדה WebhookRequest.payload.
  • היבטים שצריך לקחת בחשבון כשמשיבים לפקודות דרך שורת הפקודות ומקבלים נתונים מכרטיסים או מתיבות דו-שיח באפליקציות ל-Chat שהן לא תוספים:
    • כשאפליקציות Chat של Dialogflow שאינן תוספים מקבלות הודעה עם פקודה דרך שורת הפקודות, קלט השאילתה מכיל רק את הערך של השדה text. השדה text מתחיל בשם של פקודה דרך שורת הפקודות (לדוגמה, /command), שאפשר להשתמש בה כדי להגדיר את כוונת הסוכן של Dialogflow לזיהוי פקודה דרך שורת הפקודות.
    • כדי להציג תיבת דו-שיח מסוכן Dialogflow באפליקציית Chat שהיא לא תוסף, צריך להשיב עם מטען ייעודי (payload) יחיד בפורמט JSON שכולל הודעה שמכילה DIALOGתגובה לפעולה.
    • כדי לעבד נתונים שמוזנים מכרטיסים באפליקציית Chat שהיא לא תוסף, סוכן Dialogflow יכול לזהות כוונות שמתחילות בטקסט CARD_CLICKED ולהגיב באמצעות מטען ייעודי (payload) יחיד בפורמט JSON בהתאמה אישית שמכיל את הפעולה המתאימה.