Sukurkite pasirinktinius „Google“padėjėjo veiksmus: 12 žingsnių

2024 Autorius: John Day | [email protected]. Paskutinį kartą keistas: 2024-01-30 10:46

Matydamas „Google“padėjėjo galimybes, pateiktas „Google I/O 18“, taip pat „Volvo Cars“jų informacinėje ir pramogų sistemoje, negalėjau atsispirti. Aš pakartotinai panaudojau vieną iš savo senesnių projektų „VasttraPi“ir sujungiau jį su „Google“padėjėju. Jei norite daugiau sužinoti apie projektą, man būtų malonu, jei peržiūrėtumėte susijusį straipsnį mano tinklaraštyje: „Google Assistant“pritaikyti veiksmai.

Šioje instrukcijoje mes atliekame veiksmus, būtinus norint pradėti savo „Google“padėjėjo veiksmą, kuris palaikys ryšį su jūsų serveriu ir su jumis susisieks, išvardydamas būsimus išvykimus. Atminkite, kad nenaudosime SDK, nes visa tai vykdome „Google Assistant“, o ne savo įrenginyje. Apskritai tai bus paprasta. Jūsų veiksmą bus galima naudoti įrenginiuose, palaikančiuose „Google“padėjėją, pvz., Telefonuose, planšetiniuose kompiuteriuose, namų asistentuose ir nešiojamuose kompiuteriuose, ir jūs netgi galite jais bendrinti naudodami programą „Play“parduotuvėje!

Vienas iš pagrindinių pranašumų kuriant kažką panašaus, palyginti su tokiomis paslaugomis kaip IFTTT, yra tai, kad savo serveryje galite sukurti pasirinktinius atsakymus, kuriuos perskaitys „Google“padėjėjas. Kalbant apie IFTTT, mano nuomone, bendravimas yra vienpusis.

Bus aptartos šios temos:

• Kuriate savo pirmąjį veiksmo projektą
• Sukurkite savo pasirinktą ketinimą
• Sukurkite savo pasirinktinį objektą
• Nustatykite žiniatinklio kablį, kad įvykdytumėte savo veiksmą
• Sukurkite paprastą REST serverį, parašytą „Python“su „Flask“, kuris suteiks atsakymus arba „išsipildys“
• Jūsų veiksmų projekto išbandymas
• Jūsų veiksmų projekto išleidimas

Čia nerasite daug informacijos ar teorijos apie įvairias „Google Assistant“funkcijas ir koncepcijas. Jei jus domina, primygtinai siūlau sekti oficialią pamoką arba žiūrėti šį vaizdo įrašą.

1 veiksmas: nustatykite „Google“paskyros leidimus

Prieš pradėdami turime įsitikinti, kad „Google“padėjėjas turi atitinkamus leidimus.

1. Eikite į veiklos valdiklius

2. Įsitikinkite, kad įjungta toliau nurodyta informacija.

   1. Žiniatinklio ir programų veikla
   2. Įrenginio informacija
   3. Balso ir garso veikla

2 žingsnis: sukurkite savo veiksmą

1. Eikite į „Actions Console“ir spustelėkite „Pridėti/importuoti projektą“
2. Pavadinkime šį Veiksmų projektą „vietinio eismo planuotoju“.
3. Spustelėkite „Sukurti projektą“.
4. Kitame puslapyje nesirinkite kategorijos ir spustelėkite „Praleisti“.
5. Dabar turėtumėte būti pagrindiniame „Veiksmų pulto“puslapyje.

3 veiksmas: veiksmų raginimas

Nustatykite, kaip norite suaktyvinti „Google“padėjėją, kad jis pradėtų veiksmą.

1. Skiltyje „Greita sąranka“spustelėkite „Nuspręsti, kaip jūsų veiksmas iškviečiamas“.
2. Pavadinkite jį „Mano vietinis eismo planuotojas“ir spustelėkite „Išsaugoti“.

