NOTA IMPORTANTE:* El tutorial que viene en este articulo fue escrito para la version 1 de la API de Dialogflow, aunque la mayor parte del tutorial sigue vigente, la parte de autorización de tokens ha cambiado . Para una implementación de referencia de la API V2 puedes dar un vistazo a este repositorio que incluye un ejemplo.*

De niño siempre quise tener un robot que me ayudara con todas las cosas que necesitaba recordar, formulas de areas, la #@$%! tabla del 7, datos históricos y hasta las tareas que me asignaba mamá. Imaginaba uno al que bauticé “Strider” y me gustaba ponerme a pensar en todas las cosas que sería capaz de hacer.

Invertía mucho tiempo jugando text adventures, las “thinking machines” del universo de Dune me apasionaban, HAL 9000 me parecía una ominosa pero fantástica criatura a la que aún me gustaría conocer. Mi primera vez con un chatbot fue con A.L.I.C.E, una impresionante pieza de código que me puso a soñar con el futuro, fue en ese tiempo cuando decidí que le entregaría mi vida a la tecnología …

Poco después de eso me convertí en un adulto joven y tanto la vida como el mercado me demandaban usar mi pasión para otras cosas, pero hoy después de unos 20 años de esos eventos tengo el placer de escribirte como el líder en México de la división de Cognitive Computing para Sngular, y me hace muy feliz tener la oportunidad de enseñarte a construir tu propio “Strider”.

Pre-requisitos

Para construir tu bot necesitas lo siguiente:

• Tener 13 años o mas y un numero celular para verificar tu cuenta de Google.

• Contar con las habilidades de llenar formularios incluyendo copiar y pegar texto.

• Abrir una cuenta en Google.

• Abrir una cuenta en Github (para la cuenta en Glitch).

• Abrir una cuenta en Glitch.

