Skep pasgemaakte aksies vir Google Assistant: 12 stappe

2024 Outeur: John Day | [email protected]. Laas verander: 2024-01-30 07:25

Aangesien die potensiaal van Google Assistant soos dit in Google I/O 18 sowel as Volvo Cars in hul infotainmentstelsel aangebied word, kon ek nie weerstaan om dit te probeer nie. Ek het een van my ouer projekte, VasttraPi, hergebruik en dit met Google Assistant verbind. As u meer oor die projek wil lees, sal ek baie bly wees as u na die verwante artikel op my blog kyk: Aangepaste aksies vir Google Assistant.

In hierdie instruksies gaan ons oor die stappe wat nodig is om u eie Google Assistant -aksie te begin, wat met u bediener sal kommunikeer en met u sal praat, met die komende vertrekke. Hou in gedagte dat ons die SDK nie gaan gebruik nie, aangesien ons dit heeltemal in Google Assistant bedryf en nie ons eie toestel nie. In die algemeen word dit eenvoudig gehou. U aksie sal bruikbaar wees op toestelle wat Google Assistant ondersteun, soos telefone, tablette, huisassistente en draagbare items, en u kan dit selfs deel soos met 'n app in die Play Store!

Een van die belangrikste voordele van die skep van so iets bo die gebruik van dienste soos IFTTT, is dat u persoonlike antwoorde op u bediener kan skep wat deur Google Assistant gelees sal word. In IFTTT is die kommunikasie wat my betref eenrigting.

Die volgende onderwerpe sal behandel word:

• Skep u eerste aksieprojek
• Skep u persoonlike voorneme
• Skep u persoonlike entiteit
• Stel 'n webhook in om u aksie te vervul
• Die opstel van 'n eenvoudige REST -bediener, geskryf in Python met Flask, wat die antwoorde of 'vervulling' bied
• Toets u aksieprojek
• Stel u aksieprojek vry

Hier vind u nie baie besonderhede of teorie oor die verskillende funksies en konsepte van Google Assistant nie. As u daarin belangstel, stel ek sterk voor dat u die amptelike handleiding volg of na hierdie video kyk.

Stap 1: Stel u Google -rekeningtoestemmings in

Voordat ons begin, moet ons seker maak dat Google Assistant die regte toestemmings het.

1. Gaan na aktiwiteitskontroles

2. Maak seker dat die volgende aangeskakel is:

   1. Web- en programaktiwiteit
   2. Toestelinligting
   3. Stem- en klankaktiwiteit

Stap 2: Skep u aksie

1. Gaan na Actions Console en klik op "Voeg/invoer projek"
2. Kom ons noem hierdie Actions-projek 'plaaslike-verkeersbeplanner'.
3. Klik op "Skep projek".
4. Kies nie 'n kategorie op die volgende bladsy nie en klik op "Slaan oor".
5. U behoort nou op die hoof Actions Console -bladsy te wees.

Stap 3: Aksie -aanroeping

Bepaal hoe u Google Assistant wil aktiveer om met u aksie te begin.

1. Klik op "Besluit hoe u aksie ingeroep moet word" onder "Vinnige opstelling".
2. Noem dit "My plaaslike verkeersbeplanner" en klik op "Stoor".

3. Klik op die "UPDATE SAMPLE INVOCATIONS" -opdrag wat verskyn het nadat u op stoor geklik het.

   U kan hierdie opsie ook vind onder "Gidsinligting"

4. Voeg 'Vra my plaaslike verkeersbeplanner' by as 'n nuwe oproep en klik op 'Stoor'.

Stap 4: Voeg u eerste aksie by

1. Klik op "Actions" in die linkerbalk.
2. Klik op "Voeg u eerste aksie by".
3. Kies 'Aangepaste bedoeling' en klik dan op 'Bou'.
4. U word na die Dialogflow -bladsy geneem, waar u die hooflogika sal implementeer.

Stap 5: Opleidingsfrases vir u voorneme

1. Kies u tydsone en klik op "Skep".
2. Laat die bestaande voornemens op die volgende bladsy staan en klik op "SKEP VOORWERP".
3. Gee die bedoeling 'n redelike naam, dit wil sê "vertrek".
4. Gaan na "Opleidingsfrases" en klik op "Voeg opleidingsfrases by".

