Google köməkçisi üçün xüsusi hərəkətlər yaradın: 12 addım

2024 Müəllif: John Day | [email protected]. Son dəyişdirildi: 2024-01-30 07:45

Google I/O 18 -də və Volvo Cars -da olduğu kimi məlumat -əyləncə sistemində təqdim edildiyi kimi Google köməkçisinin potensialını görüb sınamaqda dözə bilmədim. Köhnə layihələrimdən biri olan VasttraPi -ni yenidən istifadə etdim və Google Assistant ilə əlaqələndirdim. Layihə haqqında daha çox oxumaq istəyirsinizsə, blogumdakı əlaqədar məqaləyə baxsanız sevinərəm: Google köməkçisi üçün xüsusi hərəkətlər.

Bu Təlimat kitabında, serverinizlə ünsiyyət quracaq və gələcək gedişləri sadalayaraq sizinlə danışacaq öz Google Assistant Fəaliyyətinizi başlatmaq üçün lazım olan addımları atacağıq. Unutmayın ki, SDK -dan istifadə etməyəcəyik, çünki bunu öz cihazımızda deyil, tamamilə Google köməkçisində edirik. Ümumiyyətlə, sadə saxlanılacaq. Hərəkətiniz telefon, planşet, ev köməkçisi və geyilə bilən cihaz kimi Google köməkçisini dəstəkləyən cihazlarda istifadə edilə bilər və hətta Play Store -da tətbiq etdiyiniz kimi paylaşa bilərsiniz!

IFTTT kimi xidmətlərdən istifadə etməklə belə bir şey yaratmağın əsas üstünlüklərindən biri, serverinizdə Google köməkçisi tərəfindən oxunacaq xüsusi cavablar yarada biləcəyinizdir. IFTTT-də ünsiyyət mənim bildiyim qədər bir tərəflidir.

Aşağıdakı mövzular əhatə olunacaq:

• İlk Fəaliyyət Layihənizi yaradın
• Xüsusi niyyətinizi yaratmaq
• Fərdi varlığınızı yaratmaq
• Hərəkətinizi yerinə yetirmək üçün bir webhook qurmaq
• Cavabları və ya "yerinə yetirilməsini" təmin edəcək Flask ilə Python -da yazılmış sadə bir REST server qurmaq.
• Fəaliyyət layihənizi sınayın
• Fəaliyyət layihənizi buraxın

Burada müxtəlif Google Assistant funksiyaları və anlayışları haqqında bir çox detal və ya nəzəriyyə tapa bilməyəcəksiniz. Əgər onlarla maraqlanırsınızsa, rəsmi təlimatı izləməyinizi və ya bu videoya baxmanızı şiddətlə təklif edirəm.

Addım 1: Google Hesabınızın İcazələrini təyin edin

Başlamazdan əvvəl Google Assistentin müvafiq icazələrə malik olmasını təmin etməliyik.

1. Fəaliyyət Nəzarətinə keçin

2. Aşağıdakıların aktiv olduğundan əmin olun:

   1. Veb və Tətbiq Fəaliyyəti
   2. Cihaz Məlumatı
   3. Səs və Audio Fəaliyyəti

Addım 2: Fəaliyyətinizi yaradın

1. Actions Console'a gedin və "Layihə əlavə et/idxal et" düyməsini basın.
2. Bu Actions layihəsinə "local-traffic-planner" deyək.
3. "Layihə yarat" düyməsini basın.
4. Növbəti səhifədə bir kateqoriya seçməyin və "Atla" düyməsini basın.
5. İndi əsas Actions Console səhifəsində olmalısınız.

Addım 3: Fəaliyyət çağırışı

Hərəkətə başlamaq üçün Google köməkçisini necə işə salmaq istədiyinizi müəyyənləşdirin.

1. "Sürətli quraşdırma" altında "Hərəkətinizin necə çağırılacağına qərar verin" düyməsini basın.
2. "Yerli trafik planlayıcım" adlandırın və "Saxla" düyməsini basın.

