- Tener instalado Node.js.
- Tener una cuenta de IBM Cloud.
- Tener una cuenta en Github.
- Clonar este Repositorio.
- Acceder al portal de IBM Academic Initiative y seleccionar la opción "Register now" si aun no tienes cuenta.
- Realizar el registro correspondiente utilizando la cuenta de correo académica y confirma tu cuenta.
- Despues de confirmar tu cuenta, y con la sesion iniciada en IBM Academic Initiative, en la parte de "Most Popular Topics covered", encontraremos IBM Cloud y damos clic en "Learn more".
- Bajamos de la pagina hasta encontrar "Software". Le damos clic, nos dara un apartado que se llama "Request Feature Code".
- Nos dara nuestro codigo. Lo copiamos y lo llevamos a IBM Cloud.
- En la parte superior derecha, buscaremos la parte de "MANAGE"/"GESTIONAR", nos desplegara una lista y seleccionaremos "Account"/"Cuenta".
- De lado izquierdo, tendremos una opción "Account settings"/"Configuracion de cuenta".
- Bajamos un poco hasta encontrar "Subscription and feature codes"/"Codigos de suscripción y carateristicas".
- Da clic en "Apply code"/"Aplicar codigo".
- Ingresamos el codigo y clic en "Apply"/"Aplicar".
- Creación de Watson Assistant.
- Creación del Skill.
- Creación de “Entities".
- Creación de “Intents".
- Creación del flujo de Diálogo.
- Prueba del Asistente desde IBM Cloud.
- Despliegue en la nube.
- Regresamos a la ventana principal de IBM Cloud y en la barra de búsqueda buscamos el servicio de “Watson Assistant” y damos clic en el icono del servicio.
- Seleccionamos el plan lite y damos clic en “Crear”.
- En la siguiente ventana damos clic en “Iniciar Watson Assistant”.
- Ahora en la nueva ventana damos clic en el ícono de lado izquierdo y luego en “Create assistant.”
- Le asignamos el nombre que queramos y damos clic en “créate assistant”.
- En la siguiente ventana damos clic en “Add dialog skill”.
- En la siguiente ventana nos vamos a la pestaña de “Create skill”, asignamos un nombre, seleccionamos el idioma en el que entrenaremos a nuestro modelo (“Spanish”) y damos clic en “Create dialog skill”.
- Damos clic en nuestro dialog skill para poder entrenarlo.
Si vemos que nos aparece la pestaña de "actions", es el preview, pero es preferible tener la pestaña con intents para continuar el manual por lo que seguimos las siguientes instrucciones para ver el menú clásico de Watson Assistant.
En la parte superior derecha, veremos el logo de user, donde encontraremos los detalles de la cuenta iniciada. Encontraremos el nombre de nuestra instancia creada con una pequeña. Le damos clic para revertir a la versión estandar y continuar.
- Damos clic en la pestaña de “Entities”. Después clic en "Create entity".
- Creamos una variable llamada “taco” la cual va a contener todos los tipos de tacos que tendremos disponibles.
- Nombramos el tipo de taco de pastor y agregamos los sinónimos que sean necesarios para que nuestro asistente lo pueda reconocer aun con diferentes nombres.
- Agregamos los demás tipos de tacos, junto con sus sinónimos.
- Vamos a la pestaña de "System entities" y activamos "@sys-number".
- Vamos a la pestaña de “Intents” y damos clic en “Create Intent”.
- Asignamos el nombre de “saludo” y damos clic en “create intent”.
- Agregamos al menos 5 formas en las que podríamos saludar al taquero y damos clic en la flecha para regresar a nuestros "intents".
- Creamos un nuevo intent con el nombre de “menu”, y clic en "create intent".
- Agregamos al menos 5 formas en las que se le podría pedir el menú al taquero.
- Creamos un nuevo intent llamado “orden”.
- Agregamos al menos 5 formas en las que se le podría ordenar al taquero.
- Creamos un nuevo intent llamado “cobrar”.
- Agregamos al menos 5 formas en las que se le podría pedir la cuenta al taquero.
- Damos clic en la pestaña de “Dialog”.
- En “Assistant responds” ingresamos el texto de “Soy tu taquero virtual”.
- Posteriormente damos clic en “Add node”, asignamos el nombre para poder identificar nuestro nodo y siguiendo la lógica del recuadro que se muestra, Si el asistente reconoce el intent “Saludo”, entonces el asistente responde con algún saludo y preguntando al usuario de que serán sus tacos.
- Agregamos un nuevo nodo como el paso anterior y lo nombramos “menu”, posteriormente damos clic en el engrane de “Customize” y en la parte de de abajo de la ventana, activamos el slot de “Multiple conditioned responses”.
- Para hacer más interactivo el asistente con el usuario se otorga la capacidad de responder de distintas maneras al usuario y no solo ofrecerle una respuesta estandarizada, es por eso que si el usuario pregunta por algún taco en especial se le da una respuesta personalizada.
- Añadimos un nuevo nodo llamado “ordenar” y en el engrane de “Customize” activamos los slots con el fin de que el usuario ingrese específicamente el numero y sabor del taco que ordenará.Despues en la parte inferior de la ventana activamos “Multiple responses” y amos clic en “Apply”.
- Para el intent “ordenar” necesitamos información más especifica del usuario como el número y el tipo de taco que ordenará, por lo cual, en la sección de “Then check for” programamos los slots para que le pida al usuario esos rubros forzosamente.
- En la sección de “Assitant responds” agregamos distintos tipos de respuesta, pueden ser de texto o con una imagen.
- A continuación, se muestra como configurar que si la orden es superior a 10 tacos, se le otorgara una promoción al usuario.
- En la segunda respuesta configuramos que se responda con una imagen, para eso damos clic en el engrane.
- En la siguiente ventana, damos clic en la lista desplegable y seleccionamos “image”.
- Asignamos una descripción de la imagen, buscamos en el navegador una imagen de tacos de pastor, copiamos la URL de la imagen, la pegamos en el espacio correspondiente y damos clic en “Save”.
- Creamos un nuevo nodo llamado “cuenta” y en el engrane de “Customized” activamos los “Slots” y damos clic en “Apply”.
- Para el intent “cobrar” tambien necesitamos información más específica del usuario como total de tacos que ordenó por lo cual, en la sección de “Then check for” programamos los slots para que se pida al usuario “Cuantos tacos fueron en total?” y le asignamos una variable “$number”.
- En la sección de “Assistant responds” configuramos la respuesta que se le dará al usuario, para esto seguimos la sintaxis que se muestra a continuación para realizar la operación matemática, tomando en cuenta que el costo por taco es de 8 pesos.
- Probamos nuestro asistente dando clic en “Try it” en la parte superior derecha.
- Abrir la carpeta que clonamos del Github en un editor de textos y vamos al archivo de “app.js”
- Posteriormente vamos a la lista de recursos de nuestra cuenta de IBM Cloud.
- En la pestaña de servicios, damos clic en nuestra instancia de “Watson Assistant”.
- Damos clic en “Iniciar Watson Assistant”.
- Seleccionamos el "Skill" que acabamos de crear.
- Damos clic en los tres puntos.
- Damos clic en "View API Details".
- Copiamos el valor de "Skill ID".
- Regresamos a nuestro archivo “app.js” y pegamos el valor de nuestra “Skill ID” en la línea 13 en donde nos pide un valor de "wconv_workspaceId=" y salvamos el documento.
- Posteriormente vamos a la lista de recursos de nuestra cuenta de IBM Cloud.
- En la pestaña de servicios, damos clic en nuestra instancia de “Watson Assistant”.
- Damos clic en la pestaña de “credenciales de servicio”, después en “Ver credenciales” y copiamos el “apikey”.
- Regresamos a nuestro archivo “app.js” en nuestro editor de texto y pegamos el “apikey” en la línea 14 en donde nos pide "wconv_apikey = " y salvamos el archivo.
- Dentro de nuestro editor de texto vamos al archivo “manifest.yml” y asignamos un nombre único a nuestra aplicación, en donde nos pide "name: ".
- Posteriormente abrimos una nueva terminal y nos direccionamos en la carpeta que clonamos del repositorio.
- Ingresamos el comando “ibmcloud login –sso”.
- Insertamos “Y” para que se nos genere un código de autentificación una vez iniciada la sesión con nuestra cuenta de IBM Cloud desde nuestro navegador.
- Copiamos el código que se nos abrirá en nuestro navegador.
- Lo pegamos en la terminal y damos enter (no se verá nada por seguridad). Aparecerá “Correcto” si se ingresó correctamente.
- Corremos el comando “ibmcloud target -cf“ para redirigirnos a nuestra organización y espacio predeterminados.
##Nota: Si te da problemas el comando se tiene que crear una organización y un espacio, estos se crean con los comandos: <ibmcloud account org-create NOMBREDELAORGANIZACIÓN> y <ibmcloud account space-create NOMBREDELESPACIO -o NOMBREDELAORGANIZACION >, Después puedes ejecutar el comando mencionado arriba sin ningún problema. - Corremos el comando “ibmcloud cf push” para desplegar nuestra aplicación en la nube.
- Una vez que termine de cargar todo el proceso necesario de la terminal, nos arrojara un link en el cual podremos accesar a nuestra aplicación a través de internet, copiamos la dirección.
- Abrimos un navegador y pegamos el link copiado en el paso anterior. Iniciara la aplicacion, damos clic en “Iniciar”.
- Prueba tu asistente virtual.
