Google'i assistendi jaoks kohandatud toimingute loomine: 12 sammu

2024 Autor: John Day | [email protected]. Viimati modifitseeritud: 2024-01-30 08:47

Nähes Google'i assistendi potentsiaali nii, nagu seda Google I/O 18 -s esitleti, kui ka Volvo Carsi teabe- ja meelelahutussüsteemis, ei suutnud ma proovida. Kasutasin ühte oma vanemat projekti, VasttraPi, ja ühendasin selle Google'i assistendiga. Kui soovite projekti kohta rohkem lugeda, oleks mul hea meel, kui heidaksite pilgu minu blogi seotud artiklile: Google'i assistendi kohandatud toimingud.

Selles juhendis käsitleme vajalikke samme, et käivitada oma Google'i assistendi tegevus, mis suhtleb teie serveriga ja räägib teiega tagasi, loetledes eelseisvad väljumised. Pidage meeles, et me ei kavatse SDK -d kasutada, kuna käitame seda täielikult Google'i assistendi, mitte oma seadme sees. Üldiselt jääb see lihtsaks. Teie toimingut saab kasutada seadmetes, mis toetavad Google'i assistenti (nt telefonid, tahvelarvutid, koduabilised ja kantavad seadmed) ning saate seda isegi jagada Play poe rakendusega!

Üks sellise asja loomise peamisi eeliseid selliste teenuste nagu IFTTT kasutamisel on see, et saate oma serveris luua kohandatud vastuseid, mida Google Assistant loeb. IFTTT-s on minu jaoks suhtlus ühesuunaline.

Käsitletakse järgmisi teemasid:

• Oma esimese tegevusprojekti loomine
• Kohandatud kavatsuse loomine
• Kohandatud olemi loomine
• Veebikonksu seadistamine toimingu täitmiseks
• Lihtsa REST -serveri seadistamine, mis on kirjutatud Pythonis koos Flaskiga, mis pakub vastuseid või "täitmist"
• Tegevusprojekti testimine
• Oma tegevusprojekti vabastamine

Siit ei leia palju üksikasju ega teooriat Google'i assistendi erinevate funktsioonide ja kontseptsioonide kohta. Kui olete neist huvitatud, soovitan teil tungivalt järgida ametlikku õpetust või vaadata seda videot.

1. toiming: määrake oma Google'i konto load

Enne alustamist peame veenduma, et Google'i assistendil on asjakohased õigused.

1. Minge jaotisse Tegevuse juhtelemendid

2. Veenduge, et järgmised funktsioonid oleksid lubatud:

   1. Veebi- ja rakendustegevus
   2. Seadme teave
   3. Hääle- ja helitegevus

Samm: looge oma tegevus

1. Minge Actions Console'i ja klõpsake "Lisa/impordi projekt"
2. Nimetagem seda tegevuste projekti "kohaliku liikluse planeerijaks".
3. Klõpsake "Loo projekt".
4. Järgmisel lehel ärge valige kategooriat ja klõpsake "Jäta vahele".
5. Nüüd peaksite olema tegevuste konsooli põhilehel.

3. toiming: toimingukutse

Määrake, kuidas soovite Google'i assistendi oma tegevuse alustamiseks käivitada.

1. Klõpsake jaotises "Kiire seadistamine" nuppu "Otsustage, kuidas teie toimingut käivitatakse".
2. Helistage sellele "Minu kohalik liikluse planeerija" ja klõpsake "Salvesta".

3. Klõpsake käsku „UUENDA PROOVI KUTSUMISED”, mis ilmnes pärast salvestamise klõpsamist.

   Selle valiku leiate ka jaotisest "Kataloogiteave"

4. Lisage uueks kutseks "Küsi minu kohalikult liiklusplaneerijalt" ja klõpsake "Salvesta".

Samm: lisage oma esimene toiming

1. Klõpsake vasakpoolsel ribal nuppu "Toimingud".
2. Klõpsake nuppu "LISA ESIMENE TOIMING".
3. Valige "Kohandatud kavatsus" ja seejärel klõpsake "Ehita".
4. Teid suunatakse lehele Dialogflow, kus rakendate peamist loogikat.

5. samm: koolituslaused teie kavatsuste jaoks

1. Valige oma ajavöönd ja klõpsake "Loo".
2. Jätke järgmisel lehel olemasolevad kavatsused ja klõpsake nuppu "LOE KAVA".
3. Andke kavatsusele mõistlik nimi, st "lahkumised".
4. Minge jaotisse "Treeninglaused" ja klõpsake "Lisa treeningfraasid".

