Crear acciones personalizadas para el Asistente de Google: 12 pasos

2024 Autor: John Day | [email protected]. Última modificación: 2024-01-30 08:41

Al ver el potencial del Asistente de Google tal como se presentó en Google I / O 18, así como Volvo Cars en su sistema de información y entretenimiento, no pude resistirme a probarlo. Reutilicé uno de mis proyectos más antiguos, VasttraPi, y lo conecté con Google Assistant. Si quieres leer más sobre el proyecto, me encantaría que leyeras el artículo relacionado en mi blog: Acciones personalizadas para el Asistente de Google.

En este Instructable, repasaremos los pasos necesarios para iniciar su propia Acción del Asistente de Google, que se comunicará con su servidor y le responderá, enumerando las próximas salidas. Tenga en cuenta que no vamos a utilizar el SDK ya que lo estamos ejecutando completamente dentro del Asistente de Google y no en nuestro propio dispositivo. En general, se mantendrá simple. Tu acción se podrá utilizar en dispositivos compatibles con el Asistente de Google, como teléfonos, tabletas, asistentes domésticos y dispositivos portátiles, ¡e incluso podrás compartirla como lo harías con una aplicación en Play Store!

Una de las principales ventajas de crear algo como esto sobre el uso de servicios como IFTTT es que puede crear respuestas personalizadas en su servidor que serán leídas por el Asistente de Google. En IFTTT, en lo que a mí respecta, la comunicación es unidireccional.

Se cubrirán los siguientes temas:

• Creando tu primer proyecto de acción
• Creando tu intención personalizada
• Creando tu entidad personalizada
• Configurar un webhook para completar su acción
• Configurar un servidor REST simple, escrito en Python con Flask, que proporcionará las respuestas o "cumplimiento"
• Probando su proyecto de acción
• Lanzamiento de su proyecto de acción

Aquí no encontrará muchos detalles o teoría sobre las diversas funciones y conceptos del Asistente de Google. Si está interesado en ellos, le sugiero que siga el tutorial oficial o vea este video.

Paso 1: configure los permisos de su cuenta de Google

Antes de comenzar, debemos asegurarnos de que el Asistente de Google tenga los permisos adecuados.

1. Ir a Controles de actividad

2. Asegúrese de que lo siguiente esté habilitado:

   1. Actividad web y de aplicaciones
   2. Información del dispositivo
   3. Actividad de voz y audio

Paso 2: crea tu acción

1. Vaya a la Consola de acciones y haga clic en "Agregar / importar proyecto"
2. Llamemos a este proyecto de Acciones "planificador de tráfico local".
3. Haga clic en "Crear proyecto".
4. En la página siguiente, no elija una categoría y haga clic en "Omitir".
5. Debería estar en la página principal de la Consola de acciones ahora.

Paso 3: Invocación de acción

Determina cómo quieres activar el Asistente de Google para que inicie tu acción.

1. Haga clic en "Decidir cómo se invoca su acción" en "Configuración rápida".
2. Llámelo "Mi planificador de tráfico local" y haga clic en "Guardar".

3. Haga clic en el mensaje "ACTUALIZAR INVOCACIONES DE MUESTRA" que apareció después de hacer clic en guardar.

   También puede encontrar esta opción en "Información del directorio"

4. Agregue "Preguntar a mi planificador de tráfico local" como una nueva invocación y haga clic en "Guardar".

Paso 4: agregue su primera acción

1. Haga clic en "Acciones" en la barra de la izquierda.
2. Haga clic en "AÑADIR SU PRIMERA ACCIÓN".
3. Seleccione "Intención personalizada" y luego haga clic en "Crear".
4. Se lo dirigirá a la página de Dialogflow, que es donde implementará la lógica principal.

Paso 5: Frases de entrenamiento para su intención

1. Elija su zona horaria y haga clic en "Crear".
2. En la página siguiente, deje las intenciones existentes y haga clic en "CREAR INTENCIÓN".
3. Dé a la intención un nombre razonable, es decir, "salidas".
4. Vaya a "Frases de entrenamiento" y haga clic en "Agregar frases de entrenamiento".

