Izradite prilagođene radnje za Google asistenta: 12 koraka

2024 Autor: John Day | [email protected]. Zadnja promjena: 2024-01-30 09:34

Uvidjevši potencijal Google pomoćnika kako je predstavljen u Google I/O 18, kao i Volvo automobile u njihovom infotainment sustavu, nisam mogao odoljeti da ga ne isprobam. Ponovno sam upotrijebio jedan od svojih starijih projekata, VasttraPi i povezao ga s Google asistentom. Ako želite pročitati više o projektu, bit će mi drago ako pogledate povezani članak na mom blogu: Prilagođene radnje za Google pomoćnika.

U ovom Instructableu prelazimo korake potrebne za pokretanje vlastite akcije Google pomoćnika koja će komunicirati s vašim poslužiteljem i razgovarati s vama, navodeći nadolazeće odlaske. Imajte na umu da nećemo koristiti SDK jer ovo radimo potpuno unutar Google asistenta, a ne na vlastitom uređaju. Sve u svemu, to će biti jednostavno. Vaša će radnja biti upotrebljiva na uređajima koji podržavaju Google pomoćnik, poput telefona, tableta, kućnih pomoćnika i nosivih predmeta, a možete je čak i podijeliti kao što biste to učinili s aplikacijom u Trgovini Play!

Jedna od glavnih prednosti stvaranja ovako nečega u odnosu na usluge poput IFTTT -a je ta što možete stvoriti prilagođene odgovore na svom poslužitelju koje će čitati Google pomoćnik. Što se mene tiče, u IFTTT-u je komunikacija jednosmjerna.

Obradit će se sljedeće teme:

• Izrada vašeg prvog akcijskog projekta
• Stvaranje vlastite namjere
• Izrada vašeg prilagođenog entiteta
• Postavljanje web -huka za izvršavanje vaše radnje
• Postavljanje jednostavnog REST poslužitelja, napisanog na Pythonu s Flaskom, koji će pružiti odgovore ili "ispunjenje"
• Testiranje vašeg Action projekta
• Objavljivanje vašeg Action projekta

Ovdje nećete pronaći mnogo detalja ili teorija o različitim funkcijama i konceptima Google asistenta. Ako ste zainteresirani za njih, toplo vam predlažem da slijedite službeni vodič ili pogledate ovaj video.

1. korak: Postavite dopuštenja za svoj Google račun

Prije nego počnemo, moramo osigurati da Google asistent ima odgovarajuća dopuštenja.

1. Idite na Kontrole aktivnosti

2. Provjerite jesu li omogućene sljedeće stavke:

   1. Aktivnost na webu i u aplikacijama
   2. Informacije o uređaju
   3. Glasovna i audio aktivnost

Korak 2: Kreirajte svoju radnju

1. Idite na Actions Console i kliknite "Dodaj/uvozi projekt"
2. Nazovimo ovaj projekt Actions "lokalno-prometni planer".
3. Kliknite na "Izradi projekt".
4. Na sljedećoj stranici nemojte odabrati kategoriju i kliknite "Preskoči".
5. Sada biste trebali biti na glavnoj stranici Konzole za radnje.

Korak 3: Poziv na akciju

Odredite kako želite pokrenuti Google asistenta da započne vašu radnju.

1. Kliknite na "Odluči kako će se tvoja radnja pozvati" u odjeljku "Brzo postavljanje".
2. Nazovite ga "Moj lokalni planer prometa" i kliknite "Spremi".

3. Kliknite na upit "AŽURIRAJ UZORKE INVOCACIJE" koji se pojavio nakon što ste kliknuli spremi.

   Ovu opciju možete pronaći i pod "Podaci o direktoriju"

4. Dodajte "Pitaj moj lokalni planer prometa" kao novi poziv i kliknite "Spremi".

Korak 4: Dodajte svoju prvu radnju

1. Na lijevoj traci kliknite "Radnje".
2. Kliknite na "DODAJ SVOJU PRVU AKCIJU".
3. Odaberite "Prilagođena namjera", a zatim kliknite "Izradi".
4. Bit ćete preusmjereni na stranicu Dialogflow gdje ćete implementirati glavnu logiku.

Korak 5: Obuka fraza za vašu namjeru

1. Odaberite svoju vremensku zonu i kliknite "Kreiraj".
2. Na sljedećoj stranici ostavite postojeće namjere i kliknite "CREATE INTENT".
3. Dajte namjeri razumno ime, tj. "Odlasci".
4. Idite na "Fraze za obuku" i kliknite na "Dodaj fraze za obuku".