5. Kasutage oma mudeli koolitamiseks järgmisi fraase, et see saaks teie öeldut tõlgendada:

   1. Ma olen praegu kodus
   2. Esialgu olen kodus
   3. Olen hetkel meie korteris
   4. Ma istun kodus
   5. Praegu olen töö lähedal
   6. ma olen tööl
   7. Ma olen kontoris
   8. Töö
   9. Kodu

6. samm: olemid

Nüüd olete määranud, mida tuleks sisendina enam -vähem oodata, peame määratlema, millised sisendi osad on meie äriloogikale huvipakkuvad, et neid saaks meie serverisse eraldada ja esile tõsta. Meie puhul tahame teada, kas kasutaja on kodus või tööl, et saaksime vastata konkreetse jaama väljumistega. Vaatame, kuidas seda teha saame.

1. Kui te topeltklõpsate ühel või mitmel koolitusfraasi sõnal, saate eelnevalt määratletud olemite loendi. Igaühe kohta saate lugeda siit. Üldiselt oleks kõige sobivam @sys.location, kuid minu arvates on kõige parem ja lihtsam, kui loome oma olemi, mida peaksime nimetama @current-location.
2. Klõpsake vasakul küljel valikut "Olemid".
3. Klõpsake nuppu "LOO ENTITY".

4. Määrake nimeks "praegune asukoht" ja määratlege kaks võrdlusväärtust koos nende sünonüümidega:

   1. Kodu

      kodu, maja, korter, võrevoodi

   2. tööd

      töö, kontor, Aptiv, koodikaevandused (lol lihtsalt teeb nalja)

5. Klikkige nupul „Salvesta. Täiendava efekti saavutamiseks võite klõpsata ka nupul„ Luba automaatne laiendamine”, et anda Google'i assistendile täiendavaid õigusi proovida võrdlusväärtustega rohkem sünonüüme sobitada.

Samm: toiming ja parameetrid

Aeg anda treeningfraasides sisalduvatele märksõnadele teatud tähendus.

1. Kui olete minu nime soovitusi järginud, klõpsake "Kavatsused" ja navigeerige oma kohandatud kavatsusele, st "väljumistele".
2. Kerige alla jaotiseni „Treeninglaused”.
3. Topeltklõpsake sõnadel, mis näitavad teie praegust asukohta, ja valige hüpikaknast silt @praegune asukoht.
4. Kerige alla jaotiseni "Toimingud ja parameetrid", klõpsake nuppu "Halda"
5. Kui kõik tehti õigesti, näete oma uut olemit seal loetletud.
6. Märkige ruut "Nõutav", mis kuvab uue veeru "Viipad". Viip on see, mida kasutaja kuuleb, kui midagi, mis vastab ootustele, pole esitatud.
7. Klõpsake "Määra viipasid" ja sisestage näiteks "Ma ei saanud teie asukohast aru. Kus te praegu olete?".

8. samm: täitmine

Nüüd on aeg ühendada oma veebiteenus Google'i assistendi tegevusega. Konksule helistatakse, kui see konkreetne kavatsus käivitatakse ja see peaks selle toimingu täitma. Enne seda tahame ka seada eesmärgi lõpetada tegevus pärast selle täitmist.

1. Minge jaotisse "Vastused" ja klõpsake nuppu "LISA VASTUS".
2. Ärge lisage ühtegi vastust, lubage lihtsalt „Määra see kavatsus vestluse lõpetamiseks”.
3. Kerige alla jaotiseni "Täitmine", klõpsake "LUBA TÄITMINE" ja seejärel lülitage sisse "Luba selle eesmärgi jaoks veebihaakukutse".
4. Klõpsake nuppu "Salvesta" ja minge vasakpoolsesse valikusse "Täitmine".

5. Lubage suvand „Webhook” ja sisestage URL, mida teie veebiserver „kuulab”.

   Kui kavatsus käivitatakse, saadab see teie veebisaidile POST -päringu koos päringu sisuga, mis sisaldab JSON -objekti kasutaja praeguse asukohaga

6. Klõpsake nuppu Salvesta.
7. Nüüd oleme valmis oma veebiteenust looma, kuid enne seda veendugem, et meie tegevus tervitaks meid nõuetekohaselt.

9. samm: Tere tulemast kavatsus

Kasutajakogemuse kohandamiseks peaksime looma meile sobiva tervituse iga kord, kui me oma tegevuse käivitame.

1. Minge jaotisse "Intents" ja seejärel "Default Welcome Intent".
2. Kerige alla jaotiseni „Vastused”, eemaldage olemasolevad ja sisestage soovitud toiming, kuidas teid pärast algatamist tervitada.
3. Klõpsake "Salvesta".

Samm: teie Pythoni veebiteenus

