Kreirajte prilagođene radnje za Google pomoćnika: 12 koraka

2025 Autor: John Day | [email protected]. Zadnja izmjena: 2025-01-23 14:37

Uvidjevši potencijal Google Asistenta kako je predstavljen u Google I/O 18, kao i Volvo Cars u njihovom infotainment sistemu, 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 Instructable -u prelazimo korake potrebne za pokretanje vlastite akcije Google pomoćnika koja će komunicirati s vašim serverom 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ćnika, 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 komunikacija je jednosmjerna.

Obradit će se sljedeće teme:

• Kreiranje vašeg prvog Action projekta
• Kreiranje prilagođene namjere
• Kreiranje vašeg prilagođenog entiteta
• Postavljanje web -huka za izvršavanje vaše radnje
• Postavljanje jednostavnog REST servera, 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 pomoćnika. Ako vas zanimaju, toplo vam predlažem da slijedite službeni vodič ili pogledate ovaj video.

Korak 1: Postavite dozvole za svoj Google račun

Prije nego počnemo, moramo osigurati da Google Asistent ima odgovarajuća odobrenja.

1. Idite na Kontrole aktivnosti

2. Uvjerite se da je omogućeno sljedeće:

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

Korak 2: Kreirajte svoju radnju

1. Idite na Actions Console i kliknite na "Add/import project"
2. Nazovimo ovaj projekt Actions "lokalni-planer prometa".
3. Kliknite na "Kreiraj projekat".
4. Na sljedećoj stranici nemojte odabrati kategoriju i kliknite na "Preskoči".
5. Sada biste trebali biti na glavnoj stranici Konzole za radnje.

Korak 3: Pozivanje 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" pod "Brzo postavljanje".
2. Nazovite ga "Moj lokalni planer prometa" i kliknite "Spremi".

3. Kliknite na upit "AŽURIRAJ UZORKE INVOCACIJE" koji se pojavio nakon klika na spremi.

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

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

Korak 4: Dodajte svoju prvu radnju

1. Kliknite na "Akcije" na lijevoj traci.
2. Kliknite na "DODAJTE 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: Obučite fraze za svoju namjeru

1. Odaberite svoju vremensku zonu i kliknite "Kreiraj".
2. Na sljedećoj stranici ostavite postojeće namjere i kliknite na "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. Za sada sam kod kuće
   3. Trenutno sam u našem stanu
   4. Sjedim kod kuće
   5. Trenutno sam blizu posla
   6. ja sam na poslu
   7. Ja sam u kancelariji
   8. Work
   9. Dom

Korak 6: Entiteti

Sada ste naveli ono što bi trebalo manje ili više očekivati kao ulaz, 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 stanice. 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. Sve u svemu, 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. rad

      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 dolje do "Fraze za obuku".
3. Dvaput kliknite na riječi koje označavaju vašu trenutnu lokaciju i odaberite oznaku @trenutna lokacija iz skočnog prozora.
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. Označite okvir "Obavezno" kako bi se pojavila nova kolona "Prompti". 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 udica će biti pozvana kada se ova specifična namjera aktivira i trebala bi proizvesti ispunjenje ove radnje. Prije toga, također želimo postaviti namjeru da završ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, ona će poslati 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.

Korak 9: Namera 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 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 Python server koristeći Flask. Nema snimaka zaslona za ovaj korak, ali bi trebao biti prilično jasan.

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. Kliknite na "Dodaj novu web aplikaciju" i odaberite "Flask" kao svoj Python web okvir.
5. Odaberite Python 3.6 i kliknite "Dalje".
6. Odaberite putanju na kojoj želite da vaša "flask_app.py" boravi. Postavio sam je direktno 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" da biste započeli uređivanje.
9. Kada se otvori uređivač tekstualnog teksta, zalijepite sljedeći kôd i kliknite "Spremi". Opća ideja je da će, ovisno o raščlanjenom JSON -u koji dolazi od 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. Ponovo kliknite na "Otvori web karticu", a zatim na zeleno "Dugme za ponovno učitavanje".
11. Do sada biste trebali imati svoj vlastiti Python web poslužitelj pokrenut na "https://vaše korisničko ime.pythonanywhere.com/departures".

Korak 11: Testirajte svoju radnju

U redu, skoro ste već završili. Hajde sada isprobati cijeli stog i učinimo da ovaj primjer "Hello world" funkcionira!

1. Kliknite na "Integrations" na lijevoj bočnoj traci.
2. Kliknite na "Postavke integracije" ispod opcije Google pomoćnik.
3. U odjeljku "Implicitno pozivanje dodajte naziv svoje namjere, tj." Polasci "tako da se može pokrenuti izravno govoreći nešto 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 server, a Google Asistent će pročitati odgovor.

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 porodicom.

1. Vratite se na svoju 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 kratak opis, duži opis, mali logotip, svoje podatke za kontakt, vezu za politiku privatnosti (ako ovo nećete javno dijeliti, samo postavite vezu na svoju web stranicu ili nešto slično) i kategoriju.
4. Pomaknite se prema gore i kliknite na "Spremi".
5. Kliknite na opciju "Otpusti" na lijevoj bočnoj traci.
6. Ovdje možete izabrati u kojem se stanju vaša radnja nalazi. Ako ne želite čuti odgovor "Hajde da nabavimo probnu verziju Mog lokalnog planera prometa", morate napraviti punopravno javno izdanje. Međutim, to zahtijeva Googleov pregled i neće biti obrađeno u ovom vodiču. Umjesto toga, ovo i dalje možete podijeliti s do 20 ljudi odabirom Alpha izdanja i dodavanjem njih kao Alfa testera.
7. Dodajte alfa testere tako što ćete im poslati vezu ili dodati njihovu e -poštu.
8. Kliknite na "SUBMIT FOR ALPHA", označite polja, kliknite na "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.