Ustvarjanje dejanj po meri za Pomočnika Google: 12 korakov

2024 Avtor: John Day | [email protected]. Nazadnje spremenjeno: 2024-01-30 12:04

Ko sem videl potencial Googlovega pomočnika, kot je bil predstavljen v Googlu I/O 18, pa tudi Volvo Cars v njihovem infotainment sistemu, se nisem mogel upreti preizkusiti. Ponovno sem uporabil enega od svojih starejših projektov, VasttraPi in ga povezal z Googlovim pomočnikom. Če želite prebrati več o projektu, bom vesel, če si ogledate sorodni članek na mojem blogu: Dejanja po meri za Pomočnika Google.

V tem navodilu bomo preučili korake, potrebne za zagon lastnega dejanja Pomočnika Google, ki bo komuniciralo s strežnikom in se z vami pogovarjalo ter navedlo prihajajoče odhode. Upoštevajte, da SDK -ja ne bomo uporabljali, saj to izvajamo popolnoma v Pomočniku Google in ne v svoji napravi. Na splošno bo vse preprosto. Vaše dejanje bo uporabno v napravah, ki podpirajo Googlovega pomočnika, kot so telefoni, tablični računalniki, domači pomočniki in nosljivi izdelki, in jih lahko delite celo tako, kot bi to storili z aplikacijo v Trgovini Play!

Ena glavnih prednosti ustvarjanja česa takega pred uporabo storitev, kot je IFTTT, je, da lahko v strežniku ustvarite odzive po meri, ki jih bo bral Pomočnik Google. Kar zadeva IFTTT, je komunikacija enosmerna.

Obdelane bodo naslednje teme:

• Ustvarite svoj prvi projekt Action
• Ustvarjanje namena po meri
• Ustvarjanje entitete po meri
• Nastavitev spletnega kljuka za izvajanje vašega dejanja
• Nastavitev preprostega strežnika REST, napisanega v Pythonu s Flaskom, ki bo zagotovil odzive ali "izpolnitev"
• Preizkusite svoj akcijski projekt
• Objava vašega akcijskega projekta

Tu ne boste našli veliko podrobnosti ali teorije o različnih funkcijah in konceptih Pomočnika Google. Če vas zanimajo, vam toplo priporočam, da sledite uradni vadnici ali si ogledate ta video.

1. korak: nastavite dovoljenja za Google Račun

Preden začnemo, moramo zagotoviti, da ima Google Assistant ustrezna dovoljenja.

1. Pojdite na Nadzor dejavnosti

2. Prepričajte se, da je omogočeno naslednje:

   1. Dejavnost v spletu in aplikacijah
   2. Informacije o napravi
   3. Glasovna in zvočna dejavnost

2. korak: Ustvarite svoje dejanje

1. Pojdite na Actions Console in kliknite »Dodaj/uvozi projekt«
2. Poimenujmo ta projekt Actions "local-traffic-planener".
3. Kliknite na "Ustvari projekt".
4. Na naslednji strani ne izberite kategorije in kliknite »Preskoči«.
5. Zdaj bi morali biti na glavni strani Actions Console.

3. korak: Poziv k dejanju

Določite, kako želite, da Google Assistant sproži vaše dejanje.

1. V razdelku »Hitra nastavitev« kliknite »Odločite, kako se bo vaše dejanje priklicalo«.
2. Pokličite ga "Moj lokalni načrtovalec prometa" in kliknite "Shrani".

3. Kliknite poziv »UPDATE SAMPLE INVOCATIONS«, ki se je pojavil po kliku shrani.

   To možnost najdete tudi pod "Podatki o imeniku"

4. Kot nov poziv dodajte »Vprašaj mojega lokalnega načrtovalca prometa« in kliknite »Shrani«.

4. korak: Dodajte svoje prvo dejanje

1. V levi vrstici kliknite "Dejanja".
2. Kliknite na "DODAJ SVOJO PRVO AKCIJO".
3. Izberite "Namen po meri" in kliknite "Sestavi".
4. Preusmerjeni boste na stran Dialogflow, kjer boste implementirali glavno logiko.

5. korak: Usposabljanje stavkov za vaš namen

1. Izberite časovni pas in kliknite »Ustvari«.
2. Na naslednji strani pustite obstoječe namene in kliknite »Ustvari namero«.
3. Nameri dajte razumno ime, to je "odhodi".
4. Pojdite na "Fraze za usposabljanje" in kliknite na "Dodaj stavke za usposabljanje".