3. Spustelėkite raginimą „ATNAUJINTI MĖGINIŲ KVIETIMUS“, kuris pasirodė spustelėjus išsaugoti.

   Šią parinktį taip pat rasite skiltyje „Katalogo informacija“

4. Pridėkite „Klausti mano vietinio eismo planuotojo“kaip naują šaukimą ir spustelėkite „Išsaugoti“.

4 veiksmas: pridėkite savo pirmąjį veiksmą

1. Kairėje esančioje juostoje spustelėkite „Veiksmai“.
2. Spustelėkite „PRIDĖTI PIRMĄ VEIKSMĄ“.
3. Pasirinkite „Pasirinktinis tikslas“, tada spustelėkite „Sukurti“.
4. Būsite nukreipti į dialogo lango puslapį, kuriame įgyvendinsite pagrindinę logiką.

5 žingsnis: mokymo frazės pagal jūsų ketinimą

1. Pasirinkite savo laiko juostą ir spustelėkite „Sukurti“.
2. Kitame puslapyje palikite esamus ketinimus ir spustelėkite „Sukurti ketinimą“.
3. Nurodykite ketinimui pagrįstą pavadinimą, ty „išvykimai“.
4. Eikite į „Mokymo frazės“ir spustelėkite „Pridėti mokymo frazes“.

5. Naudokite šias frazes, kad išmokytumėte savo modelį, kad jis galėtų interpretuoti tai, ką jūs jam sakote:

   1. Šiuo metu esu namuose
   2. Kol kas aš namie
   3. Šiuo metu esu mūsų bute
   4. Aš sėdžiu namuose
   5. Šiuo metu esu netoli darbo
   6. Aš esu darbe
   7. Aš esu biure
   8. Darbas
   9. Namai

6 žingsnis: objektai

Dabar jūs nurodėte, ko reikėtų daugiau ar mažiau tikėtis kaip įvesties, turime apibrėžti, kurios įvesties dalys yra svarbios mūsų verslo logikai, kad jas būtų galima išgauti ir paryškinti mūsų serveryje. Mūsų atveju norime žinoti, ar vartotojas yra namuose, ar darbe, todėl galime atsakyti nurodydami išvykimus iš konkrečios stoties. Pažiūrėkime, kaip tai galime padaryti.

1. Jei dukart spustelėsite vieną ar daugiau mokymo frazių žodžių, gausite iš anksto nustatytų objektų sąrašą. Daugiau apie kiekvieną iš jų galite perskaityti čia. Apskritai tinkamiausias būtų @sys.location, tačiau manau, kad geriausia ir lengviausia, jei sukuriame savo subjektą, kurį turėtume vadinti @current-location.
2. Kairėje pusėje spustelėkite parinktį „Subjektai“.
3. Spustelėkite „Sukurti objektą“.

4. Nustatykite pavadinimą „dabartinė vieta“ir apibrėžkite dvi etalonines vertes kartu su jų sinonimais:

   1. namai

      namas, namas, butas, lovelė

   2. dirbti

      darbas, biuras, „Aptiv“, kodų kasyklos (lol tiesiog juokauju)

5. Spustelėkite „Išsaugoti. Norėdami gauti papildomo efekto, taip pat galite spustelėti„ Leisti automatinį išplėtimą “, kad suteiktumėte„ Google “padėjėjui daugiau laisvių bandyti suderinti daugiau sinonimų su jūsų pamatinėmis vertėmis.

7 veiksmas: veiksmas ir parametrai

Laikas įprasminti raktinius žodžius treniruočių frazėse.

1. Spustelėkite „Ketinimai“ir eikite į savo pasirinktą ketinimą, t. Y. „Išvykimai“, jei sekėte mano vardo pasiūlymus.
2. Slinkite žemyn iki „Mokymo frazės“.
3. Dukart spustelėkite žodžius, nurodančius jūsų dabartinę vietą, ir iššokančiame lange pasirinkite žymą @dabartinė vieta.
4. Slinkite žemyn iki „Veiksmai ir parametrai“, spustelėkite „tvarkyti“
5. Jei viskas buvo padaryta teisingai, pamatysite savo naują objektą.
6. Pažymėkite langelį „Būtina“, kuris parodys naują stulpelį „Raginimai“. Vartotojas turi išgirsti raginimus, jei nebuvo pateikta nieko, kas atitiktų lūkesčius.
7. Spustelėkite „Apibrėžti raginimus“ir įterpkite kažką panašaus į „Aš nesupratau jūsų buvimo vietos. Kur jūs šiuo metu esate?“.

