התנסות מעשית: סדנת נשים בקול

1. מבוא

בשיעור ה-Lab הזה תפתחו פעולה פשוטה באמצעות Dialogflow ותלמדו איך לשלב אותה עם Google Assistant.

התרגילים מאורגנים כדי לשקף חוויה נפוצה של מפתחי ענן:

1. יצירת נציג של Dialogflow גרסה 2
2. יצירת ישויות
3. יצירת כוונות
4. הגדרת תגובה לפעולה מאתר אחר (webhook) באמצעות פונקציות של GCP Cloud
5. שימוש במאגר הידע כדי לייבא שאלות נפוצות
6. בדיקת הצ'אט בוט
7. הפעלת השילוב של Google Assistant

מה תפַתחו

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

מה תלמדו

• איך יוצרים צ'אט בוט באמצעות Dialogflow v2
• איך יוצרים שיחה לינארית באמצעות Dialogflow
• איך להשתמש בישויות
• איך להשתמש במאגר הידע
• איך מגדירים מילוי הזמנות ב-webhook בפונקציות של Dialogflow ו-GCP
• איך מעבירים את האפליקציה אל Google Assistant באמצעות Actions on Google

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

• כדי ליצור נציג ב-Dialogflow צריך כתובת ב-Google Identity או ב-Gmail.
• אנחנו נספק לך זיכויים בענן ל-GCP עבור השימוש ב-GCP Cloud Functions
• כדי לקבל את נתוני הנציג, צריך לגשת לגיליון הציבורי הזה ב-Google Sheets.
• פותחים אותו בכרטיסייה חדשה: https://docs.google.com/spreadsheets/d/1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY/edit?usp=sharing
• לא נדרש ידע בסיסי ב-JavaScript, אבל הוא יכול לעזור לכם אם רוצים לשנות את קוד האספקה של התגובה לפעולה מאתר אחר (webhook).

2. בתהליך ההגדרה

אם יש לכם כמה כתובות Gmail, עדיף להשתמש בדפדפן הפרטי כי נעביר אותו בין כמה כלים של Google.

הפעלת פעילות באינטרנט בדפדפן

1. לוחצים על: http://myaccount.google.com/activitycontrols

בקרת הפעילות בחשבון Google

2. הקפדה על חיפוש באינטרנט ההגדרה 'פעילות באפליקציות' מופעלת:

יצירת נציג ב-Dialogflow

1. פותחים את: https://console.dialogflow.com

מסוף של Dialogflow

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

3. בחירת שם הנציג: yourname-wiv (באמצעות שם משלך)
4. כברירת המחדל של שפת ברירת המחדל, בוחרים באפשרות אנגלית – en
5. כאזור הזמן שמוגדר כברירת מחדל, בוחרים את אזור הזמן הקרוב ביותר אליכם.
6. לא בוחרים באפשרות Mega Agent. (בעזרת התכונה הזו אפשר ליצור סוכן מקיף שיכול לתזמר בין סוכני "תת". אנחנו לא צריכים את זה עכשיו.)
7. לחץ על צור.

הגדרה של Dialogflow

1. בתפריט הימני, לוחצים על סמל גלגל השיניים ליד שם הפרויקט.

2. מזינים את תיאור הנציג הבא: נשים בנציג של Voice.
3. כדי להפעיל תכונות בטא, גוללים למטה אל תכונות בטא והופכים את המתג הרצוי.
4. גוללים למטה אל Log Settings (הגדרות היומן) והופכים את שני המתגים כדי לרשום את האינטראקציות של Dialogflow וכדי לתעד את כל האינטראקציות ב-Google Cloud Stackdriver. נזדקק למידע הזה בהמשך, אם נרצה לנפות באגים בפעולה שלנו.

5. לוחצים על שמירה.
6. לוחצים על סיום

הגדרת Actions on Google

1. לוחצים על הקישור ל-Google Assistant בחלונית השמאלית, בקטע איך זה עובד ב-Google Assistant.

הפעולה הזו תפתח את הכתובת: http://console.actions.google.com

הערה: חשוב לוודא שאתם מחוברים לאותו חשבון Google שאיתו נכנסתם ל-Dialogflow.

משתמשים חדשים ב-Actions on Google צריכים למלא קודם את הטופס הזה:

2. מנסים לפתוח את הפעולה בסימולטור** על ידי לחיצה על שם הפרויקט.**
3. בוחרים באפשרות פיתוח בסרגל התפריטים.

מבטלים את הסימון של האפשרות התאמה להגדרת השפה של המשתמש. כדי לוודא ששפת ברירת המחדל של Assistant לא תחרוג מהמרת הטקסט לדיבור.

