Izveidojiet pielāgotas darbības Google asistentam: 12 soļi

2024 Autors: John Day | [email protected]. Pēdējoreiz modificēts: 2024-01-30 10:54

Redzot Google asistenta potenciālu, kāds tas tika parādīts Google I/O 18, kā arī Volvo Cars informācijas un izklaides sistēmā, es nevarēju pretoties tā izmēģināšanai. Es atkārtoti izmantoju vienu no saviem vecākiem projektiem - VasttraPi un sasaistīju to ar Google palīgu. Ja vēlaties uzzināt vairāk par projektu, es priecātos, ja apskatītu saistīto rakstu manā emuārā: Pielāgotas darbības Google asistentam.

Šajā pamācībā mēs veicam nepieciešamās darbības, lai sāktu savu Google asistenta darbību, kas sazināsies ar jūsu serveri un runās ar jums, norādot gaidāmos izlidošanas gadījumus. Ņemiet vērā, ka mēs neizmantosim SDK, jo mēs to pilnībā darbinām Google asistentā, nevis savā ierīcē. Kopumā tas tiks saglabāts vienkāršs. Jūsu darbība būs izmantojama ierīcēs, kas atbalsta Google palīgu, piemēram, tālruņos, planšetdatoros, mājas palīgos un valkājamos materiālos, un jūs pat varat to kopīgot, izmantojot Play veikala lietotni!

Viena no galvenajām priekšrocībām, radot kaut ko līdzīgu, salīdzinot ar tādu pakalpojumu izmantošanu kā IFTTT, ir tā, ka serverī varat izveidot pielāgotas atbildes, kuras lasīs Google palīgs. IFTTT komunikācija, manuprāt, ir vienvirziena.

Tiks apskatītas šādas tēmas:

• Izveidojiet savu pirmo darbības projektu
• Izveidojiet savu pielāgoto nodomu
• Izveido savu pielāgoto entītiju
• Tīmekļa āķa iestatīšana jūsu darbības veikšanai
• Vienkārša REST servera iestatīšana, kas rakstīts Python ar kolbu, kas sniegs atbildes vai "piepildījumu"
• Jūsu darbības projekta pārbaude
• Atbrīvojiet savu rīcības projektu

Šeit jūs neatradīsit daudz informācijas vai teoriju par dažādām Google palīga funkcijām un jēdzieniem. Ja jūs viņus interesē, es iesaku jums sekot oficiālajai apmācībai vai noskatīties šo videoklipu.

1. darbība. Iestatiet sava Google konta atļaujas

Pirms sākam, mums jāpārliecinās, vai Google palīgam ir atbilstošas atļaujas.

1. Dodieties uz Aktivitātes vadīklas

2. Pārliecinieties, vai ir iespējota tālāk norādītā informācija.

   1. Darbības tīmeklī un lietotnēs
   2. Informācija par ierīci
   3. Balss un audio darbības

2. darbība: izveidojiet savu darbību

1. Dodieties uz Actions Console un noklikšķiniet uz "Pievienot/importēt projektu"
2. Sauksim šo Darbību projektu par “vietējās satiksmes plānotāju”.
3. Noklikšķiniet uz "Izveidot projektu".
4. Nākamajā lapā neizvēlieties kategoriju un noklikšķiniet uz "Izlaist".
5. Tagad jums vajadzētu būt galvenajā Darbību konsoles lapā.

3. darbība: darbības izsaukšana

Nosakiet, kā vēlaties aktivizēt Google palīgu, lai sāktu darbību.

1. Noklikšķiniet uz "Izlemt, kā tiek izsaukta jūsu darbība" sadaļā "Ātrā iestatīšana".
2. Nosauciet to par “Mans vietējais satiksmes plānotājs” un noklikšķiniet uz “Saglabāt”.

3. Noklikšķiniet uz uzvednes "ATJAUNINĀT PARAUGU UZAICINĀJUMUS", kas parādījās pēc noklikšķināšanas uz Saglabāt.

   Šo opciju varat atrast arī sadaļā "Direktorija informācija"