8 žingsnis: įvykdymas

Dabar atėjo laikas prijungti savo žiniatinklio paslaugą prie „Google“padėjėjo veiksmo. Jūsų kablys bus iškviestas, kai bus įvykdytas šis konkretus ketinimas, ir jis turėtų įvykdyti šį veiksmą. Prieš tai taip pat norime nusistatyti ketinimą užbaigti veiksmą, kai jis bus įvykdytas.

1. Eikite į „Atsakymai“ir spustelėkite „PRIDĖTI ATSAKYMĄ“.
2. Nepridėkite jokių atsakymų, tiesiog įjunkite parinktį „Nustatyti šį ketinimą kaip pokalbio pabaigą“.
3. Slinkite žemyn iki „Įvykdymas“, spustelėkite „ĮJUNGTI VYKDYMĄ“, tada įjunkite „Įgalinti„ Webhook “iškvietimą šiam tikslui“.
4. Spustelėkite „Išsaugoti“, tada eikite į parinktį „Išsipildymas“kairėje pusėje.

5. Įjunkite parinktį „Webhook“ir įterpkite URL, kurio „klausosi“jūsų žiniatinklio serveris.

   Kai tik suaktyvinamas ketinimas, jis nusiųs jūsų svetainei POST užklausą su užklausos turiniu, kuriame yra JSON objektas su dabartine vartotojo vieta

6. Spustelėkite Išsaugoti.
7. Dabar esame pasirengę sukurti savo žiniatinklio paslaugą, tačiau prieš tai įsitikinkime, kad mūsų veiksmai mus priima tinkamai.

9 žingsnis: sveikinimo ketinimas

Norėdami pritaikyti naudotojų patirtį, turėtume sukurti mums tinkamą pasveikinimą, kai tik imamės veiksmų.

1. Eikite į „Ketinimai“, tada spustelėkite „Numatytasis pasveikinimo ketinimas“.
2. Slinkite žemyn iki „Atsakymai“, pašalinkite esamus ir įterpkite norimą veiksmą, kaip jus pasveikinti, kai jis bus pradėtas.
3. Spustelėkite „Išsaugoti“.

10 veiksmas: „Python“žiniatinklio paslauga

Padarykime greitą ir nešvarų „Python“serverį naudodami „Flask“. Nėra šio veiksmo ekrano kopijų, tačiau jis turėtų būti gana paprastas.

1. Atidarykite naują skirtuką ir sukurkite paskyrą svetainėje pythonanywhere.com
2. Patvirtinkite savo el.
3. Nustatykite žiniatinklio programą spustelėdami „Atidaryti žiniatinklio skirtuką“.
4. Spustelėkite „Pridėti naują žiniatinklio programą“ir kaip „Python“žiniatinklio sistemą pasirinkite „Kolba“.
5. Pasirinkite „Python 3.6“ir spustelėkite „Kitas“.
6. Pasirinkite kelią, kuriame norite naudoti „flask_app.py“. Įdėjau jį tiesiai į savo namų aplanką kaip „/home/your-username/flask_app.py“.
7. Grįžkite į pagrindinį puslapį spustelėdami „Python“logotipą viršutiniame kairiajame kampe.
8. Po failais spustelėkite „flask_app.py“, kad pradėtumėte jį redaguoti.
9. Kai atsidarys žiniatinklio teksto rengyklė, įklijuokite šį kodą ir spustelėkite „Išsaugoti“. Bendra mintis yra ta, kad priklausomai nuo analizuojamo JSON, gaunamo iš „Google Assistentant“, mūsų serveris atliks veiksmą (pvz., Skaitys ar rašys) ir praneš apie jį kaip atsakymą /įvykdymas, kurį reikia perskaityti vartotojui.
10. Dar kartą spustelėkite „Atidaryti žiniatinklio skirtuką“, tada - žalią mygtuką „Įkelti iš naujo“.
11. Iki šiol turėtumėte turėti savo „Python“žiniatinklio serverį, veikiantį „https://your-username.pythonanywhere.com/departures“.