5. Gebruik die volgende frases om u model op te lei, sodat dit kan interpreteer wat u dit vertel:

   1. Ek is nou tuis
   2. Ek is voorlopig tuis
   3. Ek is tans by ons woonstel
   4. Ek sit by die huis
   5. Tans is ek naby die werk
   6. ek is by die werk
   7. Ek is op kantoor
   8. Werk
   9. Tuis

Stap 6: Entiteite

Noudat u gespesifiseer het wat min of meer as 'n inset verwag moet word, moet ons definieer watter dele van die insette vir ons sakelogika van belang is, sodat dit aan ons bediener gehaal en uitgelig kan word. In ons geval wil ons weet of die gebruiker tuis of by die werk is, sodat ons terug kan reageer met die vertrek vanaf die spesifieke stasie. Kom ons kyk hoe ons dit kan doen.

1. As u dubbelkliek op een of meer woorde van die opleidingsfrases, kry u 'n lys van vooraf gedefinieerde entiteite. U kan hier meer lees oor elkeen van hulle. In die algemeen is die mees geskikte een @sys.location, maar ek dink dit is die beste en maklikste as ons ons eie entiteit skep wat ons moet noem @current-location.
2. Klik op die opsie "entiteite" aan die linkerkant.
3. Klik op "CREATE ENTITY".

