Creeu accions personalitzades per a l'Assistent de Google: 12 passos

2024 Autora: John Day | [email protected]. Última modificació: 2024-01-30 08:13

Veient el potencial de l'Assistent de Google tal com es presentava a Google I / O 18, així com a Volvo Cars, en el seu sistema d'infodivertiment, no em vaig poder resistir a provar-ho. Vaig tornar a utilitzar un dels meus projectes anteriors, VasttraPi, i el vaig relacionar amb l'Assistent de Google. Si voleu obtenir més informació sobre el projecte, estaria encantat de fer una ullada a l'article relacionat del meu bloc: Accions personalitzades per a l'Assistent de Google.

En aquest manual, repassem els passos necessaris per iniciar la vostra pròpia Acció de l'Assistent de Google, que us comunicarà amb el vostre servidor i us respondrà, enumerant les properes sortides. Tingueu en compte que no utilitzarem l'SDK, ja que ho executem completament a l'Assistent de Google i no al nostre propi dispositiu. En general, es mantindrà senzill. La vostra acció es podrà utilitzar en dispositius que admetin l'Assistent de Google, com ara telèfons, tauletes, assistents per a la llar i equips portables, i fins i tot podeu compartir-ho com ho faríeu amb una aplicació a Play Store.

Un dels principals avantatges de crear una cosa així sobre l'ús de serveis com IFTTT és que podeu crear respostes personalitzades al vostre servidor que llegirà l'Assistent de Google. A IFTTT, la comunicació és pel que fa a mi unidireccional.

Es tractaran els temes següents:

• Creació del vostre primer projecte d’Acció
• Creació de la vostra intenció personalitzada
• Creació de la vostra entitat personalitzada
• Configuració d’un webhook per complir la vostra acció
• Configuració d'un servidor REST simple, escrit en Python amb Flask, que proporcionarà les respostes o el "compliment"
• Prova del vostre projecte d'Acció
• Alliberant el vostre projecte d’Acció

Aquí no trobareu molts detalls ni teoria sobre les diverses funcions i conceptes de l'Assistent de Google. Si us interessa, us recomano que seguiu el tutorial oficial o que vegeu aquest vídeo.

Pas 1: definiu els permisos del vostre compte de Google

Abans de començar, hem de garantir que l'Assistent de Google tingui els permisos adequats.

1. Aneu a Controls d'activitat

2. Assegureu-vos que el següent estigui habilitat:

   1. Activitat al web i en aplicacions
   2. Informació del dispositiu
   3. Activitat de veu i àudio

Pas 2: creeu la vostra acció

1. Aneu a Actions Console i feu clic a "Afegeix / importa projecte"
2. Anomenem aquest projecte d'Accions "local-traffic-planner".
3. Feu clic a "Crea un projecte".
4. A la pàgina següent, no trieu una categoria i feu clic a "Omet".
5. Ara hauríeu d'estar a la pàgina principal d'Accions Console.

Pas 3: Invocació a l'acció

Determineu com voleu activar l'Assistent de Google per iniciar l'acció.

1. Feu clic a "Decideix com s'invoca la vostra acció" a "Configuració ràpida".
2. Anomeneu-lo "El meu planificador de trànsit local" i feu clic a "Desa".

3. Feu clic a la sol·licitud "ACTUALITZA INVOCACIONS DE MOSTRA" que va aparèixer després de fer clic a Desa.

   També podeu trobar aquesta opció a "Informació del directori"

4. Afegiu "Pregunta al meu planificador de trànsit local" com a nova invocació i feu clic a "Desa".

Pas 4: afegiu la primera acció

1. Feu clic a "Accions" a la barra esquerra.
2. Feu clic a "AFEGEIX LA VOSTRA PRIMERA ACCIÓ".
3. Seleccioneu "Intenció personalitzada" i feu clic a "Construeix".
4. Se us dirigirà a la pàgina de Dialogflow, que és on implementareu la lògica principal.

Pas 5: Formació de frases segons la vostra intenció

1. Trieu la vostra zona horària i feu clic a "Crea".
2. A la pàgina següent, deixeu les intencions existents i feu clic a "CREA INTENCIÓ".
3. Doneu a la intenció un nom raonable, és a dir, "sortides".
4. Aneu a "Frases de formació" i feu clic a "Afegeix frases de formació".

