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

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

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

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

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

• חשבון Google Workspace במהדורת Business או Enterprise עם גישה ל-Google Chat.
• פרויקט ב-Google Cloud שהחיוב בו מופעל. כדי לבדוק אם החיוב מופעל בפרויקט קיים, אפשר לעיין במאמר אימות סטטוס החיוב של הפרויקטים. כדי ליצור פרויקט ולהגדיר חיוב, אפשר לקרוא את המאמר יצירת פרויקט ב-Google Cloud.

ארכיטקטורה

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

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

1. משתמש שולח הודעה באפליקציית Chat, בצ'אט ישיר או במרחב ב-Chat.
2. סוכן וירטואלי של Dialogflow, ששייך ל-Google Cloud, מקבל את ההודעה ומעבד אותה כדי ליצור תשובה.
3. אופציונלית, באמצעות Dialogflow webhook, סוכן 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 הוא כמו נציג אנושי במוקד טלפוני. אתם מאמנים את שניהם לטפל בתרחישי שיחה צפויים, והאימון לא צריך להיות מפורט מדי.

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

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

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

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

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

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

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

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

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

   3. לוחצים על ייבוא כנציג.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בדיקת אפליקציית צ'אט

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

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

   מעבר אל Google Chat

2. לוחצים על צ'אט חדש.
3. בשדה הוספת אדם אחד או יותר, מקלידים את השם של אפליקציית Chat.

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

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

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

   אפליקציית Dialogflow Chat תציג את עצמה.

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

דוגמה לשיחה עם בוט

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

