Creați acțiuni personalizate pentru Asistentul Google: 12 pași

2024 Autor: John Day | [email protected]. Modificat ultima dată: 2024-01-30 11:43

Văzând potențialul Asistentului Google așa cum a fost prezentat în Google I / O 18, precum și în Volvo Cars în sistemul lor de infotainment, nu am putut rezista să îl încerc. Am refolosit unul dintre proiectele mele mai vechi, VasttraPi și l-am interfațat cu Asistentul Google. Dacă doriți să citiți mai multe despre proiect, aș fi încântat dacă aruncați o privire la articolul aferent de pe blogul meu: Acțiuni personalizate pentru Google Assistant.

În acest instructable parcurgem pașii necesari pentru a lansa propria acțiune Google Assistant, care va comunica cu serverul dvs. și vă va vorbi, listând plecările viitoare. Rețineți că nu vom folosi SDK, deoarece rulăm acest lucru complet în Google Assistant și nu pe propriul nostru dispozitiv. În general, va fi simplificat. Acțiunea dvs. va fi utilizabilă pe dispozitive care acceptă Asistentul Google, cum ar fi telefoane, tablete, asistenți la domiciliu și articole portabile și puteți chiar să o distribuiți așa cum ați face cu o aplicație din Magazinul Play!

Unul dintre principalele avantaje ale creării unui astfel de lucru în comparație cu utilizarea serviciilor precum IFTTT este că puteți crea răspunsuri personalizate pe serverul dvs., care vor fi citite de Asistentul Google. În IFTTT, în ceea ce mă privește, comunicarea este unică.

Următoarele subiecte vor fi acoperite:

• Crearea primului dvs. proiect de acțiune
• Crearea intenției dvs. personalizate
• Crearea entității dvs. personalizate
• Setarea unui webhook pentru a vă îndeplini acțiunea
• Configurarea unui server REST simplu, scris în Python cu Flask, care va oferi răspunsurile sau „îndeplinirea”
• Testarea proiectului dvs. de acțiune
• Lansarea proiectului dvs. de acțiune

Aici nu veți găsi multe detalii sau teorie despre diferitele funcții și concepte ale Asistentului Google. Dacă sunteți interesat de ele, vă sugerez cu tărie să urmați tutorialul oficial sau să urmăriți acest videoclip.

Pasul 1: setați permisiunile contului dvs. Google

Înainte de a începe, trebuie să ne asigurăm că Asistentul Google are permisiunile corespunzătoare.

1. Accesați Controlul activității

2. Asigurați-vă că sunt activate următoarele:

   1. Activitatea de pe web și din aplicații
   2. Informatie despre dispozitiv
   3. Activitate vocală și audio

Pasul 2: Creați-vă acțiunea

1. Accesați Actions Console și faceți clic pe „Adăugați / importați proiectul”
2. Să numim acest proiect Actions „local-traffic-planner”.
3. Faceți clic pe „Creați proiect”.
4. În pagina următoare, nu alegeți o categorie și faceți clic pe „Omite”.
5. Ar trebui să vă aflați acum în pagina principală a Consolei de acțiuni.

Pasul 3: Invocarea acțiunii

Stabiliți cum doriți să declanșați Asistentul Google pentru a începe acțiunea.

1. Faceți clic pe „Decideți cum este invocată acțiunea dvs.” sub „Configurare rapidă”.
2. Numiți-l „Planificatorul meu de trafic local” și faceți clic pe „Salvare”.

3. Faceți clic pe promptul „ACTUALIZAȚI INVOCAȚIILE EȘANTIONULUI” care a apărut după ce ați făcut clic pe Salvați.

   Puteți găsi această opțiune și în „Informații despre director”

4. Adăugați „Întrebați-mi planificatorul de trafic local” ca o nouă invocație și faceți clic pe „Salvați”.

Pasul 4: Adăugați prima acțiune

1. Faceți clic pe „Acțiuni” din bara din stânga.
2. Faceți clic pe „ADĂUGAȚI PRIMA ACȚIUNE”.
3. Selectați „Personal intent” și apoi faceți clic pe „Build”.
4. Veți fi condus la pagina Dialogflow, unde veți implementa logica principală.

Pasul 5: Formarea frazelor pentru intenția dvs

1. Alegeți fusul orar și faceți clic pe „Creați”.
2. Pe pagina următoare, lăsați intențiile existente și faceți clic pe „CREAȚI INTENȚIA”.
3. Dați intenției un nume rezonabil, adică „plecări”.
4. Accesați „Fraze de antrenament” și faceți clic pe „Adăugați fraze de antrenament”.

