Luo mukautettuja toimintoja Google Assistantille: 12 vaihetta

2024 Kirjoittaja: John Day | [email protected]. Viimeksi muokattu: 2024-01-30 09:01

Nähdessäni Google Assistantin potentiaalin sellaisena kuin se esiteltiin Google I/O 18: ssa sekä Volvo Carsin infotainment -järjestelmässä, en voinut olla kokeilematta sitä. Käytin uudelleen yhtä vanhemmista projekteistani, VasttraPi, ja liitin sen Google Assistantiin. Jos haluat lukea lisää projektista, olisin iloinen, jos vilkaisisit aiheeseen liittyvää artikkelia blogissani: Google Assistantin mukautetut toiminnot.

Tässä opetusohjelmassa käymme läpi tarvittavat vaiheet, jotta voimme käynnistää oman Google Assistant -toiminnon, joka kommunikoi palvelimesi kanssa ja puhuu sinulle ja luettelee tulevat lähdöt. Muista, että emme aio käyttää SDK: ta, koska käytämme tätä täysin Google Assistantissa, emme omassa laitteessamme. Kaiken kaikkiaan se pidetään yksinkertaisena. Toimintoasi voidaan käyttää laitteilla, jotka tukevat Google Assistantia, kuten puhelimilla, tableteilla, kodin avustajilla ja puettavilla laitteilla, ja voit jopa jakaa sen samalla tavalla kuin Play Kaupan sovelluksella!

Yksi tällaisen luomisen tärkeimmistä eduista verrattuna IFTTT: n kaltaisiin palveluihin on, että voit luoda palvelimellesi mukautettuja vastauksia, jotka Google Assistant lukee. IFTTT: ssä viestintä on minun mielestäni yksisuuntaista.

Seuraavia aiheita käsitellään:

• Ensimmäisen toimintaprojektin luominen
• Mukautetun aikomuksen luominen
• Mukautetun kokonaisuuden luominen
• Webhookin asettaminen toiminnon suorittamiseksi
• Perustetaan yksinkertainen REST -palvelin, joka on kirjoitettu Pythonissa Flaskilla ja joka tarjoaa vastaukset tai "täyttymyksen"
• Toimintaprojektisi testaaminen
• Toimintaprojektisi julkaiseminen

Täältä ei löydy monia yksityiskohtia tai teoriaa Google Assistantin eri toiminnoista ja konsepteista. Jos olet kiinnostunut niistä, suosittelen sinua seuraamaan virallista opetusohjelmaa tai katsomaan tämän videon.

Vaihe 1: Määritä Google -tilisi käyttöoikeudet

Ennen kuin aloitamme, meidän on varmistettava, että Google Assistantilla on asianmukaiset käyttöoikeudet.

1. Siirry toimintojen hallintaan

2. Varmista, että seuraavat toiminnot ovat käytössä:

   1. Verkko- ja sovellustoiminta
   2. Laitteen informaatio
   3. Ääni- ja äänitoiminta

Vaihe 2: Luo toiminto

1. Siirry Actions Consoleen ja napsauta "Lisää/tuo projekti"
2. Kutsutaan tätä toimintaprojektia "paikallisliikenteen suunnittelijaksi".
3. Napsauta "Luo projekti".
4. Älä valitse seuraavalla sivulla luokkaa ja napsauta "Ohita".
5. Sinun pitäisi olla Actions Console -pääsivulla nyt.

Vaihe 3: Toiminnan kutsuminen

Määritä, miten haluat käynnistää Google Assistantin aloittamaan toimintasi.

1. Napsauta Pika -asetukset -kohdassa "Päätä, miten toimintoasi kutsutaan".
2. Kutsu sitä "Oma paikallinen liikenteen suunnittelija" ja napsauta "Tallenna".

3. Napsauta "UPDATE SAMPLE INVOCATIONS" (Päivitä näytteen kutsut) -kehotetta, joka ilmestyi näyttöön tallentamisen jälkeen.

   Löydät tämän vaihtoehdon myös kohdasta "Hakemistotiedot"

4. Lisää "Kysy paikalliselta liikennesuunnittelijalta" uutena kutsuna ja napsauta "Tallenna".

Vaihe 4: Lisää ensimmäinen toiminto

1. Napsauta vasemmassa palkissa "Toiminnot".
2. Napsauta "LISÄÄ ENSIMMÄINEN TOIMINTA".
3. Valitse "Muokattu tarkoitus" ja napsauta sitten "Rakenna".
4. Sinut ohjataan Dialogflow -sivulle, jolla päälogiikka toteutetaan.

Vaihe 5: Koulutuslausekkeet tarkoitukseesi

1. Valitse aikavyöhyke ja napsauta "Luo".
2. Jätä seuraavalla sivulla olemassa olevat aikeet ja napsauta "LUO TAHTO".
3. Anna tarkoitukselle järkevä nimi, eli "lähdöt".
4. Siirry kohtaan "Koulutuslausekkeet" ja napsauta "Lisää koulutuslausekkeita".

