Krijoni veprime të personalizuara për Google Assistant: 12 hapa

2024 Autor: John Day | [email protected]. E modifikuara e fundit: 2024-01-30 12:17

Duke parë potencialin e Google Assistant siç u prezantua në Google I/O 18 si dhe Volvo Cars në sistemin e tyre të infotainment, nuk mund të rezistoja ta provoja. Ripërdor një nga projektet e mia më të vjetra, VasttraPi dhe e ndërhyra me Google Assistant. Nëse doni të lexoni më shumë rreth projektit, do të isha i kënaqur nëse i hidhni një sy artikullit të lidhur në blogun tim: Veprimet e personalizuara për Google Assistant.

Në këtë Instructable ne po kalojmë hapat e nevojshëm për të nisur Veprimin tuaj të Asistentit Google i cili do të komunikojë me serverin tuaj dhe do t'ju flasë përsëri, duke renditur nisjet e ardhshme. Mbani në mend se ne nuk do të përdorim SDK pasi ne po e ekzekutojmë këtë plotësisht brenda Google Assistant dhe jo pajisjes sonë. Në përgjithësi, do të mbahet e thjeshtë. Veprimi juaj do të jetë i përdorshëm në pajisjet që mbështesin "Asistentin e Google", siç janë telefonat, tabletët, asistentët në shtëpi dhe pajisjet e veshshme dhe madje mund ta ndani siç do të bënit me një aplikacion në Dyqanin Play!

Një nga avantazhet kryesore të krijimit të diçkaje të tillë mbi përdorimin e shërbimeve të tilla si IFTTT është se ju mund të krijoni përgjigje të personalizuara në serverin tuaj të cilat do të lexohen nga Google Assistant. Në IFTTT komunikimi është për sa më përket mua është i njëanshëm.

Temat e mëposhtme do të mbulohen:

• Krijimi i projektit tuaj të parë të Veprimit
• Krijimi i qëllimit tuaj të personalizuar
• Krijimi i entitetit tuaj të personalizuar
• Vendosja e një webhook për të përmbushur veprimin tuaj
• Krijimi i një serveri të thjeshtë REST, të shkruar në Python me Flask, i cili do të japë përgjigjet ose "përmbushjen"
• Testimi i projektit tuaj të Veprimit
• Lëshimi i projektit tuaj të Veprimit

Këtu nuk do të gjeni shumë detaje ose teori në lidhje me funksionet dhe konceptet e ndryshme të Asistentit të Google. Nëse jeni të interesuar për to, ju sugjeroj fuqimisht të ndiqni mësimin zyrtar ose të shikoni këtë video.

Hapi 1: Vendosni Lejet e Llogarisë suaj të Google

Para se të fillojmë, duhet të sigurohemi që Google Assistant ka lejet e duhura.

1. Shkoni te Kontrollet e Aktivitetit

2. Sigurohuni që të mëposhtmet janë të aktivizuara:

   1. Aktiviteti i uebit dhe i aplikacioneve
   2. Informacioni i pajisjes
   3. Veprimtaria zanore dhe zanore

Hapi 2: Krijoni veprimin tuaj

1. Shkoni te Actions Console dhe klikoni në "Shto/importo projekt"
2. Le ta quajmë këtë projekt të Veprimeve "planifikues të trafikut lokal".
3. Klikoni në "Krijo projekt".
4. Në faqen tjetër, mos zgjidhni një kategori dhe klikoni në "Kalo".
5. Tani duhet të jeni në faqen kryesore të Aksionit të tastierës.

Hapi 3: Thirrja në veprim

Përcaktoni se si doni të aktivizoni Google Assistant për të filluar veprimin tuaj.

1. Klikoni në "Vendosni se si thirret Veprimi juaj" nën "Konfigurimi i shpejtë".
2. Thirrni atë "Planifikuesi im i trafikut lokal" dhe klikoni në "Ruaj".