5. לוחצים על שמירה.
6. בוחרים באפשרות בדיקה בסרגל התפריטים.

6. מוודאים שההגדרה של הסימולטור היא אנגלית ולוחצים על דיבור לאפליקציית הבדיקה שלי.

הפעולה הזו תכיל את פניכם, עם הגדרת ברירת המחדל הבסיסית של Dialogflow. המשמעות היא שהגדרת השילוב עם Action on Google עבדה!

הגדרת Google Cloud

למדריך זה נדרש חשבון GCP עם חשבון לחיוב. אם עדיין אין לכם חשבון, תוכלו ליצור חשבון לפי השלבים הבאים.

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

כדי ליצור חשבון GCP תקין, צריך Cloud Identity. - אם זו הפעם הראשונה שאתם משתמשים ב-GCP, כדאי להיכנס לחשבון Google / Gmail. אם ברצונך להשתמש ב-GCP בדומיין שלך (אבל לא הגדרת דומיין דרך G Suite), יהיה עליך לאמת את הדומיין. אפשר להיעזר בהוראות שבדף הזה: https://support.google.com/a/answer/7331243).

1. עוברים לכתובת ה-URL ומתחברים.

gcpcredits.com/wivnl

2. לוחצים: לוחצים כאן כדי לגשת לזיכויים
3. לוחצים על 'אישור' ו כן, אני רוצה

הכול מוכן. יצרתם חשבון לחיוב בסכום של 25 דולר, והם אמורים להספיק כדי להשתמש ב-Cloud Functions למשך זמן רב.

הפעלת Google Sheets API

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

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

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

1. אם עדיין לא עשיתם זאת, פותחים את הגיליון האלקטרוני הזה ב-Google Sheets בכרטיסייה חדשה בדפדפן:
2. https://docs.google.com/spreadsheets/d/1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY/edit#gid=1240329448
3. חשוב: צריך ליצור עותק של הגיליון הזה. לוחצים על קובץ > יצירת עותק
4. אחרי העתקת הגיליון, לוחצים על שיתוף
5. נצטרך לתת לחשבון השירות של Dialogflow הרשאות עריכה. כדי לעשות זאת, פותחים את Dialogflow > הגדרות (גלגל גלגל השיניים).
6. גוללים למטה אל Google Project.
7. מעתיקים את כתובת חשבון השירות (אימייל). הוא אמור להיראות בערך כך: dialogflow-<someid>@<my-gcp-project>.iam.gserviceaccount.com

5. מדביקים את חשבון השירות בחלון הקופץ 'שיתוף' ב-Google Sheets ומעניקים לו הרשאות עריכה.

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

    The Sheets URL will look something like this:

https://docs.google.com/spreadsheets/d/1fPd8b_z19U7ZzAaY327QhYoogn6q8c1rpGSNF8KIR_o/edit#gid=1240329448

    But we are only interested in the Sheet id, which is the part between:

https://docs.google.com/spreadsheets/d/ ו-/edit#gid=1240329448 (בלי לוכסנים).

    So it will look something like this: **1fPd8b_z19U7ZzAaY327QhYoogn6q8c1rpGSNF8KIR_o**

    **Write this Sheet ID down**, or copy it to Notepad. In the Webhook steps we will use this again.

7. פתיחה בכרטיסייה אחרת בדפדפן. http://console.cloud.google.com. (אם יש לכם פרויקטים נוספים ב-Google Cloud, צריך להפעיל את הפרויקט החדש ב-Dialogflow: yourname-wiv). – בסרגל החיפוש מחפשים את האפשרות: Google Sheets API

8. לוחצים על האפשרות הזאת ואז על הלחצן הפעלת Google Sheets API בחלק העליון של המסך.

3. ישויות מותאמות אישית

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

"אני רוצה טיפ לקריאה על

צ'אט בוטים

/ אני רוצה טיפ לקריאה על

voice*"*

בין אם אתם אומרים צ'אט בוטים, Voice או שניהם, הנתונים יאספו מישות מותאמת אישית שתשמש כפרמטר בבקשה שלי לשירות אינטרנט.

מידע נוסף על ישויות של Dialogflow

יצירת ישות הערוץ

1. לוחצים במסוף Dialogflow על האפשרות שבתפריט: ישויות.
2. לוחצים על יצירת ישות
3. שם הישות: tech (יש להקפיד להשתמש באותיות קטנות בלבד)
4. מציינים את האפשרויות עם המילים הנרדפות. (אפשר להקיש על Tab כדי לעבור בין הממשק).