11 veiksmas: išbandykite savo veiksmus

Gerai, jūs jau beveik baigėte. Išbandykime visą krūvą dabar ir pradėkime naudoti šį „Labas pasaulis“pavyzdį!

1. Kairėje šoninėje juostoje spustelėkite „Integracijos“.
2. „Google“padėjėjo parinktyje spustelėkite „Integracijos nustatymai“.
3. Skiltyje „Netiesioginis šaukimas“pridėkite savo ketinimo pavadinimą, t. Y. „Išvykimą“, kad jį būtų galima tiesiogiai suaktyvinti, pasakius kažką panašaus į „Ei,„ Google “, pasikalbėkite su mano vietiniu eismo planuotoju apie išvykimą iš namų“.
4. Įgalinti „Automatinės peržiūros“pakeitimus.
5. Spustelėkite „Test“, kuris atvers naują puslapį.
6. Įveskite „Pasikalbėkite su mano vietiniu eismo planavimo priemone“.
7. Turėtumėte pasinaudoti savo veiksmu, kuris turėtų pasveikinti jus vienu iš anksčiau nustatytų sveikinimo ketinimų atsakymų.
8. Tada įveskite „aš darbe“. Reikėtų susisiekti su jūsų „Python“serveriu ir atsakymą perskaityti „Google“padėjėjas.

Šaunu ar ne? Dabar įsivaizduokite, ką galite padaryti bendraudami su jutikliais, pavaromis ir kitomis API per „Google“padėjėją.

12 veiksmas: atleiskite savo veiksmus

Kai baigsite savo veiksmo testavimą ir būsite geros būklės, laikas pasidalyti meile su pasauliu arba, jei tai nėra prasminga, su draugais ir šeima.

1. Grįžkite į „Actions“konsolę ir pasirinkite vietinio eismo planavimo veiksmą.
2. Skiltyje „Pasiruoškite diegti“spustelėkite „Įveskite informaciją, reikalingą jūsų veiksmui įtraukti į veiksmų katalogą“.
3. Įveskite trumpą aprašymą, ilgesnį aprašymą, mažą logotipą, savo kontaktinius duomenis, nuorodą į privatumo politiką (jei neketinate to viešai bendrinti, tiesiog įdėkite nuorodą į savo svetainę ar pan.) Ir kategoriją.
4. Slinkite aukštyn ir spustelėkite „Išsaugoti“.
5. Kairėje šoninėje juostoje spustelėkite parinktį „Atleisti“.
6. Čia galite pasirinkti, kokioje būsenoje yra jūsų veiksmas. Jei nenorite išgirsti atsakymo „Gaukime mano vietinio eismo planavimo priemonės bandomąją versiją“, turite pateikti visavertį viešą leidimą. Tačiau tam reikia „Google“peržiūros ir jis nebus aptartas šioje pamokoje. Vietoj to, vis tiek galite tai bendrinti su iki 20 žmonių, pasirinkę „Alpha“versiją ir pridėję juos kaip „Alpha“bandytojus.
7. Pridėkite bet kokius alfa bandytojus, atsiųsdami jiems nuorodą arba pridėdami el.
8. Spustelėkite „PATEIKTI ALFAI“, pažymėkite laukelius, spustelėkite „PATEIKTI“ir viskas!

Dabar jūsų veiksmas yra tiesioginis ir jį galite pasiekti jūs ir jūsų draugai. Pasilinksmink!

Jei jus domina mano naudojamas kodas, pažvelkite į projektą „GitHub“.