5. Kouluta malliasi seuraavilla lauseilla, jotta se voi tulkita sen, mitä kerrot sille:

   1. Olen kotona juuri nyt
   2. Toistaiseksi olen kotona
   3. Olen tällä hetkellä asunnossamme
   4. Istun kotona
   5. Tällä hetkellä olen lähellä työtä
   6. olen töissä
   7. Olen toimistossa
   8. Työ
   9. Koti

Vaihe 6: Entiteetit

Nyt olet määrittänyt, mitä pitäisi enemmän tai vähemmän odottaa panoksena. Meidän on määriteltävä, mitkä syötteen osat kiinnostavat liiketoimintalogiikkaamme, jotta ne voidaan poimia ja korostaa palvelimellemme. Meidän tapauksessamme haluamme tietää, onko käyttäjä kotona vai töissä, jotta voimme vastata takaisin lähettämällä tietyltä asemalta. Katsotaanpa, kuinka voimme tehdä sen.

1. Jos kaksoisnapsautat yhtä tai useampaa harjoituslausekkeen sanaa, saat luettelon ennalta määritetyistä kokonaisuuksista, joista voit lukea lisää jokaisesta. Kaiken kaikkiaan sopivin olisi @sys.location, mutta mielestäni on parasta ja helpointa luoda oma kokonaisuus, jota meidän pitäisi kutsua @current-location.
2. Napsauta "Entities" -vaihtoehtoa vasemmalla puolella.
3. Napsauta "LUO YKSIKKÖ".

4. Aseta nimeksi "nykyinen sijainti" ja määritä kaksi viitearvoa ja niiden synonyymit:

   1. Koti

      koti, talo, huoneisto, pinnasänky

   2. työ

      työ, toimisto, Aptiv, koodikaivokset (lol vain vitsi)

5. Napsauta Tallenna. Saat lisätehosteen myös napsauttamalla Salli automaattinen laajennus, jolloin Google Assistant saa lisää vapauksia yrittää sovittaa lisää synonyymeja viitearvoihisi.

Vaihe 7: Toiminta ja parametrit

On aika antaa jonkinlainen merkitys koulutuslauseidesi avainsanoille.

1. Napsauta "Aikomukset" ja siirry sitten mukautettuun tarkoitukseen, eli "lähtöihin", jos olet seurannut nimiehdotuksiani.
2. Vieritä alas kohtaan "Koulutuslausekkeet".
3. Kaksoisnapsauta sanoja, jotka osoittavat nykyisen sijaintisi, ja valitse ponnahdusikkunasta @nykyinen sijainti -tagi.
4. Vieritä alas kohtaan Toiminnot ja parametrit, napsauta "hallitse"
5. Jos kaikki on tehty oikein, näet uuden entiteettisi luettelossa.
6. Valitse "Pakollinen" -ruutu, joka näyttää uuden sarakkeen "Kehotteet". Käyttäjä kuulee kehotteet, jos mitään odotuksia vastaavaa ei ole toimitettu.
7. Napsauta "Määritä kehotteet" ja lisää jotain "En ymmärtänyt sijaintiasi. Missä olet tällä hetkellä?".

Vaihe 8: Täyttö

Nyt on aika kytkeä verkkopalvelu Google Assistant -toimintoon. Koukullesi soitetaan, kun tämä erityinen tarkoitus laukaistaan, ja sen pitäisi tuottaa tämän toiminnon toteutuminen. Ennen sitä haluamme myös asettaa aikomuksemme lopettaa toimen toteutumisen jälkeen.

1. Siirry "Vastaukset" -kohtaan ja napsauta "LISÄÄ VASTAUS".
2. Älä lisää vastauksia, ota käyttöön "Aseta tämä tarkoitus keskustelun päätteeksi".
3. Vieritä alas kohtaan "Täyttö", napsauta "KÄYTÄ TÄYTÄNTÖ" ja ota sitten käyttöön Ota Webhook -puhelu käyttöön tätä tarkoitusta varten.
4. Napsauta "Tallenna" ja siirry sitten "Täyttö" -vaihtoehtoon vasemmalla puolella.

5. Ota Webhook -vaihtoehto käyttöön ja lisää URL -osoite, jota verkkopalvelimesi kuuntelee.

   Aina kun tarkoitus käynnistyy, se lähettää POST -pyynnön verkkosivustollesi, ja pyynnön runko sisältää JSON -objektin, jossa on käyttäjän nykyinen sijainti

6. Napsauta Tallenna.
7. Nyt olemme valmiita luomaan verkkopalvelumme, mutta ennen sitä varmistetaan, että toimintamme toivottaa meidät tervetulleiksi asianmukaisella tavalla.

Vaihe 9: Tervetuloa

Jotta voimme mukauttaa käyttökokemusta, meidän on luotava meille sopiva tervehdys aina, kun käynnistämme toimintamme.

1. Siirry kohtaan "Intents" ja napsauta sitten "Default Welcome Intent".
2. Vieritä alas "Vastaukset" -kohtaan, poista olemassa olevat ja lisää haluamasi toiminnot, joilla toivotamme sinut tervetulleiksi, kun se on aloitettu.
3. Napsauta "Tallenna".