• Chatbots - Chatbots, Chat, Web
• Voice - Voice, Voicebots, Voice Assistants
• Both - Both, All

5**.** עוברים למצב **עריכה גולמית** בלחיצה על לחצן התפריט שליד לחצן השמירה הכחול.

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

"Chatbots","Chatbots","Chat","Web"
"Voice","Voice","Voicebots","Voice Assistants"
"Both","Both","All"

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

4. כוונות

ב-Dialogflow נעשה שימוש בכוונות כדי לסווג את כוונות המשתמש. לאובייקטים מסוג Intent יש ביטויים לאימון, שהם דוגמאות למה שמשתמש עשוי לומר לנציג.

לדוגמה, משתמש שרוצה לדעת מי רוצה לדעת מתי האירוע הבא יתקיים, עשוי לשאול:

מתי המפגש הבא?

כשמשתמש כותב או אומר משהו, שנקרא ביטוי משתמש, מערכת Dialogflow מתאימה את ביטוי המשתמש לכוונה הטובה ביותר של הנציג שלכם. התאמה של כוונת רכישה נקראת גם סיווג כוונת רכישה.

מידע נוסף על מנגנוני Intent של Dialogflow

שינוי של Intent הודעת הפתיחה שמוגדר כברירת מחדל

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

1. לוחצים על Intents > ברירת המחדל של כוונת הרכישה של ה-Intent

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

זו הודעת הפתיחה לגבי ברירת המחדל של Intent קבלת הפנים:

משתמש	נציג
"Ok Google, talk to <yourname>-WIV"	"היי, אני דנה, הנציגה הווירטואלית של נשים ב-Voice"."אפשר לבקש ממני מידע על מפגשים, נשים ב-Voice או טיפ לקריאה. "מה היית רוצה לדעת?"

2. גוללים למטה אל תגובות.
3. ניקוי כל תגובות הטקסט.
4. בכרטיסיית ברירת המחדל, יוצרים את 3 התשובות הבאות. (לוחצים על 'הוספת תשובות' > 'טקסט' או 'תגובה של SSML', בכל שורה חדשה:)

• היי, אני אנה, הנציגה הווירטואלית של נשים ב-Voice.
• אפשר לבקש ממני מידע על מפגשים, נשים ב-Voice או טיפ לקריאה.
• מה ברצונך לדעת?

ההגדרות האישיות אמורות להיות דומות לצילום המסך הזה.

5. הפלט הקודם משמש צ'אט בוטים. אנחנו יכולים לשנות מעט את הפלט, במיוחד עבור Google Assistant. נשתמש ב-SSML (Speech Synthesis Markup Language) כדי ליצור השהיות במשפטים שלנו. לוחצים על הכרטיסייה Google Assistant.

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

Hey there, I'm Anna, the virtual agent of Women in Voice.

You can ask me for information about meetups, Women in Voice or a reading tip. What would you like to know?

• לאחר מכן לוחצים על התאמה אישית של פלט האודיו
• ומוסיפים את גרסת SSML הבאה:

<speak><p><s>Hey there, I'm Anna, the virtual agent of Women in Voice.</s><s>

You can ask me for information about meetups, Women in Voice or a reading tip.</s></p><break time="500ms"/><p><s> What would you like to know?</s></p></speak>

ההגדרות האישיות אמורות להיות דומות לצילום המסך הזה.

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

כאן תוכלו למצוא מידע נוסף על SSML ל-Actions on Google.

7. בואו נבדוק את הכוונה הזו. קודם כל נוכל לבדוק את זה בסימולטור של Dialogflow.

מקלידים: Hello. אמור להחזיר את ההודעה הזו.

8. עכשיו חוזרים למסוף Actions on Google.

(מומלץ לשמור את הקובץ בכרטיסייה אחרת).

פעולות ב-Google Console

לוחצים על: "דיבור אל אפליקציית הבדיקה שלי". ועליך להאזין להודעת הפתיחה החדשה.

שינוי ה-Intent המוגדר כברירת מחדל כחלופה

1. לוחצים על Intents > ברירת מחדל של Intent חלופי
2. גוללים למטה אל תגובות.
3. ניקוי כל תגובות הטקסט.
4. בכרטיסיית ברירת המחדל, יוצרים את התשובות הבאות, כל אחת בשורה חדשה, כך שניתן יהיה לעבור בין האפשרויות הבאות:

• Sorry, can you repeat this?
• I didn't understand you. You can ask me questions about Women in Voice, a book or article tip or when the next meetup will be.

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

הערה: אם לא מזינים פלט של Google Assistant, היא תוגדר לברירת המחדל.

יוצרים את כוונת העצירה