Dialog	הסבר
משתמש קצה: שלום נציג: שלום! אני סוכן וירטואלי להשכרת רכב. אוכל לעזור לך ליצור הזמנה חדשה להשכרת רכב. איך אוכל לעזור לך היום?	הנתיב Default Welcome Intent ב-Default Start Flow נקרא. ההשלמה של ה-state handler הזה ("היי! אני...") נוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: אני רוצה לשכור רכב. נציג: איפה היית רוצה לאסוף את הרכב?	הנתיב של כוונת המשתמש car_rental.reservation_create בדף ההתחלה תואם. הסשן עובר לדף מיקום האיסוף. הטופס בדף מיקום איסוף לא הושלם, ולכן הסוכן משתמש בפרמטר pickup_location כדי להציג למשתמש הנחיה ("איפה תרצה לאסוף..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: לאס וגאס נציג: בסדר, האיסוף יהיה בלאס וגאס. נציג: האם מיקום ההחזרה שונה ממיקום האיסוף?	הקלט של משתמש הקצה ממלא את הפרמטר pickup_location שנדרש על ידי הסוכן בתור הקודם של השיחה. הכוונה car_rental.return_different_location מותאמת לניתוב בDefault Start Flow. המסלול להשלמת הטופס בדף מיקום האיסוף מוערך ומופעל. יש לה תגובה ("Ok, your pickup..."), שנוספת לתור התגובות עם הפניות לפרמטרים שלה שפוענחו לערכים בפועל שסופקו על ידי משתמש הקצה. השיחה מועברת לדף אישור המיקום. בדף אישור המיקום יש שדה למילוי פרטים ("האם מיקום המסירה שונה..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: כן. אחזיר את הרכב בלוס אנג'לס. נציג: אוקיי, נקודת המסירה שלך תהיה בלוס אנג'לס. נציג: לאילו תאריך ושעה ברצונך לאסוף את הרכב?	הכוונה car_rental.return_different_location מותאמת לניתוב בDefault Start Flow. ההפעלה עוברת לדף מיקום מסירת החבילה. הקלט של משתמש הקצה ממלא את הפרמטר drop_off_location שנציג ביקש בתור הקודם של השיחה. המסלול להשלמת הטופס בדף Drop Off Location מוערך ומופעל. היא כוללת ביצוע ("Ok, your drop off..."), שנוסף לתור התגובות. הפעילות עוברת לדף משך ההשכרה. בדף משך ההשכרה יש ערכים חלקיים בטופס, ולכן המערכת מבקשת מהמשתמש להזין את הפרמטר pickup_date_time ('באיזה תאריך ובאיזו שעה תרצה לאסוף את...'), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: אני רוצה לאסוף את הרכב ב-5 במרץ בצהריים. נציג: לאילו תאריך ושעה ברצונך להחזיר את הרכב?	הקלט של משתמש הקצה ממלא את הפרמטר pickup_date_time שנדרש על ידי הסוכן בתור הקודם של השיחה. בדף Rental Duration חסר ערך נוסף בטופס, ולכן המערכת מבקשת מהמשתמש את הפרמטר drop_off_date_time ("What date and time would you like to drop off..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: 15 במרץ בצהריים. נציג: כדי לוודא: תאסוף את הרכב ב לאס וגאס בתאריך 2024-03-05 בשעה 12:00 ותחזיר אותו בלוס אנג'לס בתאריך 2024-03-15 בשעה 12:00 האם זה נכון?	הקלט של משתמש הקצה ממלא את הפרמטר drop_off_date_time שהסוכן ביקש בתור הקודם בשיחה. ההפעלה עוברת לדף אישור משך ההשכרה. בדף Confirm Rental Duration יש רשומה של השלמת הזמנה ("So to confirm..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: כן, תודה. נציג: מצוין! עכשיו נבחר רכב. נציג: היית רוצה לשכור רכב חסכוני או רכב יוקרתי?	הנתיב של כוונת small_talk.confirmation.yes בדף Confirm Rental Duration מותאם. הנציג מאשר את הבחירה של המשתמש בהודעה ("מעולה! עכשיו נבחר…"), שנוספת לתור התגובות. הפעילות באתר עוברת לדף Vehicle Disambiguation (הסרת דו-משמעות לגבי הרכב). הטופס בדף Vehicle Disambiguation לא הושלם, ולכן הסוכן משתמש בפרמטר vehicle_type כדי להציג למשתמש הנחיה ("Would you like an economy or luxury..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: משלוח בסיסי, בבקשה. נציג: תרצה את מכונית Cymbal או את משאית Cymbal?	הכוונה $session.params.vehicle_type="economy_vehicle" תואמת למסלול. הסשן עובר לדף Economy Options (אפשרויות כלכליות). בדף Economy Options (אפשרויות חסכוניות) יש אפשרות למילוי הזמנה ("Would you like the..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה.
משתמש קצה: Cymbal Truck. נציג: מחיר השכרת משאית Cymbal הוא ‎50.33 USD ליום. היא מתאימה ל-4 אנשים ומגיעה עם רדיו AM/FM. רוצה להמשיך לתשלום? משתמש קצה: כן, בבקשה.	הנתיב של כוונת $session.params.vehicle_type="Cymbal Truck" מותאם והפרמטר vehicle_model מתמלא. ההפעלה עוברת לדף Confirm Cymbal Truck. בדף Confirm Cymbal Truck יש מילוי של פרטי הזמנה ("The Cymbal Truck is $50.33 per day..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה. התשובה של המשתמש תואמת לנתיב small_talk.confirmation.yes.
נציג: באיזה סוג כרטיס תרצה להשתמש? משתמש קצה: אלטוסטרטוס נציג: עליך להזין את מספר הכרטיס. משתמש קצה: 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$. נציג: תודה שבחרת לשכור מאיתנו, שיהיה לך יום נעים!	ההפעלה עוברת לדף תשלום. טופס התשלום לא הושלם, ולכן הסוכן מבקש מהמשתמש את הפרמטרים card_type,‏ card_number, ‏ billing_name,‏ billing_street_address ו-billing_zip_code ("איזה סוג כרטיס..."), שנוספים ברצף לתור התגובות ונשלחים כשהמשתמש מגיב. התשובות של המשתמש מגדירות את הערך של כל פרמטר. הפעילות באתר עוברת לדף אישור השכרה. בדף אישור ההזמנה יש אישור על השלמת ההזמנה ("האיסוף יתבצע ב..."), שנוספת לתור התגובות. הסוכן שולח את תור התגובות למשתמש הקצה. הסשן עובר לדף סיום הסשן.

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

Codelab: דוגמה מעשית לשליחת הודעות עם כרטיסים מ-Dialogflow מופיעה במאמר הצגת מקורות בתשובות של אפליקציית צ'אט עם ידע ב-codelab בנושא בניית אפליקציות ל-Google Chat באמצעות Gemini.

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

קוד ה-JSON הבא מראה איך לשלוח הודעת כרטיס כמטען ייעודי (payload) בהתאמה אישית ב-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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

מגבלות ושיקולים

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

פתרון בעיות

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

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

הסרת המשאבים

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

זהירות: כשמוחקים פרויקט:

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

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

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

   כניסה ל-Resource Manager

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

נושאים קשורים

• ‫Dialogflow CX משתמש בגישה של מכונת מצבים לעיצוב סוכני Dialogflow, וכך מאפשר לכם שליטה ברורה ומפורשת בשיחה, חוויית משתמש טובה יותר ותהליך פיתוח יעיל יותר. כשמפתחים אפליקציית צ'אט של Dialogflow, מומלץ להשתמש ב-Dialogflow CX.
  • מידע נוסף על יצירה והגדרה של סוכנים זמין במאמר סוכני Dialogflow CX.
  • הוראות מפורטות ליצירה ולהגדרה של סוכנים מופיעות במאמר יצירת סוכן Dialogflow CX.
  • Codelab: דוגמה לאופן שבו בונים סוכן מאגר נתונים של Dialogflow CX אפשר לראות באפליקציית Chat של בסיס הידע מתוך ה-codelab‏ Build apps for Google Chat with Gemini (פיתוח אפליקציות ל-Google Chat באמצעות Gemini).
  • Codelab: כדי לראות דוגמה לאופן שבו אפשר לבנות סוכן בממשק שיחה של Dialogflow CX, אפשר לעיין באפליקציית הצ'אט למשוב מתוך ה-codelab Build apps for Google Chat with Gemini (פיתוח אפליקציות ל-Google Chat באמצעות Gemini).
• ‫Dialogflow ES היא דרך נוספת להשתמש ב-Dialogflow עם אפליקציית צ'אט.