3. Klikoni në kërkesën "PPRDITSIMI I INVOKACIONEVE TAM SAMBLE" që u shfaq pasi klikuat ruaj.

   Ju gjithashtu mund ta gjeni këtë opsion nën "Informacioni i Drejtorisë"

4. Shtoni "Pyetni planifikuesin tim të trafikut lokal" si një thirrje e re dhe klikoni në "Ruaj".

Hapi 4: Shtoni veprimin tuaj të parë

1. Klikoni në "Veprimet" në shiritin e majtë.
2. Klikoni në "SHTO VEPRIMIN TUAJ TIR PARST".
3. Zgjidhni "Qëllimi i personalizuar" dhe pastaj klikoni në "Ndërto".
4. Do të çoheni në faqen Dialogflow e cila është vendi ku do të zbatoni logjikën kryesore.

Hapi 5: Trajnimi i frazave për qëllimin tuaj

1. Zgjidhni zonën tuaj kohore dhe klikoni "Krijo".
2. Në faqen tjetër, lini qëllimet ekzistuese të jenë dhe klikoni në "CREATE INTENT".
3. Jepini qëllimit një emër të arsyeshëm, domethënë "largime".
4. Shkoni te "Fraza trajnimi" dhe klikoni në "Shto fraza trajnimi".

5. Përdorni frazat e mëposhtme për të stërvitur modelin tuaj në mënyrë që të interpretojë atë që po i thoni:

   1. Unë jam në shtëpi tani
   2. Për momentin jam në shtëpi
   3. Unë jam në banesën tonë për momentin
   4. Unë jam ulur në shtëpi
   5. Aktualisht jam pranë punës
   6. Unë jam në punë
   7. Jam ne zyre
   8. Puna
   9. Në shtëpi

Hapi 6: Subjektet

Tani ju keni specifikuar atë që duhet të pritet pak a shumë si një hyrje, ne duhet të përcaktojmë se cilat pjesë të të dhënave janë me interes për logjikën e biznesit tonë në mënyrë që ato të mund të nxirren dhe të theksohen në serverin tonë. Në rastin tonë, ne duam të dimë nëse përdoruesi është në shtëpi apo në punë, kështu që ne mund të përgjigjemi përsëri me largimet nga stacioni specifik. Le të shohim se si mund ta bëjmë atë.

1. Nëse klikoni dy herë mbi një ose më shumë fjalë të frazave të trajnimit, do të merrni një listë të entiteteve të paracaktuara. Mund të lexoni më shumë për secilën prej tyre këtu. Në përgjithësi, më e përshtatshme do të ishte @sys.location megjithatë mendoj se është më e mira dhe më e lehtë nëse krijojmë entitetin tonë të cilin duhet ta quajmë @current-location.
2. Klikoni në opsionin "Entitetet" në anën e majtë.
3. Klikoni në "CREATE ENTITY".

4. Vendosni emrin në "vendndodhja aktuale" dhe përcaktoni dy vlera referimi së bashku me sinonimet e tyre:

   1. shtepi

      shtëpi, shtëpi, apartament, krevat fëmijësh

   2. punë

      punë, zyrë, Aptiv, miniera kodesh (lol vetëm shaka)

5. Klikoni në "Ruaj. Për efekt shtesë ju gjithashtu mund të klikoni në" Lejo zgjerimin e automatizuar "për t'i dhënë Asistentit Google liri të mëtejshme për të provuar dhe përputhur më shumë sinonime me vlerat tuaja të referencës.

Hapi 7: Veprimi dhe Parametrat

Koha për t'i dhënë kuptim fjalëve kyçe brenda frazave tuaja të trajnimit.