1. לוחצים על האפשרות Intents בתפריט.
2. לוחצים על Create Intent.
3. מזינים את שם ה-Intent: Stop Intent
4. לוחצים על הוספת ביטויים לאימון.

• No
• That's it
• Bye
• I don't want that
• Goodbye
• It's ok for now
• Quit
• I want to stop
• Close this
• End the conversation

4. גוללים למטה אל תגובות.> הוספת תשובה
5. מוסיפים את אפשרויות הטקסט הבאות:

• Alright! Hopefully we will see you at one of our meetups!
• No problem. See you at one of our meetups!

6. מחליפים את המצב של המתג: הגדרת Intent כסיום השיחה. כך המערכת תוודא ברגע שכוונת ה-Intent הזו תתאים, הפעולה של Google Assistant תיסגר.

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

יצירת כוונת המפגש

מטרת המפגש תכלול את החלק הבא בשיחה:

משתמש	נציג
מתי המפגש הבא?	"המפגש הבא יהיה ב-<date> בשעה <time> ב<location>. הנושא יהיה <topic>. והדוברים הם: <speakers>. אפשר להירשם באמצעות הניוזלטר שלנו."

1. לוחצים על האפשרות Intents בתפריט.
2. לוחצים על Create Intent.
3. מזינים את שם ה-Intent: Meetup Intent (חשוב להשתמש באות M ובאותיות גדולות (I) - אם תאיתו את הכוונה בצורה שונה, השירות לקצה העורפי לא יפעל!)
4. לוחצים על הוספת ביטויים לאימון.

• When is the next meetup?
• Do you have any events?
• Which events are in the planning?
• Are there meetup events soon?
• I would love to attend a meetup
• Can I join a virtual meetup?
• When will you get together?
• Can I join?
• What does your calendar look like?

5. לוחצים על מילוי הזמנה > הפעלת האפשרות למילוי הזמנות

6. מחליפים את המצב של המתג הפעלת קריאה לפעולה מאתר אחר (webhook) עבור ה-Intent הזה.

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

יוצרים את כוונת לטיפ

המטרה של הטיפ לכלול את החלק הבא בשיחה:

משתמש	נציג
"אני רוצה לקבל טיפ לקריאה".	"רוצה לקרוא עוד על צ'אט בוטים, קול או שניהם?"
"קול"	"מעולה, הנה הטיפ היומי! התג <type> &lt;title&gt; של <author>. רוצה טיפ נוסף על ספר או מאמר? אוכל גם לתת לך מידע נוסף על מפגשים או על מה שאנחנו עושים. איך אפשר לעזור?"

1. לוחצים שוב על האפשרות Intents בתפריט.
2. לוחצים על Create Intent.
3. מזינים את שם ה-Intent: Tip Intent (חשוב להשתמש באות L גדולה ו-I גדולה. - אם תאיתו את הכוונה בצורה שונה, השירות לקצה העורפי לא יפעל!)
4. לוחצים על הוספת ביטויי אימון ומוסיפים את הפרטים הבאים:

• Can I get a tip for an article?
• I would like to receive a reading tip
• Any book tips?
• What's nice to read?
• I want to learn more about Chatbots, what should I read?
• What are nice blogs?
• Do you have book suggestions?
• I want to receive information about Both
• Can I have Chatbots reading tip
• I would like to read more about Voice
• Voice please
• Both are okay.
• Reading tip
• Tip
• Blog
• Article
• Book
• Book suggestions
• Yes
• Yeah
• Another tip
• Yes one more

5. גוללים למטה אל פעולות ופרמטרים.
6. סימון טכנולוגיה כנדרש

הערה: במקום להשתמש בפרמטרים הנדרשים עם הנחיות, אפשר גם ליצור אובייקטים מסוג Intent נוספים. כדאי להשתמש בכוונות המשך (ושמירה על הקשר), בסגנון שיחה דינמי יותר. אם היית רואה את השיחה כמבנה עץ, כוונות המשך יהיו הסתעפויות השונות. כאשר הפרמטרים הנדרשים הם בעצם ממלאים מקומות (חובה) שנדרשים לשירות אינטרנט כדי להחזיר תוצאות.

לוחצים על Configure Prompt ומזינים:

• Do you want to read more about Chatbots, Voice or Both?

8. לוחצים על מילוי הזמנה > הפעלת האפשרות למילוי הזמנות

הפעם אנחנו לא כותבים את התשובה בתוך הקוד. התשובה תגיע מהפונקציה של Cloud Functions! כך הופכים את המתג הפעלת קריאה לפעולה לפעולה מאתר אחר (webhook) עבור ה-Intent הזה.