4. Stel die naam op "huidige ligging" en definieer twee verwysingswaardes saam met die sinonieme daarvan:

   1. huis

      huis, huis, woonstel, krip

   2. werk

      werk, kantoor, Aptiv, kode myne (lol net 'n grap)

5. Klik op "Stoor. Vir 'n ekstra effek kan u ook klik op" Laat outomatiese uitbreiding toe "om Google Assistant meer vryhede te gee om meer sinonieme met u verwysingswaardes te pas.

Stap 7: Aksie en parameters

Tyd om die sleutelwoorde in u opleidingsfrases betekenis te gee.

1. Klik op "Voornemens" en navigeer dan na u aangepaste voorneme, dws "vertrek" as u my naamvoorstelle gevolg het.
2. Rol af na "Opleidingsfrases".
3. Dubbelklik op die woorde wat u huidige ligging aandui en kies die @huidige ligging-etiket in die opspringvenster.
4. Rol af na "Aksies en parameters", klik op "bestuur"
5. As alles reg gedoen is, sal u nuwe entiteit daar verskyn.
6. Merk die kassie "Vereis", wat 'n nuwe kolom "Aanwysings" laat verskyn. Aanwysings is wat die gebruiker sal hoor as niks wat aan die verwagting voldoen, verskaf is nie.
7. Klik op "Definieer aanwysings" en voeg iets in soos "Ek het nie u ligging verstaan nie. Waar is u op die oomblik?".

Stap 8: Vervulling

Dit is nou tyd om u webdiens aan die Google Assistant -aksie te koppel. U haak sal gebel word wanneer hierdie spesifieke bedoeling geaktiveer word en die vervulling van hierdie aksie moet veroorsaak. Daarvoor wil ons ook ons voorneme stel om die aksie te voltooi nadat dit vervul is.

1. Gaan na "Antwoorde" en klik op "ADD RESPONSE".
2. Moenie antwoorde byvoeg nie, aktiveer net 'Stel hierdie bedoeling as einde van die gesprek' in.
3. Rollees af na "Vervulling", klik op "GELEENTHEID INSKAKEL" en skakel dan die "Aktiveer oproep vir webhook vir hierdie bedoeling" aan.
4. Klik op "Stoor" en gaan dan na die opsie "Vervulling" aan die linkerkant.

5. Aktiveer die opsie "Webhook" en voeg die URL in wat deur u webbediener "geluister" word.

   Elke keer as die bedoeling geaktiveer word, stuur dit 'n POST -versoek na u webwerf met die hoofkant van die versoek met 'n JSON -voorwerp met die huidige ligging van die gebruiker

6. Klik op Stoor.
7. Nou is ons gereed om ons webdiens te skep, maar laat ons eers seker maak dat ons aksie ons op die regte manier verwelkom.

Stap 9: Welkom voorneme

Om die gebruikerservaring aan te pas, moet ons 'n gepaste groet vir ons skep wanneer ons ons aksie aktiveer.

1. Gaan na "Intents" en klik dan op "Default Welcome Intent".
2. Blaai af na "Antwoorde", verwyder die bestaande en voeg by wat u wil hê, en hoe u u kan verwelkom sodra dit begin is.
3. Klik op "Save".

Stap 10: U Python -webdiens

Kom ons maak 'n vinnige en vuil Python -bediener met behulp van Flask. Geen skermkiekies vir hierdie stap nie, maar dit moet redelik eenvoudig wees.

1. Maak 'n nuwe oortjie oop en skep 'n rekening op pythonanywhere.com
2. Verifieer u e -posadres.
3. Stel u webtoepassing op deur op "Webblad oop te maak".
4. Klik op 'Voeg 'n nuwe webapp by' en kies 'Flask' as u Python -webraamwerk.
5. Kies Python 3.6 en klik op "Volgende".
6. Kies die pad waarop u 'flask_app.py' wil woon. Ek het dit direk in my tuisgids geplaas as '/home/your-username/flask_app.py'.
7. Gaan terug na die hoofblad deur op die Python -logo in die linker boonste hoek te klik.
8. Onder lêers, klik op "flask_app.py" om dit te begin redigeer.
9. As die webteksredakteur oopmaak, plak die volgende kode en klik op "Stoor". Die algemene idee is dat ons bediener 'n aksie sal uitvoer (bv. Lees of skryf), afhangende van die ontleedde JSON wat van Google Asssistant afkomstig is. /vervulling wat aan die gebruiker voorgelees moet word.
10. Klik weer op 'Open webtab' en dan op die groen 'Herlaai -knoppie'.
11. Teen hierdie tyd behoort u u eie Python-webbediener te hê op "https://your-username.pythonanywhere.com/departures".

Stap 11: Toets u aksie

OK, nou is jy amper klaar. Kom ons toets die hele stapel nou en laat hierdie 'Hallo wêreld' -voorbeeld werk!

1. Klik op "Integrasies" in die balk aan die linkerkant.
2. Klik op "Integrasie -instellings" onder die opsie Google Assistant.
3. Onder "Implisiete oproep", voeg die naam van u voorneme by, dit wil sê "vertrek", sodat dit direk geaktiveer kan word deur iets soos "Hey Google, praat met my plaaslike verkeersbeplanner oor vertrek van die huis af".
4. Aktiveer "Outo-voorskou" -veranderings.
5. Klik op "toets" wat 'n nuwe bladsy oopmaak.
6. Tik 'Praat met my plaaslike verkeersbeplanner'.
7. U moet u optrede beroep, wat u moet verwelkom met een van die voorheen ingestelde reaksies met welkome bedoeling.
8. Tik dan "Ek is by die werk". U moet met u Python -bediener gekontak word en die antwoord sal deur Google Assistant gelees word.

Cool is dit nie? Stel u nou voor wat u met u Google Assistant kan doen met sensore, aktuators en ander API's.

Stap 12: Laat u aksie vry

Nadat u u aksie getoets het en dit in 'n goeie toestand is, is dit tyd om die liefde met die wêreld te deel, of as dit nie sin maak nie, met u vriende en familie.

1. Gaan terug na u Actions -konsole en kies die optrede van u plaaslike verkeersbeplanner.
2. Onder "Maak gereed vir implementering", klik op "Voer inligting in wat nodig is om u aksie in die Actions -gids op te neem".
3. Voer 'n kort beskrywing, 'n langer beskrywing, 'n klein logo, u kontakbesonderhede, 'n skakel na 'n privaatheidsbeleid in (as u dit nie in die openbaar wil deel nie, plaas 'n skakel na u webwerf of iets) en 'n kategorie.
4. Rol op en klik op "Stoor".
5. Klik op die opsie "Los" in die linkerbalk.
6. Hier kan u kies in watter toestand u aksie is. As u nie die reaksie 'Kom ons kry die toetsweergawe van My plaaslike verkeersbeplanner' wil hoor nie, moet u 'n volwaardige openbare bekendmaking maak. Dit verg egter 'n hersiening deur Google en sal nie in hierdie tutoriaal behandel word nie. In plaas daarvan kan u dit steeds met tot 20 mense deel deur 'n Alpha -weergawe te kies en dit as Alpha -testers by te voeg.
7. Voeg alfa -toetsers by deur 'n skakel aan hulle te stuur of hul e -posse by te voeg.
8. Klik op "SEND IN VIR ALPHA", merk die blokkies, klik op "SEND IN" en u is klaar!

Nou is u aksie lewendig en kan u en u vriende toegang daartoe kry. Hê pret!

As u belangstel in die kode wat ek gebruik het, kyk dan na die projek op GitHub.