5. Folosiți următoarele fraze pentru a vă antrena modelul, astfel încât să poată interpreta ceea ce îi spuneți:

   1. Sunt acasă chiar acum
   2. Deocamdată sunt acasă
   3. Sunt în apartamentul nostru în acest moment
   4. Stau acasă
   5. În prezent sunt aproape de muncă
   6. Sunt la muncă
   7. Sunt la birou
   8. Muncă
   9. Acasă

Pasul 6: entități

Acum ați specificat ce ar trebui mai mult sau mai puțin așteptat ca intrare, trebuie să definim ce părți ale intrării sunt de interes pentru logica noastră de afaceri, astfel încât acestea să poată fi extrase și evidențiate pe serverul nostru. În cazul nostru, vrem să știm dacă utilizatorul este acasă sau la locul de muncă, astfel încât să putem răspunde cu plecările de la stația specifică. Să vedem cum putem face asta.

1. Dacă faceți dublu clic pe unul sau mai multe cuvinte din expresiile de instruire, veți obține o listă de entități predefinite. Puteți citi mai multe despre fiecare dintre ele aici. În general, cea mai potrivită ar fi @ sys.location, însă cred că este cel mai bine și mai ușor dacă ne creăm propria entitate pe care ar trebui să o numim @ current-location.
2. Faceți clic pe opțiunea „Entități” din partea stângă.
3. Faceți clic pe „CREARE ENTITATE”.

4. Setați numele la „current-location” și definiți două valori de referință împreună cu sinonimele lor:

   1. Acasă

      casa, casa, apartament, patut

   2. muncă

      muncă, birou, Aptiv, mine de cod (lol doar glumesc)

5. Faceți clic pe „Salvați. Pentru un efect suplimentar, puteți face clic și pe„ Permiteți extinderea automată”pentru a oferi asistentului Google mai multe libertăți de a încerca să potrivească mai multe sinonime cu valorile dvs. de referință.

Pasul 7: Acțiune și parametri

E timpul să dați un anumit sens cuvintelor cheie din expresiile de antrenament.

1. Faceți clic pe „Intenții” și apoi navigați la intenția dvs. personalizată, adică „plecări” dacă ați urmat sugestiile mele de nume.
2. Derulați în jos la „Fraze de antrenament”.
3. Faceți dublu clic pe cuvintele care indică locația dvs. curentă și alegeți eticheta @ locație curentă din fereastra pop-up.
4. Derulați în jos la „Acțiuni și parametri”, faceți clic pe „gestionați”
5. Dacă totul a fost făcut corect, veți vedea că noua dvs. entitate este listată acolo.
6. Bifați caseta „Obligatoriu” care face să apară o nouă coloană, „Prompts”. Prompturi este ceea ce utilizatorul va auzi dacă nu a fost furnizat nimic care se potrivește cu așteptările.
7. Faceți clic pe „Define prompts” și introduceți ceva de genul „Nu v-am înțeles locația. Unde vă aflați în acest moment?”.

Pasul 8: Îndeplinirea

Acum este timpul să vă conectați serviciul web la Google Assistant Action. Cârligul dvs. va fi apelat atunci când această intenție specifică este declanșată și ar trebui să producă îndeplinirea acestei acțiuni. Înainte de aceasta, dorim să ne stabilim și intenția de a încheia acțiunea după ce a fost îndeplinită.

1. Mergeți la „Răspunsuri” și faceți clic pe „ADĂUGĂ RĂSPUNS”.
2. Nu adăugați niciun răspuns, activați doar „Setați această intenție ca sfârșit al conversației”.
3. Derulați în jos până la „Îndeplinire”, faceți clic pe „ENABLE FULFILLMENT” și apoi activați „Activați apelul webhook pentru această intenție”.
4. Faceți clic pe „Salvați” și apoi accesați opțiunea „Împlinire” din partea stângă.

5. Activați opțiunea „Webhook” și introduceți adresa URL care este „ascultată” de serverul dvs. web.

   Ori de câte ori intenția este declanșată, va trimite o solicitare POST pe site-ul dvs. web cu corpul cererii care conține un obiect JSON cu locația curentă a utilizatorului

6. Faceți clic pe Salvare.
7. Acum suntem gata să creăm serviciul nostru web, dar înainte de asta, să ne asigurăm că Acțiunea noastră ne primește într-un mod adecvat.

Pasul 9: intenție de bun venit

Pentru a personaliza experiența utilizatorului, ar trebui să creăm un mesaj adecvat pentru noi ori de câte ori ne declanșăm acțiunea.

1. Mergeți la „Intenții” și apoi faceți clic pe „Intenție de întâmpinare implicită”.
2. Derulați în jos la „Răspunsuri”, eliminați-le pe cele existente și introduceți ceea ce doriți ca acțiunea dvs. să vă întâmpine odată ce este inițiată.
3. Faceți clic pe „Salvați”.