1. Klikoni në "Synimet" dhe më pas lundroni në Qëllimin tuaj të personalizuar, domethënë "largimet" nëse keni ndjekur sugjerimet e emrit tim.
2. Shkoni poshtë te "Fraza trajnimi".
3. Klikoni dy herë mbi fjalët që tregojnë vendndodhjen tuaj aktuale dhe zgjidhni etiketën @current-location nga dritarja që shfaqet.
4. Shkoni poshtë te "Veprimet dhe parametrat", klikoni në "menaxho"
5. Nëse gjithçka është bërë në mënyrë korrekte, do të shihni që entiteti juaj i ri të jetë i listuar atje.
6. Kontrolloni kutinë "Kërkohet" e cila bën të shfaqet një kolonë e re, "Kërkesa". Thirrjet janë ato që përdoruesi do të dëgjojë nëse nuk është furnizuar asgjë që përputhet me pritjet.
7. Klikoni në "Përcaktoni kërkesat" dhe futni diçka si "Nuk e kuptova vendndodhjen tuaj. Ku jeni për momentin?".

Hapi 8: Përmbushja

Tani është koha për të lidhur shërbimin tuaj në internet me Veprimin e Asistentit Google. Goditja juaj do të thirret kur të fillohet ky qëllim specifik dhe duhet të prodhojë përmbushjen e këtij veprimi. Para kësaj, ne gjithashtu duam të vendosim qëllimin tonë për të përfunduar veprimin pasi të jetë përmbushur.

1. Shkoni te "Përgjigjet" dhe klikoni në "SHTO PESRGJIGJE".
2. Mos shtoni asnjë përgjigje, thjesht aktivizoni "Vendoseni këtë qëllim si fund të bisedës".
3. Lëvizni poshtë te "Përmbushja" klikoni në "PUNNASIM PNARFUNDIMIN" dhe më pas aktivizoni "Aktivizo thirrjen në webhook për këtë qëllim".
4. Klikoni "Ruaj" dhe pastaj shkoni te opsioni "Përmbushja" në anën e majtë.

5. Aktivizoni opsionin "Webhook" dhe futni URL -në që po "dëgjohet" nga serveri juaj në internet.

   Sa herë që qëllimi nxitet, ai do të dërgojë një kërkesë POST në faqen tuaj të internetit me trupin e kërkesës që përmban një objekt JSON me vendndodhjen aktuale të përdoruesit

6. Kliko Ruaj.
7. Tani jemi gati të krijojmë shërbimin tonë në internet, por para kësaj, le të sigurohemi që Veprimi ynë të na mirëpresë në mënyrën e duhur.

Hapi 9: Synimi i mirëseardhjes

Për të personalizuar përvojën e përdoruesit, duhet të krijojmë një përshëndetje të përshtatshme për ne sa herë që të fillojmë veprimin tonë.

1. Shkoni te "Synimet" dhe më pas klikoni në "Synimi i parazgjedhur i mirëseardhjes".
2. Shkoni poshtë te "Përgjigjet", hiqni ato ekzistuese dhe futni atë që dëshironi veprimi juaj si t'ju mirëpresë sapo të fillojë.
3. Klikoni "Ruaj".

Hapi 10: Shërbimi juaj në internet Python

Le të bëjmë një server të shpejtë dhe të ndyrë Python duke përdorur Flask. Asnjë screenshot për këtë hap, por duhet të jetë mjaft i drejtë përpara.

1. Hapni një skedë të re dhe krijoni një llogari në pythonanywhere.com
2. Verifikoni emailin tuaj.
3. Konfiguroni aplikacionin tuaj në internet duke klikuar në "Hap skedën e uebit".
4. Klikoni në "Shto një aplikacion të ri në internet" dhe zgjidhni "Flask" si kornizën tuaj të internetit në Python.
5. Zgjidhni Python 3.6 dhe klikoni "Tjetra".
6. Zgjidhni rrugën në të cilën dëshironi të banoni "flask_app.py" juaj. E vendosa direkt brenda dosjes sime në shtëpi si "/home/your-username/flask_app.py".
7. Kthehuni në faqen kryesore duke klikuar në logon Python në këndin e sipërm të majtë.
8. Nën skedarët, klikoni në "flask_app.py" për të filluar redaktimin e tij.
9. Kur hapet redaktuesi i tekstit në internet, ngjisni kodin e mëposhtëm dhe klikoni "Ruaj". Ideja e përgjithshme është që në varësi të JSON -it të analizuar që vjen nga Google Asssistant serveri ynë do të kryejë një veprim (p.sh. lexoni ose shkruani) dhe do ta raportoni atë si përgjigje /përmbushje që duhet t'i lexohet përdoruesit.
10. Klikoni përsëri në "Hapni skedën e uebit" dhe pastaj në butonin e gjelbër "Rifresko butonin".
11. Deri tani ju duhet të keni serverin tuaj Python që funksionon në "https://your-username.pythonanywhere.com/departures".