5. Upotrijebite sljedeće izraze za obuku svog modela kako bi mogao protumačiti ono što mu govorite:

   1. Trenutno sam kod kuće
   2. Zasad sam doma
   3. Trenutno sam u našem stanu
   4. Sjedim doma
   5. Trenutno sam blizu posla
   6. ja sam na poslu
   7. U uredu sam
   8. Raditi
   9. Dom

Korak 6: Entiteti

Sada ste naveli ono što bi se manje ili više trebalo očekivati kao input, moramo definirati koji dijelovi unosa su od interesa za našu poslovnu logiku kako bi se mogli izdvojiti i istaknuti na naš poslužitelj. U našem slučaju želimo znati je li korisnik kod kuće ili na poslu, pa možemo odgovoriti polascima s određene postaje. Pogledajmo kako to možemo učiniti.

1. Ako dvaput kliknete na jednu ili više riječi izraza za obuku, dobit ćete popis unaprijed definiranih entiteta. Ovdje možete pročitati više o svakom od njih. Općenito, najprikladnija bi bila @sys.location, međutim mislim da je najbolje i najjednostavnije ako stvorimo vlastiti entitet koji bismo trebali nazvati @current-location.
2. Kliknite na opciju "Entiteti" s lijeve strane.
3. Kliknite na "CREATE ENTITY".

4. Postavite naziv na "trenutna lokacija" i definirajte dvije referentne vrijednosti zajedno sa njihovim sinonimima:

   1. Dom

      dom, kuća, stan, krevetić

   2. raditi

      posao, ured, Aptiv, rudnici kodova (lol samo se šalim)

5. Kliknite na "Spremi. Za dodatni učinak možete kliknuti i na" Dopusti automatizirano proširenje "kako biste Google asistentu dali dodatne slobode da pokuša uskladiti više sinonima s vašim referentnim vrijednostima.

Korak 7: Radnja i parametri

Vrijeme je da ključnim riječima u izrazima za obuku date neko značenje.

1. Kliknite na "Namjere", a zatim idite do prilagođene namjere, tj. "Odlasci" ako ste slijedili moje prijedloge imena.
2. Pomaknite se prema dolje do "Fraze za obuku".
3. Dvaput kliknite na riječi koje označavaju vašu trenutačnu lokaciju i odaberite oznaku @trenutna lokacija u skočnom prozoru.
4. Pomaknite se dolje do "Radnje i parametri", kliknite na "upravljanje"
5. Ako je sve učinjeno ispravno, vidjet ćete da se na popisu nalazi vaš novi entitet.
6. Potvrdite okvir "Obavezno" kako bi se pojavio novi stupac "Odzivnici". Odziv je ono što će korisnik čuti ako nije dostavljeno ništa što odgovara očekivanjima.
7. Kliknite na "Definiraj upite" i umetnite nešto poput "Nisam razumio vašu lokaciju. Gdje ste trenutno?".

Korak 8: Ispunjenje

Sada je vrijeme da povežete svoju web uslugu s radnjom Google pomoćnika. Vaša će se udica pozvati kada se aktivira ova određena namjera i trebala bi proizvesti ispunjenje ove radnje. Prije toga također želimo postaviti namjeru da dovršimo radnju nakon što je ispunjena.

1. Idite na "Odgovori" i kliknite na "DODAJ ODGOVOR".
2. Nemojte dodavati odgovore, samo omogućite "Postavi ovu namjeru kao kraj razgovora".
3. Pomaknite se dolje do "Ispunjenje", kliknite na "Omogući ispunjenje", a zatim uključite "Omogući poziv webhook -a za ovu namjeru".
4. Pritisnite "Spremi", a zatim idite na opciju "Ispunjenje" s lijeve strane.

5. Omogućite opciju "Webhook" i umetnite URL koji "sluša" vaš web poslužitelj.

   Kad god se namjera aktivira, poslat će POST zahtjev na vašu web stranicu s tijelom zahtjeva koji sadrži JSON objekt s trenutnom lokacijom korisnika

6. Pritisnite Spremi.
7. Sada smo spremni za stvaranje naše web usluge, ali prije toga, pobrinimo se da nas naša akcija dočeka na odgovarajući način.

9. korak: namjera dobrodošlice

Kako bismo prilagodili korisničko iskustvo, trebali bismo stvoriti odgovarajući pozdrav za nas kad god pokrenemo našu radnju.

1. Idite na "Namjere", a zatim kliknite na "Zadana namjera dobrodošlice".
2. Pomaknite se prema dolje do "Odgovori", uklonite postojeće i umetnite ono što želite da vaša radnja dočeka nakon što je pokrenuta.
3. Pritisnite "Spremi".

Korak 10: Vaša Python web usluga