5. Utilitzeu les frases següents per formar el vostre model perquè pugui interpretar el que li expliqueu:

   1. Ara mateix estic a casa
   2. De moment estic a casa
   3. En aquest moment estic al nostre apartament
   4. Estic assegut a casa
   5. Actualment estic a punt de treballar
   6. estic a la feina
   7. Estic a l'oficina
   8. Treball
   9. Inici

Pas 6: entitats

Ara heu especificat què s’hauria d’esperar més o menys com a entrada, hem de definir quines parts de l’entrada són d’interès per a la nostra lògica empresarial perquè es puguin extreure i ressaltar al nostre servidor. En el nostre cas, volem saber si l'usuari és a casa o a la feina, de manera que podem respondre amb les sortides des de l'estació específica. Vegem com ho podem fer.

1. Si feu doble clic a una o més paraules de les frases de formació, obtindreu una llista d’entitats predefinides. Podeu llegir més sobre cadascuna d’elles aquí. En general, el més adequat seria @ sys.location, però crec que és millor i més fàcil crear una pròpia entitat que hauríem de denominar @ current-location.
2. Feu clic a l'opció "Entitats" a la part esquerra.
3. Feu clic a "CREA ENTITAT".

4. Establiu el nom a "current-location" i definiu dos valors de referència juntament amb els seus sinònims:

   1. a casa

      casa, casa, apartament, bressol

   2. treballar

      treball, oficina, Aptiv, mines de codi (lol només és broma)

5. Feu clic a "Desa. Per obtenir un efecte addicional, també podeu fer clic a" Permet l'expansió automàtica "per donar més llibertats a l'Assistent de Google per provar de fer coincidir més sinònims amb els vostres valors de referència.

Pas 7: acció i paràmetres

És hora de donar un significat a les paraules clau de les vostres frases d’entrenament.

1. Feu clic a "Intencions" i, a continuació, aneu a la vostra intenció personalitzada, és a dir, "sortides" si heu seguit els suggeriments del meu nom.
2. Desplaceu-vos cap avall fins a "Frases d'entrenament".
3. Feu doble clic a les paraules que indiquen la vostra ubicació actual i trieu l’etiqueta @ current-location a la finestra emergent.
4. Desplaceu-vos cap avall fins a "Accions i paràmetres", feu clic a "gestionar"
5. Si tot s'ha fet correctament, veureu que hi apareix la vostra nova entitat.
6. Marqueu la casella "Obligatori" que fa que aparegui una nova columna, "Sol·licituds". Preguntes és el que haurà de sentir l’usuari si no s’ha proporcionat res que coincideixi amb l’expectativa.
7. Feu clic a "Defineu indicacions" i inseriu alguna cosa com "No he entès la vostra ubicació. On esteu en aquest moment?".

Pas 8: compliment

Ara és el moment de connectar el vostre servei web a Google Assistant Action. El vostre ganxo es cridarà quan s'activi aquesta intenció específica i hauria de produir el compliment d'aquesta acció. Abans d’això, també volem establir la nostra intenció de concloure l’acció després de complir-la.

1. Aneu a "Respostes" i feu clic a "AFEGEIX UNA RESPOSTA".
2. No afegiu cap resposta, només cal que activeu "Estableix aquesta intenció com a final de conversa".
3. Desplaceu-vos cap avall fins a "Compliment", feu clic a "HABILITAR EL CUMPLIMENT" i, a continuació, activeu "Activa la trucada de webhook per a aquesta intenció".
4. Feu clic a "Desa" i aneu a l'opció "Compliment" a la part esquerra.

5. Activeu l'opció "Webhook" i inseriu l'URL que el vostre servidor web "escolta".

   Sempre que s'activa la intenció, enviarà una sol·licitud POST al vostre lloc web amb el cos de la sol·licitud que conté un objecte JSON amb la ubicació actual de l'usuari

6. Feu clic a Desa.
7. Ara estem preparats per crear el nostre servei web, però abans, assegurem-nos que la nostra acció ens doni la benvinguda de manera adequada.

Pas 9: intenció de benvinguda

Per tal de personalitzar l’experiència de l’usuari, hauríem de crear-nos una salutació adequada sempre que iniciem la nostra acció.

1. Aneu a "Intencions" i feu clic a "Intenció de benvinguda predeterminada".
2. Desplaceu-vos cap avall fins a "Respostes", elimineu les existents i inseriu el que voleu que la vostra acció us doni la benvinguda un cop iniciada.
3. Feu clic a "Desa".