Hapi 11: Testoni veprimin tuaj

Në rregull, ju keni përfunduar shumë deri tani. Le të provojmë të gjithë pirgun tani dhe të marrim këtë shembull "Përshëndetje botë"!

1. Klikoni në "Integrimet" nga shiriti i majtë.
2. Klikoni në "Cilësimet e Integrimit" nën opsionin Google Assistant.
3. Nën "Thirrja e nënkuptuar shtoni emrin e synimit tuaj, domethënë" largimet ", kështu që mund të nxitet drejtpërdrejt duke thënë diçka si" Hej Google, fol me planifikuesin tim të trafikut lokal për nisjet nga shtëpia ".
4. Aktivizo ndryshimet "Parapamja automatike".
5. Klikoni në "Test" i cili do të hapë një faqe të re.
6. Shkruani "Flisni me planifikuesin tim të trafikut lokal".
7. Veprimi juaj duhet të thirret i cili duhet të jetë duke ju përshëndetur me një nga përgjigjet e mirëpritura të përcaktuara më parë.
8. Pastaj shkruani "Unë jam në punë". Serveri juaj Python duhet të kontaktohet dhe përgjigja do të lexohet nga Google Assistant.

Ftohtë nuk është? Tani imagjinoni se çfarë mund të bëni duke bashkëvepruar me sensorë, aktivizues dhe API të tjerë përmes "Asistentit tuaj të Google".

Hapi 12: Lironi veprimin tuaj

Pasi të keni mbaruar testimin e Veprimit tuaj dhe është në një gjendje të mirë është koha për të ndarë dashurinë me botën ose, nëse kjo nuk ka kuptim, me miqtë dhe familjen tuaj.

1. Kthehuni te tastiera juaj e Veprimeve dhe zgjidhni veprimin tuaj të planifikuesit të trafikut lokal.
2. Nën "Bëhuni gati për vendosje" klikoni në "Futni informacionin e kërkuar për listimin e Veprimit tuaj në drejtorinë e Veprimeve".
3. Futni një përshkrim të shkurtër, një përshkrim më të gjatë, një logo të vogël, detajet tuaja të kontaktit, një lidhje të politikës së privatësisë (nëse nuk do ta ndani këtë publikisht, thjesht vendosni një lidhje në faqen tuaj të internetit ose diçka) dhe një kategori.
4. Shkoni lart dhe klikoni në "Ruaj".
5. Klikoni në opsionin "Lëshoni" nga shiriti i majtë.
6. Këtu mund të zgjidhni se në çfarë gjendje është Veprimi juaj. Nëse nuk doni të dëgjoni përgjigjen "Le të marrim versionin testues të planifikuesit tim të trafikut lokal" ju duhet të bëni një lëshim të plotë publik. Sidoqoftë, kjo kërkon një rishikim nga Google dhe nuk do të mbulohet në këtë tutorial. Në vend të kësaj, ju ende mund ta ndani këtë me deri në 20 persona duke zgjedhur një lëshim Alpha dhe duke i shtuar ato si testues të Alpha.
7. Shtoni çdo testues alfa ose duke u dërguar atyre një lidhje ose duke shtuar email -et e tyre.
8. Klikoni në "PUBRDORIM P ALR ALPHA", shënoni kutitë, klikoni "PUBRDORIM" dhe mbaroni!

Tani Veprimi juaj është drejtpërdrejt dhe mund të arrihet nga ju dhe miqtë tuaj. Argëtohu!

Nëse jeni të interesuar për kodin që kam përdorur, hidhini një sy projektit në GitHub.