צור פעולות מותאמות אישית עבור Google Assistant: 12 שלבים

2024 מְחַבֵּר: John Day | [email protected]. שונה לאחרונה: 2024-01-30 09:14

כשראיתי את הפוטנציאל של Google Assistant כפי שהוא הוצג ב- Google I/O 18 וכן וולוו מכוניות במערכת המידע והבידור שלהם, לא יכולתי להתאפק מלנסות זאת. השתמשתי מחדש באחד הפרויקטים הישנים שלי, VasttraPi והמשקתי אותו עם Google Assistant. אם אתה רוצה לקרוא עוד על הפרויקט, אשמח אם תציץ במאמר הקשור בבלוג שלי: פעולות מותאמות אישית עבור Google Assistant.

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

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

הנושאים הבאים ידונו:

• יצירת פרויקט הפעולה הראשון שלך
• יצירת הכוונה המותאמת אישית שלך
• יצירת היישות המותאמת אישית שלך
• הגדרת webhook לממש את הפעולה שלך
• הקמת שרת REST פשוט, שנכתב ב- Python with Flask, שיספק את התשובות או "הגשמה"
• בודק את פרויקט הפעולה שלך
• שחרור פרויקט הפעולה שלך

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

שלב 1: הגדר את הרשאות חשבון Google שלך

לפני שנתחיל עלינו לוודא של- Google Assistant יש את ההרשאות המתאימות.

1. עבור אל פקדי פעילות

2. ודא שהדברים הבאים מופעלים:

   1. פעילות אינטרנט ואפליקציות
   2. מידע על המכשיר
   3. פעילות קול ואודיו

שלב 2: צור את הפעולה שלך

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

שלב 3: הזמנת פעולה

קבע כיצד ברצונך להפעיל את Google Assistant להתחיל בפעולה שלך.

1. לחץ על "להחליט כיצד הפעולה שלך מופעלת" תחת "הגדרה מהירה".
2. קראו לזה "מתכנן התנועה המקומי שלי" ולחצו על "שמור".

3. לחץ על הפקודה "עדכן דגימות דגימה" שהופיעה לאחר לחיצה על שמור.

   תוכל למצוא את האפשרות הזו גם תחת "מידע מדריך"

4. הוסף את "שאל את מתכנן התנועה המקומי שלי" כקריאה חדשה ולחץ על "שמור".

שלב 4: הוסף את הפעולה הראשונה שלך

1. לחץ על "פעולות" בסרגל הימני.
2. לחץ על "הוסף את הפעולה הראשונה שלך".
3. בחר "כוונה מותאמת אישית" ולאחר מכן לחץ על "Build".
4. תועבר לדף Dialogflow ושם תיישם את ההיגיון הראשי.

שלב 5: אימון ביטויים לכוונתך

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

5. השתמש במשפטים הבאים כדי לאמן את המודל שלך כדי שיוכל לפרש את מה שאתה אומר לו:

   1. אני כרגע בבית
   2. בינתיים אני בבית
   3. אני כרגע בדירה שלנו
   4. אני יושב בבית
   5. כרגע אני קרוב לעבודה
   6. אני בעבודה
   7. אני במשרד
   8. עֲבוֹדָה
   9. בית

שלב 6: ישויות

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

1. אם תלחץ לחיצה כפולה על מילה אחת או יותר של ביטויי האימון, תקבל רשימה של ישויות מוגדרות מראש. תוכל לקרוא עוד על כל אחת מהן כאן. בסך הכל, המתאים ביותר יהיה @sys.location אולם אני חושב שהכי טוב והכי קל אם ניצור ישות משלנו שאליה עלינו לקרוא @ @מיקום הנוכחי.
2. לחץ על האפשרות "ישויות" בצד שמאל.
3. לחץ על "יצירת ישות".

4. הגדר את השם ל"מיקום הנוכחי "והגדר שני ערכי התייחסות יחד עם המילים הנרדפות שלהם:

   1. בית

      בית, בית, דירה, עריסה

   2. עֲבוֹדָה

      עבודה, משרד, אפטיב, מכרות קוד (חחח סתם צוחק)

5. לחץ על "שמור. לקבלת השפעה נוספת תוכל גם ללחוץ על" אפשר הרחבה אוטומטית "כדי לתת ל- Google Assistant חירויות נוספות לנסות ולהתאים מילים נרדפות נוספות לערכי ההתייחסות שלך.

שלב 7: פעולה ופרמטרים

הגיע הזמן לתת קצת משמעות למילות המפתח שבתוך ביטויי האימון שלך.

1. לחץ על "כוונות" ולאחר מכן נווט אל הכוונה המותאמת אישית שלך, כלומר "יציאות" אם עקבת אחר הצעות שמי.
2. גלול מטה אל "ביטויי אימון".
3. לחץ פעמיים על המילים המצביעות על מיקומך הנוכחי ובחר את תג @מיקום הנוכחי מהחלון המוקפץ.
4. גלול מטה אל "פעולות ופרמטרים", לחץ על "נהל"
5. אם הכל בוצע כהלכה, תראה שם את הישות החדשה שלך.
6. סמן את התיבה "חובה", המציגה עמודה חדשה, "הנחיות". הנחיות הן מה שהמשתמש ישמע אם לא נמסר דבר התואם את הציפייה.
7. לחץ על "הגדר הנחיות" והכנס משהו כמו "לא הבנתי את המיקום שלך. איפה אתה כרגע?".