3. "Saxla" düyməsini basdıqdan sonra açılan "NÜMUNƏ ÇAĞIRMALARI YENİLƏYİN" əmrini vurun.

   Bu seçimi "Directory Information" bölməsində də tapa bilərsiniz

4. Yeni bir çağırış olaraq "Yerli trafik planlayıcımdan soruş" əlavə edin və "Saxla" düyməsini basın.

Addım 4: İlk Hərəkətinizi əlavə edin

1. Sol tərəfdəki "Əməliyyatlar" düyməsini basın.
2. "İLK HƏRƏKƏTİNİZƏ ƏLAVƏ EDİN" düyməsini basın.
3. "Xüsusi məqsəd" seçin və sonra "Qur" düyməsini basın.
4. Əsas məntiqi tətbiq edəcəyiniz Dialogflow səhifəsinə aparılacaqsınız.

Addım 5: Niyyətiniz üçün ifadələr öyrədin

1. Saat qurşağınızı seçin və "Yarat" düyməsini basın.
2. Növbəti səhifədə, mövcud niyyətləri buraxın və "NİYƏT OL" düyməsini basın.
3. Niyyətə ağlabatan bir ad verin, yəni "gedişlər".
4. "Təlim ifadələri" nə gedin və "Təlim ifadələri əlavə et" düyməsini basın.

5. Modelinizi öyrətmək üçün dediklərinizi şərh edə bilməsi üçün aşağıdakı ifadələrdən istifadə edin:

   1. Mən indi evdəyəm
   2. Hələlik evdəyəm
   3. Hal -hazırda mənzilimizdəyəm
   4. Mən evdə otururam
   5. Hazırda işə yaxınam
   6. Mən işdəyəm
   7. Mən ofisdəyəm
   8. İş
   9. Ev

Addım 6: Varlıqlar

İndi bir giriş olaraq nə az -çox gözlənilməli olduğunu təyin etdiniz, girişin hansı hissələrinin iş məntiqimiz üçün maraqlı olduğunu müəyyənləşdirməliyik ki, bunlar serverimizə çıxarılsın və işıqlandırılsın. Bizim vəziyyətimizdə, istifadəçinin evdə və ya işdə olduğunu bilmək istəyirik, buna görə də müəyyən stansiyadan gedişlərlə cavab verə bilərik. Bunu necə edə biləcəyimizi görək.

1. Təlim ifadələrinin bir və ya daha çox sözünə iki dəfə tıklasanız, əvvəlcədən təyin edilmiş varlıqların siyahısını alacaqsınız. Hər biri haqqında daha çox məlumatı burada oxuya bilərsiniz. Ümumiyyətlə, ən uyğun olan @sys.location olardı, amma düşünürəm ki, @current-location adlandırmalı olduğumuz öz varlığımızı yaratmağın ən yaxşı və ən asan yolu.
2. Sol tərəfdəki "Varlıqlar" seçimini vurun.
3. "ENTITY YARAT" düyməsini basın.

4. Adı "cari yer" olaraq təyin edin və sinonimləri ilə birlikdə iki istinad dəyərini təyin edin:

   1. ev

      ev, ev, mənzil, beşik

   2. iş

      iş, ofis, Aptiv, kod minaları (lol sadəcə zarafat edir)

5. "Saxla. Əlavə effekt əldə etmək üçün" Avtomatik genişləndirməyə icazə ver "düyməsini vuraraq Google Assistentə istinad dəyərlərinizlə daha çox sinonimi sınamaq və əlavə azadlıqlar verə bilərsiniz.

Addım 7: Fəaliyyət və Parametrlər

Təlim ifadələrinizdəki açar sözlərə bir məna vermək vaxtıdır.