Pasul 10: Serviciul dvs. web Python

Să facem un server Python rapid și murdar folosind Flask. Nu există capturi de ecran pentru acest pas, dar ar trebui să fie destul de simplu.

1. Deschideți o filă nouă și creați un cont pe pythonanywhere.com
2. Verifica-ți email-ul.
3. Configurați aplicația dvs. web făcând clic pe „Deschideți fila web”.
4. Faceți clic pe „Adăugați o aplicație web nouă” și selectați „Flask” ca cadru web Python.
5. Selectați Python 3.6 și faceți clic pe „Următorul”.
6. Alegeți calea în care doriți să se găsească „flask_app.py”. Am plasat-o direct în folderul meu de acasă ca „/home/your-username/flask_app.py”.
7. Reveniți la pagina principală făcând clic pe sigla Python din colțul din stânga sus.
8. Sub fișiere, faceți clic pe „flask_app.py” pentru a începe editarea acestuia.
9. Când se deschide editorul de text web, lipiți următorul cod și faceți clic pe „Salvați”. Ideea generală este că, în funcție de JSON-ul analizat care vine de la Google Asssistant, serverul nostru va efectua o acțiune (de exemplu, citiți sau scrieți) și o raportează ca răspuns / împlinirea care ar trebui citită utilizatorului.
10. Faceți din nou clic pe „Deschideți fila web” și apoi pe „butonul de reîncărcare” verde.
11. Până acum ar trebui să aveți propriul server web Python care rulează la „https://your-username.pythonanywhere.com/departures”.

Pasul 11: Testați-vă acțiunea

OK, ai terminat destul de mult până acum. Să testăm întreaga stivă acum și să punem în funcțiune acest exemplu „Hello world”!

1. Faceți clic pe „Integrări” din bara din stânga.
2. Faceți clic pe „Setări de integrare” sub opțiunea Asistent Google.
3. Sub „Invocare implicită, adăugați numele intenției dvs., adică„ plecări”, astfel încât să poată fi declanșat direct spunând ceva de genul„ Hei Google, vorbește cu planificatorul meu de trafic local despre plecările de acasă”.
4. Activați modificările „Previzualizare automată”.
5. Faceți clic pe „Testați”, care va deschide o nouă pagină.
6. Tastați „Vorbiți cu planificatorul meu de trafic local”.
7. Acțiunea dvs. ar trebui invocată, care ar trebui să vă întâmpine cu unul dintre răspunsurile de intenție de bun venit stabilite anterior.
8. Apoi tastați „Sunt la serviciu”. Serverul dvs. Python trebuie contactat, iar răspunsul va fi citit de Asistentul Google.

Mișto nu-i așa? Acum imaginați-vă ce puteți face interacționând cu senzori, actuatori și alte API-uri prin Asistentul Google.

Pasul 12: Eliberați-vă acțiunea

După ce ați terminat testarea Acțiunii și este într-o stare bună, este timpul să împărtășiți dragostea cu lumea sau, dacă acest lucru nu are sens, cu prietenii și familia.

1. Reveniți la consola dvs. de acțiuni și selectați acțiunea dvs. de planificare a traficului local.
2. Sub „Pregătiți-vă pentru implementare”, faceți clic pe „Introduceți informațiile necesare pentru listarea acțiunii dvs. în directorul Acțiuni”.
3. Introduceți o scurtă descriere, o descriere mai lungă, o siglă mică, detaliile dvs. de contact, un link pentru politica de confidențialitate (dacă nu doriți să distribuiți acest lucru în mod public, puneți doar un link către site-ul dvs. web sau ceva similar) și o categorie.
4. Derulați în sus și faceți clic pe „Salvare”.
5. Faceți clic pe opțiunea „Eliberați” din bara din stânga.
6. Aici puteți alege în ce stare se află acțiunea dvs. Dacă nu doriți să auziți răspunsul „Să primim versiunea de testare a Planificatorului meu de trafic local”, trebuie să faceți o versiune publică completă. Cu toate acestea, acest lucru necesită o revizuire de către Google și nu va fi acoperit în acest tutorial. În schimb, puteți partaja acest lucru cu până la 20 de persoane alegând o versiune Alpha și adăugându-le ca testere Alpha.
7. Adăugați testeri alfa, fie trimițându-le un link, fie adăugându-le e-mailurile.
8. Faceți clic pe „TRIMITEȚI PENTRU ALPHA”, bifați casetele, faceți clic pe „TRIMITE” și ați terminat!

Acum Acțiunea dvs. este live și poate fi accesată de dvs. și de prietenii dvs. A se distra!

Dacă sunteți interesat de codul pe care l-am folosit, aruncați o privire la proiect pe GitHub.