5. Utilice las siguientes frases para entrenar su modelo para que pueda interpretar lo que le está diciendo:

   1. Estoy en casa ahora mismo
   2. Por el momento estoy en casa
   3. Estoy en nuestro apartamento en este momento
   4. Estoy sentado en casa
   5. Actualmente estoy cerca del trabajo
   6. estoy en el trabajo
   7. estoy en la oficina
   8. Trabaja
   9. Hogar

Paso 6: Entidades

Ahora que ha especificado lo que debería ser más o menos esperado como entrada, necesitamos definir qué partes de la entrada son de interés para nuestra lógica empresarial para que puedan extraerse y resaltarse en nuestro servidor. En nuestro caso, queremos saber si el usuario está en casa o en el trabajo, para poder responder con las salidas de la estación concreta. Veamos cómo podemos hacer eso.

1. Si haces doble clic en una o más palabras de las frases de entrenamiento, obtendrás una lista de entidades predefinidas, puedes leer más sobre cada una de ellas aquí. En general, el más adecuado sería @ sys.location, sin embargo, creo que es mejor y más fácil si creamos nuestra propia entidad a la que deberíamos llamar @ current-location.
2. Haga clic en la opción "Entidades" en el lado izquierdo.
3. Haga clic en "CREAR ENTIDAD".

4. Establezca el nombre en "ubicación actual" y defina dos valores de referencia junto con sus sinónimos:

   1. hogar

      hogar, casa, apartamento, cuna

   2. trabaja

      trabajo, oficina, Aptiv, minas de código (jajaja es broma)

5. Haga clic en "Guardar. Para un efecto adicional, también puede hacer clic en" Permitir expansión automatizada "para darle al Asistente de Google más libertades para tratar de hacer coincidir más sinónimos con sus valores de referencia.

Paso 7: acción y parámetros

Es hora de dar algún significado a las palabras clave dentro de sus frases de entrenamiento.

1. Haga clic en "Intenciones" y luego navegue hasta su intención personalizada, es decir, "salidas" si ha estado siguiendo las sugerencias de mi nombre.
2. Desplácese hacia abajo hasta "Frases de entrenamiento".
3. Haga doble clic en las palabras que indican su ubicación actual y elija la etiqueta @ current-location en la ventana emergente.
4. Desplácese hacia abajo hasta "Acciones y parámetros", haga clic en "administrar"
5. Si todo se hizo correctamente, verá su nueva entidad en la lista.
6. Marque la casilla "Requerido" que hace que aparezca una nueva columna, "Avisos". Indicaciones es lo que el usuario escuchará si no se ha proporcionado nada que coincida con las expectativas.
7. Haga clic en "Definir indicaciones" e inserte algo como "No entendí su ubicación. ¿Dónde se encuentra en este momento?".

Paso 8: cumplimiento

Ahora es el momento de conectar su servicio web a Google Assistant Action. Se llamará a su gancho cuando se active esta intención específica y debería producir el cumplimiento de esta acción. Antes de eso, también queremos establecer nuestra intención de concluir la acción después de cumplirse.

1. Vaya a "Respuestas" y haga clic en "AÑADIR RESPUESTA".
2. No agregue ninguna respuesta, solo habilite "Establecer esta intención como final de conversación".
3. Desplácese hacia abajo hasta "Cumplimiento", haga clic en "HABILITAR CUMPLIMIENTO" y luego active "Habilitar llamada de webhook para esta intención".
4. Haga clic en "Guardar" y luego vaya a la opción "Cumplimiento" en el lado izquierdo.

5. Habilite la opción "Webhook" e inserte la URL que está siendo "escuchada" por su servidor web.

   Siempre que se active la intención, enviará una solicitud POST a su sitio web con el cuerpo de la solicitud que contiene un objeto JSON con la ubicación actual del usuario

6. Clic en Guardar.
7. Ahora estamos listos para crear nuestro servicio web, pero antes de eso, asegurémonos de que nuestra Acción nos reciba de la manera adecuada.

Paso 9: Intención de bienvenida

Para personalizar la experiencia del usuario, debemos crear un saludo apropiado para nosotros cada vez que desencadenamos nuestra acción.

1. Vaya a "Intenciones" y luego haga clic en "Intención de bienvenida predeterminada".
2. Desplácese hacia abajo hasta "Respuestas", elimine las existentes e inserte lo que desea su acción cómo darle la bienvenida una vez iniciada.
3. Clic en Guardar".