5. Uporabite naslednje stavke za usposabljanje svojega modela, da bo lahko razlagal, kaj mu govorite:

   1. Trenutno sem doma
   2. Zaenkrat sem doma
   3. Trenutno sem v najinem stanovanju
   4. Sedim doma
   5. Trenutno sem blizu službe
   6. sem v službi
   7. Sem v pisarni
   8. Delo
   9. Domov

6. korak: Entitete

Zdaj ste določili, kaj bi morali biti bolj ali manj pričakovani kot vhodni podatki, določiti moramo, kateri deli vnosa so zanimivi za našo poslovno logiko, da jih lahko izvlečemo in označimo na našem strežniku. V našem primeru želimo vedeti, ali je uporabnik doma ali v službi, zato se lahko odzovemo z odhodi z določene postaje. Poglejmo, kako lahko to storimo.

1. Če dvokliknete eno ali več besed stavkov za usposabljanje, boste dobili seznam vnaprej določenih entitet. Več o vsakem od njih lahko preberete tukaj. Na splošno bi bila najprimernejša @sys.location, vendar mislim, da je najbolje in najlažje, če ustvarimo lastno entiteto, ki bi jo morali poklicati @current-location.
2. Na levi strani kliknite možnost »Entitete«.
3. Kliknite "Ustvari entiteto".

4. Ime nastavite na "trenutna lokacija" in določite dve referenčni vrednosti skupaj z njunima sinonimama:

   1. doma

      dom, hiša, stanovanje, jaslice

   2. delo

      služba, pisarna, Aptiv, rudniki kod (lol, samo šala)

5. Kliknite na "Shrani. Za dodaten učinek lahko kliknete tudi na" Dovoli samodejno razširitev ", da Googlovemu pomočniku omogočite dodatne svobode, da poskuša ujemati več sopomenk z vašimi referenčnimi vrednostmi.

7. korak: Dejanje in parametri

Čas je, da ključnim besedam v svojih stavkih za usposabljanje date nekaj pomena.

1. Kliknite »Namere« in se pomaknite do svojega namena po meri, to je »odhodi«, če ste sledili mojim predlogom za ime.
2. Pomaknite se navzdol do »Stavki za usposabljanje«.
3. Dvokliknite besede, ki označujejo vašo trenutno lokacijo, in v pojavnem oknu izberite oznako @trenutna lokacija.
4. Pomaknite se navzdol do "Dejanja in parametri", kliknite na "upravljanje"
5. Če je bilo vse opravljeno pravilno, bo tam prikazan vaš novi subjekt.
6. Potrdite polje "Zahtevano", da se prikaže nov stolpec "Pozivi". Uporabniki bodo slišali pozive, če ni bilo podano nič, kar ustreza pričakovanjem.
7. Kliknite "Določi pozive" in vnesite nekaj takega, "Nisem razumel vaše lokacije. Kje ste trenutno?".

8. korak: Izpolnitev

Zdaj je čas, da svojo spletno storitev priključite na dejanje Pomočnika Google. Vaša kljuka bo poklicana, ko se sproži ta poseben namen in bi morala narediti to dejanje. Pred tem želimo tudi določiti naš namen, da bomo dejanje zaključili po tem, ko je bilo izpolnjeno.

1. Pojdite na "Odzivi" in kliknite na "DODAJ ODGOVOR".
2. Ne dodajajte nobenih odgovorov, samo omogočite »Nastavi ta namen kot konec pogovora«.
3. Pomaknite se navzdol do »Izpolnitev«, kliknite »VKLOPI IZPOLNITEV« in nato vklopite »Omogoči klic spletnega kljuka za ta namen«.
4. Kliknite »Shrani« in nato pojdite na možnost »Izpolnitev« na levi strani.

5. Omogočite možnost »Webhook« in vstavite URL, ki ga »posluša« vaš spletni strežnik.

   Kadar koli se sproži namen, bo na vaše spletno mesto poslal zahtevo POST z telesom zahteve, ki vsebuje objekt JSON s trenutno lokacijo uporabnika

6. Kliknite Shrani.
7. Zdaj smo pripravljeni na ustvarjanje naše spletne storitve, vendar se pred tem prepričajmo, da nas naša akcija ustrezno sprejme.

9. korak: Namen dobrodošlice

Za prilagoditev uporabniške izkušnje bi morali ustvariti ustrezen pozdrav za nas, kadar koli sprožimo svoje dejanje.

1. Pojdite na "Namere" in nato kliknite na "Privzeti namen dobrodošlice".
2. Pomaknite se navzdol do »Odzivi«, odstranite obstoječe in vnesite, kaj želite, da vaše dejanje pozdravi, ko se začne.
3. Kliknite "Shrani".

10. korak: Vaša spletna storitev Python