Vaihe 10: Python -verkkopalvelu

Tehdään nopea ja likainen Python -palvelin Flaskin avulla. Tässä vaiheessa ei ole kuvakaappauksia, mutta sen pitäisi olla melko suoraviivainen.

1. Avaa uusi välilehti ja luo tili osoitteessa pythonanywhere.com
2. Vahvista sähköpostiosoitteesi.
3. Määritä verkkosovelluksesi napsauttamalla "Avaa web -välilehti".
4. Napsauta "Lisää uusi verkkosovellus" ja valitse "Pullo" Python -verkkokehykseesi.
5. Valitse Python 3.6 ja napsauta "Seuraava".
6. Valitse polku, jolla haluat "flask_app.py" -korttisi olevan. Sijoitin sen suoraan kotikansiooni nimellä "/home/your-username/flask_app.py".
7. Palaa pääsivulle napsauttamalla vasemmassa yläkulmassa olevaa Python -logoa.
8. Napsauta tiedostojen alla "flask_app.py" aloittaaksesi sen muokkaamisen.
9. Kun web -tekstieditori avautuu, liitä seuraava koodi ja napsauta "Tallenna". Yleisenä ajatuksena on, että palvelimemme suorittaa toiminnon (esim. Lukee tai kirjoittaa) ja raportoi sen vastauksena Google Asssistant -palvelun jäsennetystä jäsennetystä JSON -tiedostosta riippuen /täyttäminen, joka tulisi lukea käyttäjälle.
10. Napsauta "Avaa web -välilehti" uudelleen ja sitten vihreää "Lataa uudelleen" -painiketta.
11. Tähän mennessä sinulla pitäisi olla oma Python-verkkopalvelin käynnissä osoitteessa "https://your-username.pythonanywhere.com/departures".

Vaihe 11: Testaa toimintasi

Okei, olet jo melkein valmis. Kokeillaan nyt koko pino ja saat tämän "Hello world" -esimerkin toimimaan!

1. Napsauta "Integraatiot" vasemmasta sivupalkista.
2. Napsauta "Integraatioasetukset" Google Assistant -vaihtoehdon alla.
3. Lisää "Epäsuora kutsuminen" -kohtaan aikomuksesi nimi eli "lähdöt", jotta se voidaan laukaista suoraan sanomalla esimerkiksi "Hei Google, keskustele paikallisesta liikennesuunnittelijastani kotoa lähdöstä".
4. Ota käyttöön automaattisen esikatselun muutokset.
5. Napsauta "Testaa", joka avaa uuden sivun.
6. Kirjoita "Puhu paikalliselle liikenteen suunnittelijalle".
7. Toimintoosi on vedottava, ja sen pitäisi tervehtiä sinua jollakin aiemmin asetetuista tervetuloa -vastauksista.
8. Kirjoita sitten "Olen töissä". Ota yhteyttä Python -palvelimeesi ja Google Assistant lukee vastauksen.

Eikö olekin siistiä? Kuvittele nyt, mitä voit tehdä vuorovaikutuksessa antureiden, toimilaitteiden ja muiden sovellusliittymien kanssa Google Assistantin kautta.

Vaihe 12: Vapauta toiminto

Kun olet testannut toimintasi ja se on hyvässä kunnossa, on aika jakaa rakkaus maailmalle tai, jos se ei ole järkevää, ystävillesi ja perheellesi.

1. Palaa Actions -konsoliin ja valitse paikallinen liikenteen suunnittelutoiminto.
2. Napsauta "Valmistaudu käyttöönottoon" -kohdasta "Anna tarvittavat tiedot, jotta toimintasi voidaan lisätä Actions -hakemistoon".
3. Kirjoita lyhyt kuvaus, pidempi kuvaus, pieni logo, yhteystietosi, linkki tietosuojakäytäntöön (jos et aio jakaa tätä julkisesti, laita linkki verkkosivustollesi tai jotain) ja luokka.
4. Vieritä ylös ja napsauta "Tallenna".
5. Napsauta "Vapauta" -vaihtoehtoa vasemmasta sivupalkista.
6. Täällä voit valita toimintasi tilan. Jos et halua kuulla vastausta "Otetaan testiversio paikallisesta liikenteen suunnittelijasta", sinun on tehtävä täysimittainen julkinen julkaisu. Tämä edellyttää kuitenkin Googlen tarkistusta, eikä sitä käsitellä tässä opetusohjelmassa, vaan voit jakaa sen jopa 20 henkilön kanssa valitsemalla Alpha -julkaisun ja lisäämällä heidät Alpha -testaajiksi.
7. Lisää alfa -testaajia joko lähettämällä heille linkki tai lisäämällä heidän sähköpostinsa.
8. Napsauta "LÄHETÄ ALFAlle", valitse ruudut, napsauta "LÄHETÄ" ja olet valmis!

Toimintasi on nyt live -tilassa, ja sinä ja ystäväsi voivat käyttää sitä. Pidä hauskaa!

Jos olet kiinnostunut käyttämästäni koodista, katso projekti GitHubista.