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

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

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

ארכיטקטורה

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

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

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

הגדרת הסביבה

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. לוחצים על תפריט menu > Dialogflow CX.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   מעבר אל Google Chat

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

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

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

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

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

שיחה לדוגמה עם המורה

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

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

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

קובץ ה-JSON הבא מראה איך לשלוח הודעת כרטיס כמטען ייעודי (payload) בהתאמה אישית ב-fulfillment:

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

פתרון בעיות

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

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

הסרת המשאבים

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

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

   כניסה ל-Resource Manager

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

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

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