Naredimo hiter in umazan strežnik Python s pomočjo Flaska. Za ta korak ni posnetkov zaslona, vendar bi morali biti precej naravnost.

1. Odprite nov zavihek in ustvarite račun na pythonanywhere.com
2. Preverite svoj e -poštni naslov.
3. Spletno aplikacijo nastavite s klikom na "Odpri spletni zavihek".
4. Kliknite "Dodaj novo spletno aplikacijo" in izberite "Flask" kot svoj spletni okvir Python.
5. Izberite Python 3.6 in kliknite "Naprej".
6. Izberite pot, po kateri želite, da prebiva vaša "flask_app.py". Postavil sem jo neposredno v domačo mapo kot "/home/your-username/flask_app.py".
7. Vrnite se na glavno stran s klikom na logotip Python v zgornjem levem kotu.
8. Pod datotekami kliknite "flask_app.py", da ga začnete urejati.
9. Ko se odpre urejevalnik spletnega besedila, prilepite naslednjo kodo in kliknite »Shrani«. Splošna zamisel je, da bo naš strežnik glede na razčlenjeni JSON, ki prihaja iz Pomočnika Google, izvedel dejanje (npr. Branje ali pisanje) in ga poročal kot odgovor /izpolnitev, ki jo je treba prebrati uporabniku.
10. Ponovno kliknite »Odpri spletni zavihek« in nato zeleni gumb »Ponovno naloži«.
11. Doslej bi morali imeti svoj spletni strežnik Python, ki deluje na naslovu "https://your-username.pythonanywhere.com/departures".

11. korak: Preizkusite svoje dejanje

V redu, do zdaj ste že precej končali. Preizkusimo zdaj celoten sklad in naj ta primer "Hello world" deluje!

1. V levi vrstici kliknite »Integracije«.
2. Pod možnostjo Google Assistant kliknite »Nastavitve integracije«.
3. Pri "Implicitno pozivanje dodajte ime svojega namena, to je" odhode ", tako da ga lahko sprožite neposredno tako, da izgovorite nekaj takega kot" Hej Google, pogovori se z mojim lokalnim načrtovalcem prometa o odhodih od doma ".
4. Omogoči spremembe »Samodejni predogled«.
5. Kliknite na "Test", ki odpre novo stran.
6. Vnesite "Pogovor z mojim lokalnim načrtovalcem prometa".
7. Priklicati je treba vaše dejanje, ki bi vas moralo pozdraviti z enim od predhodno nastavljenih odgovorov o nameri dobrodošlice.
8. Nato vnesite "Jaz sem v službi". Obrniti se morate na vaš strežnik Python in odgovor bo prebral Pomočnik Google.

Kul, kajne? Zdaj pa si predstavljajte, kaj lahko storite v interakciji s senzorji, aktuatorji in drugimi API -ji prek svojega Pomočnika Google.

12. korak: Sprostite svoje dejanje

Ko končate s preizkušanjem svojega dejanja in je v dobrem stanju, je čas, da ljubezen delite s svetom ali, če to ni smiselno, s prijatelji in družino.

1. Vrnite se na konzolo Actions in izberite dejanje lokalnega načrtovalca prometa.
2. Pri "Pripravite se na uvajanje" kliknite "Vnesite podatke, potrebne za uvrstitev vašega dejanja v imenik dejanj".
3. Vnesite kratek opis, daljši opis, majhen logotip, svoje kontaktne podatke, povezavo do pravilnika o zasebnosti (če tega ne nameravate deliti javno, samo vnesite povezavo do svojega spletnega mesta ali kaj podobnega) in kategorijo.
4. Pomaknite se navzgor in kliknite »Shrani«.
5. V levi vrstici kliknite možnost »Sprosti«.
6. Tu lahko izberete, v kakšnem stanju je vaše dejanje. Če ne želite slišati odgovora "Pridobimo preskusno različico Mojega lokalnega načrtovalca prometa", morate narediti popolno javno objavo. Vendar to zahteva Googlov pregled in ne bo obravnavano v tej vadnici. Namesto tega lahko to še vedno delite z največ 20 ljudmi, tako da izberete izdajo Alpha in jih dodate kot preizkuševalce Alpha.
7. Dodajte preizkuševalce alfa, tako da jim pošljete povezavo ali dodate njihova e -poštna sporočila.
8. Kliknite na "POŠLJI ZA ALPHO", označite polja, kliknite "POŠLJI" in končali ste!

Zdaj je vaša akcija v živo in do nje lahko dostopate vi in vaši prijatelji. Zabavaj se!

Če vas zanima koda, ki sem jo uporabil, si oglejte projekt na GitHubu.