4. Pievienojiet "Jautāt manam vietējam satiksmes plānotājam" kā jaunu aicinājumu un noklikšķiniet uz "Saglabāt".

4. darbība: pievienojiet savu pirmo darbību

1. Kreisajā joslā noklikšķiniet uz "Darbības".
2. Noklikšķiniet uz "PIEVIENOT PIRMO DARBĪBU".
3. Atlasiet “Pielāgots nolūks” un pēc tam noklikšķiniet uz “Veidot”.
4. Jūs tiksit novirzīts uz lapu Dialogflow, kurā tiks ieviesta galvenā loģika.

5. solis: apmācības frāzes jūsu nodomam

1. Izvēlieties savu laika joslu un noklikšķiniet uz "Izveidot".
2. Nākamajā lapā atstājiet esošos nodomus un noklikšķiniet uz "Izveidot nodomu".
3. Norādiet nodomam saprātīgu nosaukumu, t.i., "izlidošana".
4. Atveriet sadaļu "Apmācības frāzes" un noklikšķiniet uz "Pievienot apmācības frāzes".

5. Izmantojiet šādas frāzes, lai apmācītu savu modeli, lai tas varētu interpretēt jūsu teikto:

   1. Es šobrīd esmu mājās
   2. Pagaidām esmu mājās
   3. Šobrīd esmu mūsu dzīvoklī
   4. Es sēžu mājās
   5. Pašlaik esmu netālu no darba
   6. Es esmu darbā
   7. Es esmu birojā
   8. Darbs
   9. Mājas

6. darbība: entītijas

Tagad jūs esat norādījis, kas būtu vairāk vai mazāk jāgaida kā ievade, mums ir jādefinē, kuras ievades daļas interesē mūsu biznesa loģiku, lai tās varētu iegūt un izcelt mūsu serverī. Mūsu gadījumā mēs vēlamies uzzināt, vai lietotājs ir mājās vai darbā, lai mēs varētu atbildēt, norādot atiešanu no konkrētās stacijas. Apskatīsim, kā mēs to varam izdarīt.

1. Ja veicat dubultklikšķi uz viena vai vairākiem apmācības frāžu vārdiem, jūs iegūsit iepriekš definētu entītiju sarakstu. Plašāku informāciju par katru no tiem varat lasīt šeit. Kopumā vispiemērotākā būtu @sys.location, tomēr, manuprāt, vislabāk un vienkāršāk ir izveidot savu entītiju, kuru mums vajadzētu saukt par @current-location.
2. Kreisajā pusē noklikšķiniet uz opcijas "Entītijas".
3. Noklikšķiniet uz "IZVEIDOT ENTITY".

4. Iestatiet nosaukumu uz “pašreizējā atrašanās vieta” un definējiet divas atsauces vērtības kopā ar to sinonīmiem:

   1. mājas

      mājas, māja, dzīvoklis, gultiņa

   2. strādāt

      darbs, birojs, Aptiv, kodu raktuves (lol tikai joko)

5. Noklikšķiniet uz "Saglabāt. Lai iegūtu papildu efektu, varat arī noklikšķināt uz" Atļaut automātisku paplašināšanu ", lai Google palīgam piešķirtu papildu brīvību mēģināt saskaņot vairāk sinonīmu ar jūsu atsauces vērtībām.

7. darbība: darbība un parametri

Ir pienācis laiks piešķirt atslēgvārdiem nozīmi mācību frāzēs.

1. Noklikšķiniet uz "Nodomi" un pēc tam pārejiet uz savu pielāgoto nodomu, t.i., "izlidošanu", ja esat sekojis maniem vārda ieteikumiem.
2. Ritiniet uz leju līdz sadaļai “Apmācības frāzes”.
3. Veiciet dubultklikšķi uz vārdiem, kas norāda jūsu pašreizējo atrašanās vietu, un uznirstošajā logā izvēlieties tagu @current-location.
4. Ritiniet uz leju līdz "Darbības un parametri", noklikšķiniet uz "pārvaldīt"
5. Ja viss tika izdarīts pareizi, jūs redzēsit, ka jūsu jaunā vienība ir norādīta tur.
6. Atzīmējiet izvēles rūtiņu “Obligāti”, kurā tiek parādīta jauna sleja “Uzaicinājumi”. Lietotājs dzird uzvednes, ja nav sniegts nekas, kas atbilst gaidītajam.
7. Noklikšķiniet uz "Definēt uzvednes" un ievietojiet kaut ko līdzīgu "Es nesapratu jūsu atrašanās vietu. Kur jūs pašlaik atrodaties?".