1. "Niyyətlər" düyməsini basın və sonra ad təkliflərimə əməl edirsinizsə, xüsusi niyyətinizə, yəni "gedişlər" ə gedin.
2. Aşağı gedin "Təlim ifadələri".
3. Mövcud yerinizi göstərən sözləri iki dəfə vurun və açılan pəncərədən @current-location etiketini seçin.
4. "Fəaliyyətlər və parametrlər" bölməsinə gedin, "idarə et" düyməsini basın.
5. Hər şey düzgün edildisə, yeni varlığınızın orada siyahıya alındığını görəcəksiniz.
6. Yeni bir sütunun göründüyü "İstər" qutusunu yoxlayın. İstəklər, gözləntiyə uyğun heç bir şey təmin edilmədikdə istifadəçinin eşidəcəyi şeydir.
7. "İstiqamətləri təyin et" düyməsini basın və "Yerinizi başa düşmədim. Hazırda haradasınız?" Kimi bir şey daxil edin.

Addım 8: İcra

İndi veb xidmətinizi Google Assistant Fəaliyyətinə bağlamağın vaxtıdır. Bu xüsusi niyyət işə salındıqda çəngəl çağırılacaq və bu hərəkətin yerinə yetirilməsinə səbəb olmalıdır. Bundan əvvəl, biz də niyyətimizi yerinə yetirdikdən sonra başa çatdırmaq istəyirik.

1. "Cavablar" a gedin və "Cavab əlavə et" düyməsini basın.
2. Heç bir cavab əlavə etməyin, sadəcə "Bu niyyəti söhbətin sonu olaraq təyin et" i aktiv edin.
3. "Fulfillment" ə gedin, "İCRA EDİN" düyməsini basın və sonra "Bu məqsəd üçün webhook zəngini aktiv et" yandırın.
4. "Saxla" düyməsini basın və sol tərəfdəki "İcra" seçiminə keçin.

5. "Webhook" seçimini aktiv edin və veb serveriniz tərəfindən "dinlənilən" URL daxil edin.

   Niyyət tetiklendiğinde, istifadəçinin cari yeri olan bir JSON obyekti olan sorğunun gövdəsi ilə veb saytınıza bir POST sorğusu göndərəcək

6. Saxla vurun.
7. İndi veb xidmətimizi yaratmağa hazırıq, amma bundan əvvəl, Əməliyyatımızın bizi düzgün bir şəkildə qarşıladığından əmin olaq.

Addım 9: Xoş Niyyət

İstifadəçi təcrübəsini fərdiləşdirmək üçün, hərəkətimizi tetiklediğimiz zaman bizim üçün uyğun bir salamlama yaratmalıyıq.

1. "Niyyətlər" ə gedin və sonra "Varsayılan Xoş Niyyət" düyməsini basın.
2. "Cavablar" a gedin, mövcud olanları silin və başladığınız anda sizi necə qarşılamaq istədiyinizi daxil edin.
3. "Saxla" düyməsini basın.

Addım 10: Python Veb Xidmətiniz

Flask istifadə edərək sürətli və çirkli bir Python serveri edək. Bu addım üçün ekran görüntüsü yoxdur, amma olduqca düz irəli olmalıdır.

1. Yeni bir nişan açın və pythonanywhere.com saytında bir hesab yaradın
2. E -poçtunuzu doğrulayın.
3. "Veb sekmesini açın" düyməsini basaraq veb tətbiqinizi qurun.
4. "Yeni bir veb tətbiqi əlavə et" düyməsini basın və Python veb çərçivəniz olaraq "Flask" ı seçin.
5. Python 3.6 seçin və "İrəli" düyməsini basın.
6. "Flask_app.py" -nizin yerləşməsini istədiyiniz yolu seçin. Mən onu birbaşa ev qovluğumun içərisində "/home/your-username/flask_app.py" olaraq yerləşdirdim.
7. Sol üst küncdəki Python loqotipini tıklayaraq ana səhifəyə qayıdın.
8. Faylların altında, redaktə etməyə başlamaq üçün "flask_app.py" düyməsini basın.
9. Veb mətn redaktoru açıldıqda, aşağıdakı kodu yapışdırın və "Saxla" düyməsini basın. Ümumi fikir, Google köməkçisindən gələn təhlil edilmiş JSON -dan asılı olaraq serverimizin bir hərəkət (məsələn, oxumaq və ya yazmaq) yerinə yetirəcəyini və cavab olaraq geri bildirməsidir. /istifadəçiyə oxunmalı olan yerinə yetirilmə.
10. Yenidən "Veb sekmesini açın" və sonra yaşıl "Yenidən yüklə" düyməsini basın.
11. İndiyə qədər "https://your-username.pythonanywhere.com/departures" saytında işləyən öz Python veb serverinizə sahib olmalısınız.