Napravimo brzi i prljavi poslužitelj Python pomoću Flaska. Nema snimaka zaslona za ovaj korak, ali bi trebalo biti prilično ravno.

1. Otvorite novu karticu i stvorite račun na pythonanywhere.com
2. Potvrdite svoju e -poštu.
3. Postavite svoju web aplikaciju klikom na "Otvori web karticu".
4. Pritisnite "Dodaj novu web aplikaciju" i odaberite "Flask" kao svoj Python web okvir.
5. Odaberite Python 3.6 i kliknite "Dalje".
6. Odaberite put na kojem želite da vaša "flask_app.py" boravi. Postavio sam ga izravno u svoju kućnu mapu kao "/home/vaše-korisničkoime/flask_app.py".
7. Vratite se na glavnu stranicu klikom na Python logo u gornjem lijevom kutu.
8. Ispod datoteka kliknite "flask_app.py" za početak uređivanja.
9. Kad se otvori uređivač web -teksta, zalijepite sljedeći kôd i kliknite "Spremi". Opća ideja je da će, ovisno o raščlanjenom JSON -u koji dolazi s Google pomoćnika, naš poslužitelj izvršiti radnju (npr. Čitati ili pisati) i prijaviti je kao odgovor /ispunjenje koje bi trebalo pročitati korisniku.
10. Ponovno kliknite "Otvori web karticu", a zatim zelenu tipku "Ponovno učitaj".
11. Do sada biste trebali imati vlastiti Python web poslužitelj pokrenut na "https://vaše korisničko ime.pythonanywhere.com/departures".

Korak 11: Testirajte svoju radnju

U redu, već ste prilično gotovi. Isprobajmo sada cijeli hrpu i učinimo da ovaj primjer "Hello world" funkcionira!

1. Na lijevoj bočnoj traci kliknite "Integracije".
2. Kliknite na "Integration Settings" pod opcijom Google Assistant.
3. U odjeljku "Implicitno pozivanje dodajte naziv svoje namjere, tj." Odlaske "tako da se može pokrenuti izravno izgovaranjem nečega poput" Hej Google, razgovaraj s mojim lokalnim planerom prometa o odlascima od kuće ".
4. Omogućite promjene "Automatski pregled".
5. Kliknite na "Test" koji će otvoriti novu stranicu.
6. Upišite "Razgovaraj s Mojim lokalnim planerom prometa".
7. Trebalo bi pozvati vašu radnju koja bi vas trebala pozdraviti jednim od prethodno postavljenih odgovora namjere dobrodošlice.
8. Zatim upišite "Ja sam na poslu". Treba kontaktirati vaš Python poslužitelj i odgovor će pročitati Google pomoćnik.

Kul zar ne? Sada zamislite što možete učiniti u interakciji sa senzorima, aktuatorima i drugim API -jem putem vašeg Google asistenta.

Korak 12: Otpustite svoju radnju

Nakon što završite s testiranjem svoje akcije i ona je u dobrom stanju, vrijeme je da podijelite ljubav sa svijetom ili, ako to nema smisla, sa svojim prijateljima i obitelji.

1. Vratite se na konzolu Actions i odaberite radnju lokalnog planera prometa.
2. U odjeljku "Pripremite se za implementaciju" kliknite na "Unesite podatke potrebne za navođenje vaše radnje u direktorij Actions".
3. Unesite kratki opis, duži opis, mali logotip, svoje podatke za kontakt, vezu na politiku privatnosti (ako ovo nećete javno podijeliti, samo postavite vezu na svoju web stranicu ili nešto slično) i kategoriju.
4. Pomaknite se prema gore i kliknite "Spremi".
5. Na lijevoj bočnoj traci kliknite opciju "Otpusti".
6. Ovdje možete izabrati u kakvom se stanju vaša radnja nalazi. Ako ne želite čuti odgovor "Idemo nabaviti probnu verziju Moga lokalnog planera prometa", morate objaviti potpuno javno izdanje. Međutim, to zahtijeva Googleov pregled i neće biti obrađeno u ovom vodiču. Umjesto toga, to i dalje možete podijeliti s do 20 ljudi odabirom alfa izdanja i dodavanjem njih kao alfa testere.
7. Dodajte alfa testere tako što ćete im poslati vezu ili dodati njihovu e -poštu.
8. Kliknite na "SUBMIT FOR ALPHA", označite okvire, kliknite "SUBMIT" i gotovi ste!

Sada je vaša akcija aktivna i možete joj pristupiti vi i vaši prijatelji. Zabavi se!

Ako vas zanima kod koji sam koristio, pogledajte projekt na GitHubu.