Teeme Flaski abil kiire ja räpase Pythoni serveri. Selle sammu jaoks pole ekraanipilte, kuid see peaks olema üsna sirgjooneline.

1. Avage uus vaheleht ja looge konto saidil pythonanywhere.com
2. Kinnitage oma e -posti aadress.
3. Seadistage oma veebirakendus, klõpsates nuppu "Ava veebikaart".
4. Klõpsake "Lisa uus veebirakendus" ja valige oma Pythoni veebiraamistikuks "Kolb".
5. Valige Python 3.6 ja klõpsake nuppu "Järgmine".
6. Valige tee, kus soovite oma "flask_app.py" asuda. Asetasin selle otse oma kodukataloogi nimega "/home/your-username/flask_app.py".
7. Minge tagasi avalehele, klõpsates vasakus ülanurgas Pythoni logo.
8. Failide all muutmise alustamiseks klõpsake "flask_app.py".
9. Kui veebitekstiredaktor avaneb, kleepige järgmine kood ja klõpsake nuppu "Salvesta". Üldine idee on see, et sõltuvalt Google Asssistantist pärinevast parsitud JSON -st täidab meie server toimingu (nt loeb või kirjutab) ja teatab sellest vastusena /täitmine, mis tuleks kasutajale ette lugeda.
10. Klõpsake uuesti nuppu "Ava veebikaart" ja seejärel rohelist nuppu "Laadi uuesti".
11. Nüüdseks peaks teil olema oma Pythoni veebiserver, mis töötab aadressil "https://your-username.pythonanywhere.com/departures".

Samm: testige oma tegevust

Okei, sa oled praeguseks peaaegu valmis. Proovime nüüd kogu virna ja paneme selle "Tere maailm" näite tööle!

1. Klõpsake vasakpoolsel ribal nuppu "Integratsioonid".
2. Klõpsake Google'i assistendi valiku all valikul "Integratsiooniseaded".
3. Lisage jaotisse „Kaudne kutsumine” oma kavatsuse nimi, st „väljumised”, et seda saaks käivitada otse, öeldes midagi sellist, nagu „Hei Google, räägi minu kohaliku liiklusplaneerijaga kodust väljumiste kohta”.
4. Luba muudatuste automaatne eelvaade.
5. Klõpsake nuppu "Test", mis avab uue lehe.
6. Tippige „Räägi minu kohaliku liikluse planeerijaga”.
7. Teie tegevusele tuleks tugineda, mis peaks teid tervitama ühe eelnevalt seatud tervitamise kavatsusega vastusega.
8. Seejärel tippige "Olen tööl". Võtke ühendust oma Pythoni serveriga ja Google'i assistent loeb vastuse.

Lahe kas pole? Kujutage nüüd ette, mida saate teha Google'i assistendi kaudu andurite, ajamite ja muude API -dega suheldes.

12. samm: vabastage oma tegevus

Kui olete oma tegevuse testimise lõpetanud ja see on heas seisus, on aeg jagada armastust kogu maailmaga või, kui see pole mõtet, oma sõprade ja perega.

1. Minge tagasi oma toimingukonsooli ja valige kohalik liikluse planeerija toiming.
2. Jaotises „Ettevalmistuseks kasutuselevõtuks“klõpsake nuppu „Sisestage teave, mis on vajalik teie toimingute loetlemiseks toimingute kataloogis“.
3. Sisestage lühikirjeldus, pikem kirjeldus, väike logo, oma kontaktandmed, privaatsuspoliitika link (kui te ei kavatse seda avalikult jagada, pange lihtsalt link oma veebisaidile või midagi) ja kategooria.
4. Kerige üles ja klõpsake nuppu "Salvesta".
5. Klõpsake vasakpoolsel külgribal valikut "Vabasta".
6. Siin saate valida, millises olekus teie tegevus on. Kui te ei soovi kuulda vastust „Saame minu kohaliku liiklusplaneerija testversiooni”, peate tegema täieliku avaliku väljaande. Kuid see nõuab Google'i läbivaatamist ja seda käesolevas õpetuses ei käsitleta. Selle asemel saate seda siiski jagada kuni 20 inimesega, valides alfaversiooni ja lisades need alfa -testritena.
7. Lisage kõik alfa -testijad, saates neile lingi või lisades nende e -kirjad.
8. Klõpsake "ESITA ALFALE", märkige ruudud, klõpsake "ESITA" ja olete valmis!

Nüüd on teie tegevus reaalajas ja teile ja teie sõpradele on juurdepääs. Lõbutse hästi!

Kui olete huvitatud koodist, mida kasutasin, vaadake projekti GitHubis.