Paso 10: su servicio web Python

Hagamos un servidor Python rápido y sucio usando Flask. No hay capturas de pantalla para este paso, pero debería ser bastante sencillo.

1. Abra una nueva pestaña y cree una cuenta en pythonanywhere.com
2. Verifique su correo electrónico.
3. Configure su aplicación web haciendo clic en "Abrir pestaña web".
4. Haga clic en "Agregar una nueva aplicación web" y seleccione "Flask" como su marco web Python.
5. Seleccione Python 3.6 y haga clic en "Siguiente".
6. Elija la ruta en la que desea que resida su "flask_app.py". Lo coloqué directamente dentro de mi carpeta de inicio como "/home/your-username/flask_app.py".
7. Regrese a la página principal haciendo clic en el logotipo de Python en la esquina superior izquierda.
8. Debajo de archivos, haga clic en "flask_app.py" para comenzar a editarlo.
9. Cuando se abra el editor de texto web, pegue el siguiente código y haga clic en "Guardar". La idea general es que, dependiendo del JSON analizado proveniente de Google Asssistant, nuestro servidor realizará una acción (por ejemplo, leer o escribir) y reportarlo como respuesta / cumplimiento que debe leerse al usuario.
10. Haga clic en "Abrir pestaña web" nuevamente y luego en el botón verde "Recargar".
11. A estas alturas, debería tener su propio servidor web Python ejecutándose en "https://your-username.pythonanywhere.com/departures".

Paso 11: prueba tu acción

Bien, ya casi has terminado. ¡Probemos ahora toda la pila y hagamos que funcione este ejemplo de "Hola mundo"!

1. Haga clic en "Integraciones" en la barra lateral izquierda.
2. Haga clic en "Configuración de integración" en la opción Asistente de Google.
3. En "Invocación implícita, agrega el nombre de tu intención, es decir," salidas "para que se pueda activar directamente diciendo algo como" Ok Google, habla con mi planificador de tráfico local sobre las salidas desde casa ".
4. Habilite los cambios de "Vista previa automática".
5. Haga clic en "Prueba" que abrirá una nueva página.
6. Escribe "Hablar con mi planificador de tráfico local".
7. Se debe invocar su acción, que debe saludarlo con una de las respuestas de intención de bienvenida establecidas anteriormente.
8. Luego escriba "Estoy en el trabajo". Debe contactarse con su servidor Python y el Asistente de Google leerá la respuesta.

Genial, ¿no es así? Ahora imagine lo que puede hacer interactuando con sensores, actuadores y otras API a través de su Asistente de Google.

Paso 12: Libera tu acción

Una vez que hayas terminado de probar tu Acción y esté en buen estado, es hora de compartir el amor con el mundo o, si eso no tiene sentido, con tus amigos y familiares.

1. Vuelva a la consola de Acciones y seleccione la acción del planificador de tráfico local.
2. En "Prepárese para la implementación", haga clic en "Introduzca la información necesaria para incluir su acción en el directorio de acciones".
3. Ingrese una descripción breve, una descripción más larga, un logotipo pequeño, sus datos de contacto, un enlace a la política de privacidad (si no va a compartir esto públicamente, simplemente coloque un enlace a su sitio web o algo así) y una categoría.
4. Desplácese hacia arriba y haga clic en "Guardar".
5. Haga clic en la opción "Liberar" de la barra lateral izquierda.
6. Aquí puede elegir en qué estado se encuentra su Acción. Si no desea escuchar la respuesta "Consigamos la versión de prueba de Mi planificador de tráfico local", debe realizar un lanzamiento público completo. Sin embargo, eso requiere una revisión por parte de Google y no se tratará en este tutorial. En su lugar, aún puede compartir esto con hasta 20 personas eligiendo una versión Alpha y agregándolas como probadores Alpha.
7. Agregue cualquier evaluador alfa enviándoles un enlace o agregando sus correos electrónicos.
8. Haga clic en "ENVIAR PARA ALPHA", marque las casillas, haga clic en "ENVIAR" y listo.

Ahora tu acción está activa y tú y tus amigos pueden acceder a ella. ¡Divertirse!

Si está interesado en el código que utilicé, eche un vistazo al proyecto en GitHub.