שלב 8: הגשמה

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

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

5. הפעל את האפשרות "Webhook" והוסף את כתובת האתר ש"האזנה "של שרת האינטרנט שלך.

   בכל פעם שהכוונה מופעלת, היא תשלח בקשת POST לאתר שלך עם גוף הבקשה המכיל אובייקט JSON עם המיקום הנוכחי של המשתמש

6. לחץ על שמור.
7. כעת אנו מוכנים ליצור את שירות האינטרנט שלנו, אך לפני כן, בואו נוודא שהפעולה שלנו מברכת אותנו בצורה נכונה.

שלב 9: כוונת ברוכים הבאים

על מנת להתאים אישית את חווית המשתמש, עלינו ליצור לנו ברכה מתאימה בכל פעם שאנו מפעילים את הפעולה שלנו.

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

שלב 10: שירות האינטרנט של Python

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

1. פתח כרטיסייה חדשה וצור חשבון ב- pythonanywhere.com
2. אמת את הדוא"ל שלך.
3. הגדר את יישום האינטרנט שלך על ידי לחיצה על "פתח כרטיסיית אינטרנט".
4. לחץ על "הוסף יישום אינטרנט חדש" ובחר "בקבוק" כמסגרת האינטרנט שלך ב- Python.
5. בחר Python 3.6 ולחץ על "הבא".
6. בחר את הנתיב שברצונך ש- "flask_app.py" שלך יגור בו. הנחתי אותו ישירות בתוך תיקיית הבית שלי בשם "/home/your-username/flask_app.py".
7. חזור לדף הראשי על ידי לחיצה על הלוגו של פייתון בפינה השמאלית העליונה.
8. תחת קבצים, לחץ על "flask_app.py" כדי להתחיל לערוך אותו.
9. כאשר עורך הטקסט באינטרנט נפתח, הדבק את הקוד הבא ולחץ על "שמור". הרעיון הכולל הוא כי בהתאם ל- JSON המנותח המגיע מ- Google Asssistant השרת שלנו יבצע פעולה (למשל לקרוא או לכתוב) ולדווח עליה בתגובה /הגשמה שיש לקרוא למשתמש.
10. לחץ שוב על "פתח כרטיסיית אינטרנט" ולאחר מכן על הלחצן "טען מחדש" הירוק.
11. בשלב זה אתה אמור להפעיל שרת אינטרנט משלך ב- Python בכתובת "https://your-username.pythonanywhere.com/departures".

שלב 11: בדוק את הפעולה שלך

בסדר, די סיימת עד עכשיו. בואו נבדוק את כל הערימה עכשיו ונדאג שהדוגמא הזו של "שלום העולם" תעבוד!

1. לחץ על "אינטגרציות" מהסרגל הימני.
2. לחץ על "הגדרות אינטגרציה" תחת האפשרות Google Assistant.
3. תחת "קריאה משתמעת הוסף את שם הכוונה שלך, כלומר" יציאות ", כך שניתן יהיה להפעיל אותה ישירות על ידי אמירת משהו כמו" היי גוגל, דבר עם מתכנן התנועה המקומי שלי על יציאות מהבית ".
4. אפשר שינויים בתצוגה מקדימה אוטומטית.
5. לחץ על "מבחן" שיפתח דף חדש.
6. הקלד "דבר עם מתכנן התנועה המקומי שלי".
7. יש להפעיל את הפעולה שלך שאמורה לברך אותך באחת מתגובות הכוונה המבורכות שהוגדרו בעבר.
8. לאחר מכן הקלד "אני בעבודה". יש לפנות לשרת ה- Python שלך והתגובה תקרא על ידי Google Assistant.

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

שלב 12: שחרר את הפעולה שלך

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

1. חזור למסוף הפעולות ובחר בפעולת מתכנני התנועה המקומית שלך.
2. תחת "התכונן לפריסה" לחץ על "הזן מידע הדרוש לרישום הפעולה שלך בספריית הפעולות".
3. הזן תיאור קצר, תיאור ארוך יותר, לוגו קטן, פרטי ההתקשרות שלך, קישור למדיניות פרטיות (אם אתה לא מתכוון לשתף את זה בפומבי פשוט ציין קישור לאתר שלך או משהו כזה) וקטגוריה.
4. גלול למעלה ולחץ על "שמור".
5. לחץ על האפשרות "שחרור" מהסרגל הימני.
6. כאן תוכל לבחור באיזה מצב הפעולה שלך נמצאת. אם אינך רוצה לשמוע את התגובה "בואו לקבל את גרסת הבדיקה של מתכנן התנועה המקומי שלי", עליך לפרסם ציבורי מלא. עם זאת זה דורש סקירה של Google ולא יכוסה במדריך זה. במקום זאת, אתה עדיין יכול לשתף את זה עם עד 20 אנשים על ידי בחירת מהדורה של Alpha והוספתם כבודקי אלפא.
7. הוסף כל בודקי אלפא על ידי שליחת קישור או הוספת מיילים שלהם.
8. לחץ על "שלח לאלפא", סמן את התיבות, לחץ על "שלח" וסיימת!

כעת הפעולה שלך פעילה וניתן להגיש אותך וחבריך. תעשה חיים!

אם אתה מתעניין בקוד שהשתמשתי בו, תסתכל על הפרויקט ב- GitHub.