לוחצים על מילוי הזמנה > הפעלת האפשרות למילוי הזמנות

10. מחליפים את המצב של המתג הפעלת קריאה לפעולה מאתר אחר (webhook) עבור ה-Intent הזה.

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

5. מחברי ידע

מחברי ידע משלימים כוונות מוגדרות. הם מנתחים מסמכי ידע כדי למצוא תשובות אוטומטיות. (למשל: שאלות נפוצות או מאמרים מקובצי CSV, אתרים באינטרנט ואפילו קובצי PDF!) כדי להגדיר אותם, צריך להגדיר מאגר ידע אחד או יותר, שהם אוספים של מסמכי ידע.

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

אבל יש טריק! ניתן להמיר שאלות נפוצות ל'כוונות אמיתיות'. וזה מאפשר גם לספק ביטויים לאימון.

מידע נוסף על מחברי ידע

בואו ננסה את זה.

1. בוחרים את התג en כדי לבחור את השפה האנגלית בתפריט העליון.
2. בוחרים באפשרות ידע (בטא) בתפריט.

3. לוחצים על הלחצן הכחול הימני: יצירת מאגר ידע
4. להקליד שם של מאגר ידע. נשים ב-Voice ולוחצים על שמירה.
5. לוחצים על יצירת הקישור הראשון.

6. פעולה זו תפתח חלון.

משתמשים בהגדרות הבאות:

שם המסמך: גיליון שאלות נפוצות בנושא נשים ב-Voice

סוג ידע: שאלות נפוצות

סוג Mime: CSV

7. נצטרך את הנתונים מהגיליון הזה, יש לוודא שגיליון הנתונים פתוח ולבחור בכרטיסייה 'שאלות נפוצות'.
8. בוחרים באפשרות קובץ > הורדה > CSV

9. חוזרים ל-Dialogflow, לוחצים על Upload File from computer (העלאת קובץ מהמחשב) ובוחרים את קובץ ה-CSV שהורדתם. לוחצים על Create.

נוצר מאגר ידע:

10. לוחצים על הוספת תגובה.

יוצרים את התשובות הבאות ולוחצים על שמירה:

$Knowledge.Answer[1]

11. לוחצים על הצגת פרטים.

יוצגו כל השאלות הנפוצות שהטמעתם ב-Dialogflow.

זה קל!

לתשומת ליבכם, אתם יכולים גם להפנות לאתר HTML אונליין עם שאלות נפוצות כדי לייבא שאלות נפוצות לנציג שלכם. אפשר אפילו להעלות קובץ PDF עם קטע טקסט, ו-Dialogflow יציג שאלות.

12. כדי לחזור לכל המחברים של מאגר הידע, לוחצים על Knowledge (בטא) בתפריט של Dialogflow.
13. אפשר לשנות את העוצמה והחולשה של מאגר הידע. זה הגיוני, אם אתם חושבים שהשאלות הנפוצות מנצחות או מפסידות מכוונות משלכם. אין לנו הרבה כוונות, אז כדאי לחזק את מאגר הידע שלנו. שינוי קנה המידה ל--0.2. לאחר גרירת פס ההזזה, הערך יישמר באופן אוטומטי.

עכשיו יש להתייחס לשאלות הנפוצות כ'תוספות' שצריך להוסיף לנציגים שלכם, ליד כוונתכם. אי אפשר לאמן את המודל באמצעות שאלות נפוצות של מאגר הידע. לכן, יכול להיות שלא תהיה התאמה אם שואלים שאלות בדרך אחרת לגמרי, כי לא נעשה בהן שימוש ב-Natural Language Understanding (מודלים של למידת מכונה). לכן לפעמים כדאי להמיר את השאלות הנפוצות לכוונות.

6. מילוי הזמנות של ה-webhook

יצירת פונקציה של Google Cloud Functions

1. עוברים אל http://console.cloud.google.com בכרטיסייה אחרת בדפדפן.
2. בוחרים בתפריט הימני Cloud Functions
3. לוחצים על Create Function (יצירת פונקציה).

4. מציינים את ההגדרות האישיות הבאות:

• שם: dialogflow
• הזיכרון שהוקצה: 256MiB
• טריגר: HTTP
• מעתיקים את כתובת ה-URL ללוח.
• בוחרים באפשרות עורך מוטבע
• זמן ריצה: NodeJS 8
• פונקציה להרצה: dialogflow

5. מוודאים שתיבת הסימון הזו מסומנת:

6. הנה התוכן של package.json. צריך להעתיק ולהדביק את הקובץ הזה בכרטיסייה package.json של העורך.