• Instalar el cliente de Discord (opcional porque #clienteWeb) y

• … abrir una cuenta allí también.

• Tener cierta afinidad o interés por la programación para tolerar la longitud de este post.

Stack / Arquitectura

Este es un diagrama de alto nivel con la arquitectura, el stack de herramientas y el flujo que vamos a usar para conectar nuestro bot:

Arquitectura / Stack / Flow

Primera Parte: Discord — El medio en donde vive nuestro bot

Vamos a empezar preparando un medio en donde el bot* *pueda tener interacción con nosotros, este medio va a ser una plataforma de chat y en este tutorial he elegido Discord porque #gamer y porque además de ser genial, es gratuito.

Para hacer esto, necesitas abrir el cliente (web o desktop) de discord, y dar un click en el símbolo + del lado izquierdo y seguir las instrucciones. Puedes consultar esta guía.

Crear un server en Discord

Por ahora no podrás hacer mucho mas que platicar contigo mismo en el servidor que creaste, pero vamos a instalar una app de Discord para que el bot tenga un canal de comunicación.

Visita esta página para crear una nueva aplicación. ¡Dale un buen nombre!

Cuando salves la configuración inicial seras presentado con mas opciones, por ahora revisa el nombre, agrega una descripción y un icono.

Crear una app en Discord

Necesitamos que nuestro bot tenga un usuario en Discord, dale click al botón Create a Bot User :

Agregar un Bot User

Después de dar click en el botón podrás ver el tag de tu bot y un par de opciones, da click en click to reveal para ver tu token, este token son tus credenciales de acceso a la API de discord, asegúrate de copiarlo en algún lugar porque vamos a usarlo pronto.

Configuración del Bot User

El siguiente paso es invitar a tu bot a tu servidor de Discord, para eso da click en el botón Generate OAuth2 URL y copia la URL que aparece en esa ventana.

Generar una OAuth2 URL

Pega la URL en una ventana de tu navegador y agrega el bot a tu servidor.

Invitar al bot a nuestro servidor

Ahora nuestro bot esta autorizado y podemos verlo en la lista de usuarios en el cliente de Discord, por ahora debe aparecer Offline.

Bot Offline

Tu bot ahora tiene acceso a un medio con capacidades de enviar y recibir mensajes.

Segunda parte: Código 💚 JavaScript — El sistema nervioso

Para conectar el entorno de nuestro bot con su cerebro necesitamos:

• Un cliente programático para poder conectar a nuestro bot con Discord

• Algo de código para utilizar este cliente

• Un lugar para ejecutar este código

Ya he preparado todo el código que necesitamos pero para ejecutarlo vamos a utilizar Glitch, una plataforma que disfruto mucho utilizar porque te permite escribir y probar cosas super rápido. Sigue estos pasos:

1. Ábrete una cuenta en Glitch.com (vas a necesitar tu cuenta de GitHub)

2. Dale click aquí para crear un remix del proyecto base, esto va a generar un proyecto en tu cuenta y a copiar el código para hacer tu propia versión.

3. Selecciona el archivo .env en tu proyecto y proporciona las primeras dos variables: BOT_KEYWORD que es la palabra con la que vamos a iniciar una conversación con el bot (por ejemplo su nombre) y DISCORD_API_TOKEN que obtuviste en la parte anterior

El archivo .env debe verse parecido a este ejemplo:

Ejemplo de archivo `.env`

Ahora revisa tu cliente de Discord y debes poder ver que tu bot se encuentra online

Bot Online

Por default he dejado un comando para probar que el bot esta en condiciones de trabajar, intenta escribiendo !ping en tu cliente de Discord y tu bot debe responderte con un pong! .

Prueba inicial con `!ping`

Tercera parte: Dialogflow — El cerebro del bot

Dialogflow es una herramienta impresionante que merece una serie completa de posts para capturar un poco de su poder. En este ejercicio vamos a usar su funcionalidad mas elemental que es comprender intenciones simples y resolver con respuestas pre-programadas.

Primero que nada necesitas conseguir una cuenta en Dialogflow, vas a necesitar una cuenta con Google.

Ya que tengas tu cuenta vamos a crear un agente dando click en el link de Create Agent en el menú de la izquierda.

Crear un agente nuevo

En las opciones dale un nombre al agente y asegúrate de seleccionar el idioma y la zona horaria correcta.

Configuración del agente

Después de dar click en CREATE podrás ver las opciones del bot, si avanzas con el scroll en esta pantalla podrás consultar las llaves de acceso.

Llaves de acceso (difuminadas en la imagen)

Copia el Client Access Token y pégalo en la variable DIALOGFLOW_CLIENT_ACCESS_KEY en el archivo .env de tu proyecto que configuramos en la Segunda Parte.

Dialogflow utiliza el concepto de Intent para describir la forma en la que toma el texto de un mensaje y lo interpreta en una intención del usuario.

Desde la consola de Dialogflow configuremos el primera Intent, selecciona INTENTS en el menú principal y luego dale al botón CREATE INTENT arriba a la derecha.

Crear un intent

Dale un nombre a tu Intent, mi recomendación es que utilices una taxonomía para tus intentos utilizando puntos en el nombre para clasificarlos , por ejemplo:

• charla.saludos.hola

• smalltalk.user.willBeBack

• iot.luces.apagar

Para entrenar a nuestro bot para que responda a un saludo genérico creamos un Intent al que podemos llamar: smalltalk.greetings.hello, y agregamos algunas frases de entrenamiento (Training Phrases), estas frases son ejemplos iniciales con los que el bot aprende a comprender las intenciones de su interlocutor.

Nombre del intent y frases de entrenamiento

NOTA IMPORTANTE!!!: Asegúrate de darle un nombre a la acción en la sección Action and parameters, esto es importante para que nuestro código sepa que Dialogflow ha identificado una intención. Puedes usar el mismo nombre del Intent.

No olvides agregar un nombre a la acción

Por ultimo vamos a agregar algunas respuestas en la sección Responses, una de estas respuestas será enviada cuando el bot reconozca que lo estamos saludando. Después dale clic en el botón SAVE para guardar el Intent y que la IA pueda entrenarse con esta nueva data, esto normalmente toma unos segundos.

Respuestas para el intent de saludo simple

Ahora estamos listos para probar el cerebro de nuestro bot, abre tu cliente de Discord y saluda a tu bot, no olvides incluir en el primer mensaje la palabra clave que definimos en el archivo .env en la Segunda Parte de este tutorial. En este ejemplo la palabra clave es strider .

El bot estrena su cerebro para saludar.

Si llegaste hasta este punto: Felicidades, eres el feliz poseedor y entrenador de un bot con un cerebro artificial que puede “entender” tus intenciones escritas en lenguaje natural.

Bonus: Siguientes pasos

Insisto en que Dialogflow es una herramienta muy poderosa, es el motor que utiliza el asistente de Google para hacer su magia.

En este tutorial hemos rascado la superficie de lo que puede hacer y espero que me de la vida para poder escribir una segunda parte pero por ahora te sugiero explorar cosas como las entidades para adquirir parámetros, contextos para producir diálogos complejos y el fulfillment para llamar servicios externos con los que básicamente le das súper poderes a tu bot.

También te sugiero hacer cosas como:

• Crear muchos Intents en Dialogflow y generar una personalidad para tu bot.

• Conseguir un avatar para tu bot y tenerlo a la vista cuando escribas sus respuestas.

• Da un vistazo al código de tu bot y trata de cambiar la respuesta de !ping por otra cosa

• Intenta agregar otras respuestas estáticas (como la de !ping ) que no requieran a la NLP

• Asegúrate de que tus Intents tienen por lo menos de 10 a 15 frases de entrenamiento y por lo menos 5 respuestas distintas.

Conclusión

Espero que hayas disfrutado hacer a tu propio asistente, tanto como yo he disfrutado preparar este post. Strider es un individuo en una creciente familia de Bots a la que he tenido la oportunidad de darle vida.

En parte construir Bots es como hacer un show de marionetas utilizando trucos tecnológicos bastante avanzados, pero hoy en día esta tomando fuerza en la industria como una de las plataformas que van a desplazar a la web en interfaces de usuario, acceso a datos y procesos de negocio.

En Sngular utilizamos esta tecnología para producir interfaces conversacionales y para hacer análisis de sentimientos en grandes volúmenes de datos (como en Twitter por ejemplo), sin lugar a dudas las tecnologías de IA serán las estrellas del próximo lustro.

Si te interesa utilizar y producir tecnología como esta en tu día a día, ponte en contacto conmigo, continuamente estoy a la búsqueda de individuos talentosos con afinidad por este tipo de tecnologías que involucran Inteligencia Artificial.

Edu Mosqueda es papá, arquitecto, junkie de el Script de la Asociación Europea de Manufactura de Computadoras en su versión 6, y disfruta mucho escribir entre líneas.