8. solis: Izpilde

Tagad ir pienācis laiks saistīt savu tīmekļa pakalpojumu ar Google asistenta darbību. Jūsu āķis tiks izsaukts, kad tiks aktivizēts šis īpašais nodoms, un tam vajadzētu nodrošināt šīs darbības izpildi. Pirms tam mēs arī vēlamies noteikt savu nodomu pabeigt darbību pēc tās izpildes.

1. Dodieties uz "Atbildes" un noklikšķiniet uz "PIEVIENOT ATBILDI".
2. Nepievienojiet atbildes, vienkārši iespējojiet opciju “Iestatīt šo nodomu kā sarunas beigas”.
3. Ritiniet uz leju līdz sadaļai "Izpilde", noklikšķiniet uz "IESPĒJIET IZPILDĪŠANU" un pēc tam ieslēdziet opciju "Iespējot tīmekļa aizķeres zvanu šim nolūkam".
4. Noklikšķiniet uz "Saglabāt" un pēc tam pārejiet uz opciju "Izpilde" kreisajā pusē.

5. Iespējojiet opciju "Webhook" un ievietojiet URL, kuru jūsu tīmekļa serveris "klausās".

   Ikreiz, kad nodoms tiek aktivizēts, tas nosūtīs jūsu vietnei POST pieprasījumu ar pieprasījuma pamattekstu, kurā ir JSON objekts ar lietotāja pašreizējo atrašanās vietu

6. Noklikšķiniet uz Saglabāt.
7. Tagad mēs esam gatavi izveidot savu tīmekļa pakalpojumu, taču pirms tam pārliecināsimies, ka mūsu rīcība uzņem mūs pienācīgā veidā.

9. solis: sveicināšanas nodoms

Lai pielāgotu lietotāju pieredzi, mums ir jāizveido atbilstošs sveiciens ikreiz, kad sākam savu darbību.

1. Dodieties uz "Nodomi" un pēc tam noklikšķiniet uz "Noklusējuma sveiciena nodoms".
2. Ritiniet uz leju līdz sadaļai “Atbildes”, noņemiet esošās un ievietojiet, kā vēlaties, lai jūsu darbība jūs sveicinātu, tiklīdz tā tiks uzsākta.
3. Noklikšķiniet uz "Saglabāt".

10. darbība: jūsu Python tīmekļa pakalpojums

Izveidosim ātru un netīru Python serveri, izmantojot kolbu. Šim solim nav ekrānuzņēmumu, taču tam vajadzētu būt diezgan tiešam.

1. Atveriet jaunu cilni un izveidojiet kontu vietnē pythonanywhere.com
2. Apstipriniet savu e -pastu.
3. Iestatiet savu tīmekļa lietojumprogrammu, noklikšķinot uz "Atvērt tīmekļa cilni".
4. Noklikšķiniet uz "Pievienot jaunu tīmekļa lietotni" un kā Python tīmekļa ietvaru atlasiet "Kolba".
5. Atlasiet Python 3.6 un noklikšķiniet uz "Tālāk".
6. Izvēlieties ceļu, kurā vēlaties glabāt failu "flask_app.py". Es to ievietoju tieši mājas mapē kā "/home/your-username/flask_app.py".
7. Atgriezieties galvenajā lapā, noklikšķinot uz Python logotipa augšējā kreisajā stūrī.
8. Zem failiem noklikšķiniet uz "flask_app.py", lai sāktu to rediģēt.
9. Kad tiek atvērts tīmekļa teksta redaktors, ielīmējiet šādu kodu un noklikšķiniet uz "Saglabāt". Vispārējā ideja ir tāda, ka atkarībā no parsētā JSON, kas nāk no Google Assistentant, mūsu serveris veiks darbību (piemēram, lasīs vai rakstīs) un ziņos par to kā atbildi /izpildījums, kas jāizlasa lietotājam.
10. Vēlreiz noklikšķiniet uz "Atvērt tīmekļa cilni" un pēc tam uz zaļās pogas "Atkārtoti ielādēt".
11. Šobrīd jums vajadzētu palaist savu Python tīmekļa serveri vietnē