Addım 11: Hərəkətinizi sınayın

Tamam, indiyə qədər çox iş görmüsünüz. İndi bütün yığınları sınayaq və bu "Hello world" nümunəsini işlək vəziyyətə gətirək!

1. Sol tərəfdəki çubuqdan "İnteqrasiya" düyməsini basın.
2. Google köməkçisi altında "İnteqrasiya Ayarları" na basın.
3. "Gizli çağırış" niyyətinizin adını, yəni "gedişləri" əlavə edin, buna görə "Hey Google, evdən gedişlər haqqında yerli trafik planlayıcımla danış" kimi bir şey söyləməklə birbaşa işə salına bilər.
4. "Avtomatik önizləmə" dəyişikliklərini aktiv edin.
5. Yeni bir səhifə açacaq "Test" düyməsini basın.
6. "Yerli trafik planlayıcımla danış" yazın.
7. Hərəkətiniz əvvəlcədən təyin edilmiş xoş niyyət cavablarından biri ilə sizi salamlamalıdır.
8. Sonra "İş yerindəyəm" yazın. Python serverinizlə əlaqə saxlanılmalıdır və cavab Google köməkçisi tərəfindən oxunacaq.

Sərin, elə deyilmi? İndi Google köməkçiniz vasitəsilə sensorlar, aktuatorlar və digər API -lərlə qarşılıqlı əlaqədə nə edə biləcəyinizi düşünün.

Addım 12: Hərəkətinizi buraxın

Fəaliyyətinizi sınamağı bitirdikdən və yaxşı vəziyyətdə olduğunuzdan sonra sevginizi dünya ilə bölüşməyin və ya mənası yoxdursa, dostlarınız və ailənizlə paylaşmağın vaxtı gəldi.

1. Actions konsolunuza qayıdın və yerli trafik planlayıcınızın hərəkətini seçin.
2. "Yerləşdirməyə hazır olun" altında "Hərəkətlərinizi qovluğa daxil etmək üçün lazım olan məlumatları daxil edin" düyməsini basın.
3. Qısa bir təsviri, daha uzun təsviri, kiçik bir loqotipi, əlaqə məlumatlarınızı, məxfilik siyasəti bağlantısını (bunu açıq şəkildə paylaşmayacaqsınızsa, sadəcə veb saytınıza və ya bir şeyə bir keçid qoyun) və bir kateqoriya daxil edin.
4. Yuxarı sürüşdürün və "Saxla" düyməsini basın.
5. Sol tərəfdəki çubuqdakı "Burax" seçimini vurun.
6. Burada Hərəkətinizin hansı vəziyyətdə olduğunu seçə bilərsiniz. "Yerli trafik planlayıcımın test versiyasını əldə edək" cavabını eşitmək istəmirsinizsə, tam hüquqlu bir ictimai buraxılış etməlisiniz. Ancaq bunun Google tərəfindən nəzərdən keçirilməsini tələb edir və bu dərslikdə yer almayacaq. Bunun əvəzinə, hələ də bir Alfa buraxılışını seçərək Alfa sınaqçıları olaraq əlavə edərək 20 nəfərə qədər paylaşa bilərsiniz.
7. Onlara bir link göndərməklə və ya e -poçtlarını əlavə etməklə hər hansı bir alfa test cihazı əlavə edin.
8. "ALPHA İÇİN SUBMIT" düyməsini basın, qutuları işarələyin, "SUBMIT" düyməsini basın və işiniz bitdi!

İndi Fəaliyyətiniz canlıdır və siz və dostlarınız tərəfindən əldə edilə bilər. Əylənin!

İstifadə etdiyim kodla maraqlanırsınızsa, GitHubdakı layihəyə baxın.