קטע הקוד הזה טוען את ספריות ה-NPM הנכונות ל-Google Cloud:

{
 "name": "dialogflow",
 "description": "Cloud Functions",
 "engines": {
   "node": "8"
 },
 "dependencies": {
   "request": "^2.85.0",
   "request-promise": "^4.2.5",
   "dialogflow-fulfillment": "^0.6.1",
   "actions-on-google": "^2.2.0",
   "googleapis": "^48.0.0",
   "moment": "^2.24.0"
 },
 "devDependencies": {
   "eslint": "^5.12.0",
   "eslint-plugin-promise": "^4.0.1",
   "ngrok": "^3.2.7"
 },
 "private": true
}

7. הנה התוכן של ה-index.js. צריך להעתיק ולהדביק את הכתובת הזו בכרטיסייה index.js של העורך.

קטע הקוד הזה ישולב עם ספריית googleapis כדי לאחזר נתונים מגיליון Google Sheets. נעשה בו שימוש בספרייה actions-on-google כדי להציג כרטיסים במכשיר עם Google Assistant. הוא משתמש בספרייה dialogflow-fulfillment כדי לסווג כוונות של Dialogflow. והיא משתמשת ברגע בספרייה כדי לטפל באובייקטים של תאריך ושעה.

/* jshint esversion: 8 */
'use strict';

process.env.DEBUG = 'dialogflow:debug';

const ACCOUNTS_SHEET_ID = '1UWx3WYVCrqz0D4uJ_pO56WeqEPa9rQDG1cfc_H11kgY';

const {
 BasicCard,
 Button,
} = require('actions-on-google');

const {google} = require('googleapis');
const moment = require('moment');
moment.locale('nl');
const { WebhookClient } = require('dialogflow-fulfillment');
var books;
var meetups;

const SHEETS_SCOPE = 'https://www.googleapis.com/auth/spreadsheets.readonly';

/**
* Authenticates the Sheets API client for read-only access.
*
* @return {Object} sheets client
*/
async function getSheetsClient() {
   // Should change this to file.only probably
   const auth = await google.auth.getClient({
       scopes: [SHEETS_SCOPE],
   });
   return google.sheets({version: 'v4', auth});
}

/**
* Return a natural spoken date
* @param {string} date in 'YYYY-MM-DD' format
* @returns {string}
*/
var getSpokenDate = function(date){
   let datetime = moment(date, 'YYYY-MM-DD');
   return `${datetime.format('D MMMM')}`;
};


/* When the tipIntent Intent gets invoked.  */
function tipIntent(agent) {
 var par = agent.parameters.tech;
   var selection = [];
   //console.log(par);
   //console.log(books);
    for(var i = 0; i<books.length; i++){
     if(books[i][2].toLowerCase() == par.toLowerCase()) {
         selection.push(books[i]);
       }
   }
    var random = Math.floor(Math.random() * selection.length);
   var booktip = selection[random];
   //console.log(selection[random]);

   let spokenText = `<p><s>Alright, here's the tip of the day!</s></p><p>The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.</p>`;
   let writtenText = `Alright, here's the tip of the day! The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.`;
   //console.log(booktip[8]);
    if (agent.requestSource === agent.ACTIONS_ON_GOOGLE) {
       let conv = agent.conv();
       conv.ask(`<speak>${spokenText}</speak>`);
       conv.ask(new BasicCard({
           title: `Tip of the day!`,
           subtitle: `${par}`,
           text: `The ${booktip[6]} ${booktip[0]} of ${booktip[1]}.`,
           buttons: new Button({
               title: 'Read',
               url: `${booktip[8]}`,
           })
       }));
       conv.ask(`<speak><p><s>Do you want another book or article tip? Also, I can tell you more about meetups or what we do. How can I help?</s></p></speak>`);
       // Add Actions on Google library responses to your agent's response
       agent.add(conv);
   } else {
       agent.add(writtenText + ' Do you want another book or article tip? Also, I can tell you more about meetups or what we do. How can I help?');
   }
}