11. darbība: pārbaudiet savu darbību

Labi, jūs jau esat gandrīz paveicis. Izmēģināsim visu kaudzīti tagad un strādāsim ar šo “Hello world” piemēru!

1. Kreisās puses joslā noklikšķiniet uz "Integrācijas".
2. Zem Google palīga opcijas noklikšķiniet uz "Integrācijas iestatījumi".
3. Sadaļā “Netieša izsaukšana” pievienojiet sava nodoma nosaukumu, t.i., “izlidošanu”, lai to varētu aktivizēt tieši, sakot kaut ko līdzīgu: “Ok Google, sarunājieties ar manu vietējo satiksmes plānotāju par atiešanu no mājām”.
4. Iespējot izmaiņas “Automātiskā priekšskatīšana”.
5. Noklikšķiniet uz "Pārbaudīt", kas atvērs jaunu lapu.
6. Ierakstiet “Runāt ar manu vietējo satiksmes plānotāju”.
7. Jāizsauc jūsu darbība, kurai vajadzētu apsveikt jūs ar kādu no iepriekš iestatītajām apsveikuma nodoma atbildēm.
8. Pēc tam ierakstiet "Es esmu darbā". Ir jāsazinās ar jūsu Python serveri, un atbildi nolasīs Google palīgs.

Forši vai ne? Tagad iedomājieties, ko jūs varat darīt, mijiedarbojoties ar sensoriem, izpildmehānismiem un citām API, izmantojot savu Google palīgu.

12. darbība. Atlaidiet savu darbību

Kad esat pabeidzis savas darbības pārbaudi un tas ir labā stāvoklī, ir pienācis laiks dalīties mīlestībā ar pasauli vai, ja tam nav jēgas, ar draugiem un ģimeni.

1. Dodieties atpakaļ uz savu darbību konsoli un atlasiet vietējās satiksmes plānotāja darbību.
2. Sadaļā "Sagatavojieties izvietošanai" noklikšķiniet uz "Ievadiet informāciju, kas nepieciešama, lai jūsu darbība tiktu iekļauta darbību direktorijā".
3. Ievadiet īsu aprakstu, garāku aprakstu, nelielu logotipu, savu kontaktinformāciju, saiti uz konfidencialitātes politiku (ja nevēlaties to publiski kopīgot, vienkārši ievietojiet saiti uz savu vietni vai kaut ko tādu) un kategoriju.
4. Ritiniet uz augšu un noklikšķiniet uz "Saglabāt".
5. Kreisās puses joslā noklikšķiniet uz opcijas "Atlaist".
6. Šeit jūs varat izvēlēties, kādā stāvoklī ir jūsu darbība. Ja nevēlaties dzirdēt atbildi “Iegūsim Mana vietējās satiksmes plānotāja testa versiju”, jums ir jāveic pilnvērtīga publiska izlaišana. Tomēr tas ir jāpārskata Google, un tas netiks aplūkots šajā apmācībā. Tā vietā jūs joprojām varat to kopīgot ar līdz pat 20 cilvēkiem, izvēloties alfa versiju un pievienojot tos kā alfa testētājus.
7. Pievienojiet visus alfa testētājus, nosūtot viņiem saiti vai pievienojot viņu e -pastus.
8. Noklikšķiniet uz "IESNIEGT ALFA", atzīmējiet izvēles rūtiņas, noklikšķiniet uz "IESNIEGT" un esat pabeidzis!

Tagad jūsu darbība ir aktīva un tai varat piekļūt jūs un jūsu draugi. Izklaidējieties!

Ja jūs interesē mans izmantotais kods, apskatiet projektu vietnē GitHub.