Pas 10: el vostre servei web Python

Fem un servidor Python ràpid i brut utilitzant Flask. No hi ha captures de pantalla per a aquest pas, però hauria de ser força senzill.

1. Obriu una pestanya nova i creeu un compte a pythonanywhere.com
2. Verifiqueu el vostre correu electrònic.
3. Configureu l'aplicació web fent clic a "Obre la pestanya web".
4. Feu clic a "Afegeix una nova aplicació web" i seleccioneu "Flask" com a marc web de Python.
5. Seleccioneu Python 3.6 i feu clic a "Següent".
6. Trieu el camí on vulgueu que resideixi "flask_app.py". El vaig col·locar directament dins de la carpeta inicial com a "/home/your-username/flask_app.py".
7. Torneu a la pàgina principal fent clic al logotip de Python a l'extrem superior esquerre.
8. A sota de fitxers, feu clic a "flask_app.py" per començar a editar-lo.
9. Quan s'obre l'editor de text web, enganxeu el següent codi i feu clic a "Desa". La idea general és que, en funció del JSON analitzat que provingui de Google Asssistant, el nostre servidor realitzarà una acció (per exemple, llegir o escriure) i informar-la com a resposta / compliment que s’hauria de llegir a l’usuari.
10. Feu clic a "Obre la pestanya web" de nou i, a continuació, al botó verd "Recarrega".
11. A hores d'ara hauríeu de tenir el vostre propi servidor web Python funcionant a "https://your-username.pythonanywhere.com/departures".

Pas 11: proveu la vostra acció

D'acord, ja està pràcticament acabat. Provem ara tota la pila i fem funcionar aquest exemple de "Hola món".

1. Feu clic a "Integracions" a la barra lateral esquerra.
2. Feu clic a "Configuració d'integració" a l'opció de l'Assistent de Google.
3. A "Invocació implícita, afegiu el nom de la vostra intenció, és a dir," sortides "perquè es pugui activar directament dient alguna cosa com" Ei Google, parleu amb el meu planificador de trànsit local sobre sortides des de casa ".
4. Activeu els canvis de "Previsualització automàtica".
5. Feu clic a "Prova" per obrir una nova pàgina.
6. Escriviu "Parla amb El meu planificador de trànsit local".
7. S'ha d'invocar la vostra acció, que us hauria de donar la benvinguda amb una de les respostes d'intenció de benvinguda establertes prèviament.
8. A continuació, escriviu "Estic a la feina". Cal contactar amb el vostre servidor Python i l'Assistent de Google llegirà la resposta.

Guai no? Ara imagineu què podeu fer interactuant amb sensors, actuadors i altres API mitjançant l'Assistent de Google.

Pas 12: deixeu anar la vostra acció

Quan hàgiu acabat de provar la vostra acció i que estigui en bon estat, és hora de compartir l'amor amb el món o, si això no té sentit, amb els vostres amics i familiars.

1. Torneu a la consola d'Accions i seleccioneu l'acció del planificador de trànsit local.
2. A "Prepara't per al desplegament", feu clic a "Introduïu la informació necessària per incloure la vostra acció al directori d'Accions".
3. Introduïu una descripció breu, una descripció més llarga, un petit logotip, les vostres dades de contacte, un enllaç de política de privadesa (si no voleu compartir-ho públicament, poseu-hi un enllaç al vostre lloc web o alguna cosa així) i una categoria.
4. Desplaceu-vos cap amunt i feu clic a "Desa".
5. Feu clic a l'opció "Allibera" de la barra lateral esquerra.
6. Aquí podeu triar en quin estat es troba la vostra acció. Si no voleu escoltar la resposta "Obtenim la versió de prova del meu planificador de trànsit local", heu de fer un llançament públic complet. Tanmateix, això requereix una revisió de Google i no es tractarà en aquest tutorial. En lloc d'això, podeu compartir-ho amb fins a 20 persones triant una versió Alpha i afegint-les com a provadors Alpha.
7. Afegiu els provadors alfa enviant-los un enllaç o afegint els seus correus electrònics.
8. Feu clic a "ENVIAR PER ALPHA", marqueu les caselles, feu clic a "ENVIAR" i ja està.

Ara la vostra acció està activa i podeu accedir-hi vosaltres i els vostres amics. Diverteix-te!

Si us interessa el codi que he utilitzat, mireu el projecte a GitHub.