function meetupIntent(agent) {
 let conv = agent.conv();
 let record;
  console.log(meetups);
  for(var i = 0; i<meetups.length; i++){
   let d = moment(meetups[i][0], 'YYYY-MM-DD');
   let today = moment(new Date());

   if(moment(d).isSameOrAfter(today)) {
     // the i event is not in the past
     record = meetups[i];
     console.log(record);
     break; 
   }
 }
  let date = getSpokenDate(record[0]);
 let spokenText1 = `The next meetup will be ${date} at ${record[1]} in ${record[3]}.`;
 let spokenText2 = `The topic will be <emphasis level="moderate">${record[2]}.</emphasis>`;
 let spokenText3 = `You can register via our newsletter.`;
  let writtenText = `${spokenText1} The topic will be ${record[2]}. ${spokenText3}`;

 if (agent.requestSource === agent.ACTIONS_ON_GOOGLE) {
   conv.ask(`<speak>${spokenText1} ${spokenText2} ${spokenText3}</speak>`);
   conv.ask(new BasicCard({
     title: `Meetup`,
     subtitle: `${record[2]}`,
     text: `${record[0]} ${record[1]} - ${record[3]}`,
     buttons: new Button({
       title: 'Register',
       url: `http://www.meetup.com`
     })
   }));
   conv.ask('<speak><p><s>Is there anything else I can help you with?</s></p></speak>');
   agent.add(conv);
 } else {
   agent.add(`${writtenText} Is there anything else I can help you with?`);
 }
}

exports.dialogflow = async (request, response) => {
 var agent = new WebhookClient({ request, response });

 console.log('Dialogflow Request headers: ' + JSON.stringify(request.headers));
 console.log('Dialogflow Request body: ' + JSON.stringify(request.body));
  const client = await getSheetsClient();   
 const allBooks = await client.spreadsheets.values.get({
   spreadsheetId: ACCOUNTS_SHEET_ID,
   range: 'Books&Blogs!A:I',
 });
 const allEvents = await client.spreadsheets.values.get({
   spreadsheetId: ACCOUNTS_SHEET_ID,
   range: 'Meetups!A:D',
 });
  books = allBooks.data.values;
 meetups = allEvents.data.values;
 books.shift();
 meetups.shift();

 var intentMap = new Map();
 intentMap.set('Tip Intent', tipIntent);
 intentMap.set('Meetup Intent', meetupIntent);
 agent.handleRequest(intentMap);
};

8. לחיצה על הקישור 'משתני סביבה', 'רישות, זמן קצוב לתפוגה' ועוד

9. בוחרים את חשבון השירות Dialogflow Integrations.

(כברירת מחדל הוא משתמש בחשבון שירות של GAE App Engine, אבל החשבון הזה צריך להיות זהה לחשבון השירות ששותף בתוך Google Sheets, בשלבים הראשונים של המדריך הזה).

10. לפני שנפרוס את הפונקציה של Cloud Functions. נשנה שורה אחת בקוד שלנו בכרטיסייה index.js. שורת הקוד השלישית:

const ACCOUNTS_SHEET_ID = '1Yo_E8KONgSiUm00ZmTOqtjXCwULmc2JuI3sjxRyvrkE';

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

11. עכשיו אנחנו מוכנים. לוחצים על הלחצן Create. זה ייקח כמה רגעים, כי מתבצעת פריסה של הפונקציה ללא שרת (serverless).

הפעלה של מילוי הזמנות ב-Dialogflow

1. חזרה ל-Dialogflow
2. לוחצים על מילוי הזמנה בתפריט הראשי.
3. מפעילים את המתג webhook.
4. מזינים את כתובת ה-URL של הפונקציה ב-Cloud Functions שהועתקה ללוח.

לדוגמה: https://us-central1-leeboonstra-wiv-uhtefa.cloudfunctions.net/dialogflow

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

6. נבדוק את ה-webhook כדי לראות אם הקוד פועל ונבדוק את הזרימה ישירות בסימולטור של Dialogflow.

7. Actions on Google

Actions on Google היא פלטפורמת פיתוח ל-Google Assistant. הוא מאפשר פיתוח של 'פעולות' על ידי צד שלישי – יישומונים ל-Google Assistant שמספקים פונקציונליות מורחבת.

כדי להפעיל פעולה ב-Google, צריך לבקש מ-Google לפתוח אפליקציה או לדבר איתה.

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

בדיקת הפעולה בסימולטור של Google Assistant

נבדוק את השיחה הבאה:

משתמש	Google Assistant
"Ok Google, talk to my test app"	"קבלת גרסת הבדיקה של האפליקציה שלי".
משתמש	השם שלך-WIV
-	"היי, אני אנה, הנציגה הווירטואלית של נשים ב-Voice. את יכולה לבקש ממני מידע על מפגשים, נשים ב-Voice או טיפ לקריאה. מה היית רוצה לדעת?"
אפשר לתת לי טיפ לבלוג?	"רוצה לקרוא עוד על צ'אט בוטים, קול או שניהם?"
צ'אט בוטים	"מעולה, הנה הטיפ היומי! המאמר צ'אט בוטים והאתגר של עלויות בלתי נראות של קובוס באפור.רוצה טיפ נוסף על ספר או מאמר? אוכל גם לתת לך מידע נוסף על מפגשים או על מה שאנחנו עושים. איך אפשר לעזור?"
מתי המפגש הבא?	"המפגש הבא יהיה ב-29 באפריל בשעה 18:00 ב-Hangouts וירטואלי. הנושא יהיה 'סדנה אונליין: יצירת פעולות של Google עם Dialogflow!'. אפשר להירשם דרך הניוזלטר שלנו.יש עוד משהו שאוכל לעזור לך איתו?"
מהי כתובת האתר שלך?	"אתם יכולים למצוא אותנו בכתובת www.Winvoice.com. אשמח לעזור לך בכל שאלה או בעיה אחרת.
לא, זה הכול, תודה	"מצוין. אני מקווה שנתראה באחד מהמפגשים שלנו!"

1. חוזרים לסימולטור של Google Assistant

פותחים את: https://console.actions.google.com

מסוף Google Assistant

2. לוחצים על סמל המיקרופון ושואלים את השאלות הבאות:

• Talk to my test app.

3. עכשיו נשאל:

• Can I have a tip for a blog?

הפלט אמור להחזיר:

"רוצה לקרוא עוד על צ'אט בוטים, קול או שניהם?"

• Chatbots

"מעולה, הנה הטיפ היומי! המאמר צ'אט בוטים והאתגר של עלויות בלתי נראות של קובוס באפור.

רוצה טיפ נוסף על ספר או מאמר? אוכל גם לתת לך מידע נוסף על מפגשים או על מה שאנחנו עושים. איך אפשר לעזור?"

4. ננסה גרסה אחרת של אותה שאלה:

• "Yes, I want to read more about Voice"

"מעולה, הנה הטיפ היומי! העיצוב של ממשקי משתמש עם קול: עקרונות של תכונות שיחה. ... של Cathy Pearl.

רוצה טיפ נוסף על ספר או מאמר? אוכל גם לתת לך מידע נוסף על מפגשים או על מה שאנחנו עושים. איך אפשר לעזור?"

שימו לב שאף פעם לא השתמשתם בביטוי האימון הזה ב-Dialogflow. היא בדיוק תאמה לכוונה הנכונה.

שימו לב גם שלא קיבלתם שאלת המשך כי סיפקתם מספיק מידע כדי לאפשר ל-Dialogflow להמשיך.

5. ממשיכים ב-Dialogflow עם הביטויים הבאים:

• What's the URL for your website
• Bye

שגיאות? כדאי לבדוק את היומנים!

בכל פעם שמשתמשים ב-console.log() בקוד הפונקציה של Cloud Functions, נתונים נכתבים ביומני GCP (Stackdriver). כדי לגשת ליומנים האלה, פותחים את מסוף Cloud > רישום ביומן.

בתפריט הנפתח הראשון, בוחרים באפשרות Cloud Functions > בתיבת הדו-שיח הזו לסינון היומנים.

8. מזל טוב

יצרת את הפעולה הראשונה שלך ב-Google Assistant ב-Dialogflow. כל הכבוד!

כפי שאולי הבחנת, הפעולה שלך פעלה במצב בדיקה, המקושר לחשבון Google שלך. אם תתחברו למכשיר Nest או לאפליקציית Google Assistant בטלפון iOS או Android, באמצעות אותו החשבון. גם לך יש אפשרות לבדוק את הפעולה שביצעת.

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

אילו נושאים דיברנו?

• איך יוצרים צ'אט בוט באמצעות Dialogflow v2
• איך יוצרים ישויות בהתאמה אישית באמצעות Dialogflow
• איך יוצרים שיחה לינארית באמצעות Dialogflow
• איך מגדירים מילוי הזמנות ב-webhook באמצעות Dialogflow ו-Google Cloud Functions
• איך מעבירים את האפליקציה אל Google Assistant באמצעות Actions on Google

מה השלב הבא?

נהנית משיעור ה-Lab הזה של כתיבת קוד? בואו לראות את שיעורי ה-Lab המעולים האלה!

• איך יוצרים פעולה ממדריך הטלוויזיה באמצעות Dialogflow ו-Actions on Google
• יצירת פעולות ל-Google Assistant באמצעות Dialogflow (רמה 1)
• יצירת פעולות ל-Google Assistant באמצעות Dialogflow (רמה 2)
• יצירת פעולות ל-Google Assistant באמצעות Dialogflow (רמה 3)
• הסבר על מילוי ההזמנות באמצעות שילוב של Dialogflow עם יומן Google
• שילוב Google Cloud Vision API עם Dialogflow