watson banking chatbot

ADVERTENCIA: Este repositorio ya no se mantiene ️

Este repositorio no se actualizará. El repositorio se mantendrá disponible en modo de solo lectura.

Cree un chatbot bancario con descubrimiento de preguntas frecuentes, detección de ira y comprensión del lenguaje natural.

En este patrón de código, crearemos un chatbot usando Node.js y Watson Assistant. El flujo del Asistente detectará las emociones de los clientes y se mejorará mediante el uso de la comprensión del lenguaje natural para identificar entidades de ubicación. Para las preguntas frecuentes, una llamada al servicio Discovery utilizará la recuperación de pasajes para obtener respuestas de una colección de documentos.

Cuando el lector haya completado este patrón, comprenderá cómo:

• Cree un chatbot que converse a través de una interfaz de usuario web utilizando Watson Assistant y Node.js
• Utilice Watson Discovery con recuperación de pasajes para encontrar respuestas en documentos de preguntas frecuentes
• Identificar entidades de ubicación con Watson Natural Language Understanding

NOTA : Este patrón de código se ha actualizado para incluir instrucciones para acceder a los servicios Watson que se ejecutan en IBM Cloud Pak for Data. Estas actualizaciones se pueden encontrar en las instrucciones específicas para implementar su aplicación localmente o implementar su aplicación en OpenShift en IBM Cloud. El principal cambio necesario es que su aplicación necesitará credenciales adicionales para acceder al clúster de IBM Cloud Pak for Data que aloja los servicios Watson.

Haga clic aquí para obtener más información sobre IBM Cloud Pak for Data.

Fluir

1. Los documentos de preguntas frecuentes se agregan a la colección Discovery.
2. El usuario interactúa con un chatbot a través de la interfaz de usuario de la aplicación.
3. La entrada del usuario se procesa con comprensión del lenguaje natural (NLU). El contexto se enriquece con entidades y palabras clave detectadas por NLU (por ejemplo, una ubicación).
4. La entrada y el contexto enriquecido se envían al Asistente. El asistente reconoce intenciones, entidades y rutas de diálogo. Responde con una respuesta y/o acción.
5. Opcionalmente, la aplicación realiza una acción solicitada. Esto puede incluir uno de los siguientes:
   • Busque información adicional de los servicios bancarios para adjuntarla a la respuesta
   • Utilice Discovery para responder con una respuesta de los documentos de preguntas frecuentes

Componentes incluidos

• IBM Watson Assistant: cree, pruebe e implemente un bot o agente virtual en dispositivos móviles, plataformas de mensajería o incluso en un robot físico.
• IBM Watson Discovery: un motor de búsqueda cognitiva y análisis de contenido para aplicaciones para identificar patrones, tendencias e información procesable.
• IBM Watson Natural Language Understanding: Analice texto para extraer metadatos de contenido como conceptos, entidades, palabras clave, categorías, sentimientos, emociones, relaciones, roles semánticos, utilizando la comprensión del lenguaje natural.

Tecnologías destacadas

• Node.js: un tiempo de ejecución de JavaScript controlado por eventos asincrónicos, diseñado para crear aplicaciones escalables.

Pasos

1. Clonar el repositorio
2. Crear servicios Watson
3. Personaliza la habilidad Asistente de Watson
4. Cargar documentos de descubrimiento
5. Implementar la aplicación
6. Utilice la aplicación web

1. Clonar el repositorio

Clona el watson-banking-chatbot localmente. En una terminal, ejecute:

git clone https://github.com/IBM/watson-banking-chatbot

2. Crear servicios Watson

Prestar los siguientes servicios:

• asistente watson
• Descubrimiento de Watson
• Comprensión del lenguaje natural de Watson

NOTA : Si va a utilizar la opción de implementación Deploy to Cloud Foundry on IBM Cloud , puede omitir los siguientes pasos y pasar directamente a la sección Implementar la aplicación. Esa opción de implementación crea automáticamente los servicios y los vincula a su aplicación.

Las instrucciones dependerán de si está aprovisionando servicios utilizando IBM Cloud Pak for Data o en IBM Cloud.

Haga clic para expandir uno:

IBM Cloud Pak para datos

Utilice las siguientes instrucciones para cada uno de los tres servicios.

Instalar y aprovisionar instancias de servicio

Los servicios no están disponibles de forma predeterminada. Un administrador debe instalarlos en la plataforma IBM Cloud Pak for Data y usted debe tener acceso al servicio. Para determinar si el servicio está instalado, haga clic en el icono Servicios () y verifique si el servicio está habilitado.

nube de ibm

Crear las instancias de servicio

• Si no tiene una cuenta de IBM Cloud, regístrese para obtener una cuenta de prueba gratuita aquí.
• Haga clic aquí para crear una instancia de Watson Assistant .
• Haga clic aquí para crear una instancia de Discovery .
• Haga clic aquí para crear una instancia de comprensión del lenguaje natural .

3. Personaliza la habilidad Asistente de Watson

Las siguientes instrucciones dependerán de si está aprovisionando Assistant desde IBM Cloud o desde un clúster de IBM Cloud Pak for Data. Elige uno:

Aprovisionamiento en IBM Cloud Pak para datos

• Busque el servicio Asistente en su lista de Provisioned Instances en su Panel de control de IBM Cloud Pak for Data.
• Haga clic en View Details en el menú de opciones asociado con su servicio Asistente.
• Haga clic en Open Watson Assistant .
• Vaya a la pestaña Skills .
• Haga clic en Create skill
• Seleccione la opción Dialog skill y luego haga clic en Next .
• Haga clic en la pestaña Import skill .
• Haga clic en Choose JSON file , vaya al directorio de repositorio clonado y Open el archivo JSON en data/conversation/workspaces/banking_US.json (o use la versión completa anterior en full_banking.json ). banking_IN.json se usa para contenido bancario en India y banking_US.json se usa para contenido bancario en Estados Unidos.
• Seleccione Everything y haga clic en Import .

Aprovisionamiento en IBM Cloud

• Busque el servicio Asistente en su IBM Cloud Dashboard.
• Haga clic en el servicio y luego haga clic en Launch tool .
• Vaya a la pestaña Skills .
• Haga clic en Create skill .
• Seleccione la opción Dialog skill y luego haga clic en Next .
• Haga clic en la pestaña Import skill .
• Haga clic en Choose JSON file , vaya al directorio de repositorio clonado y Open el archivo JSON en data/conversation/workspaces/banking_US.json (o use la versión completa anterior en full_banking.json ). banking_IN.json se usa para contenido bancario en India y banking_US.json se usa para contenido bancario en Estados Unidos.
• Seleccione Everything y haga clic en Import .

Para encontrar el Skill ID de Watson Assistant:

• Vuelve a la pestaña Skills .

• Haga clic en los tres puntos en la esquina superior derecha de una tarjeta y seleccione View API Details .

• Copie el GUID Skill ID . Utilice este valor al configurar su entorno de ejecución.

• De forma predeterminada, la aplicación importará y utilizará la habilidad denominada watson-banking-chatbot , pero puede configurarla para usar otra habilidad configurando la variable de entorno de tiempo de ejecución SKILL_ID .

  

Para ver el cuadro de diálogo Asistente, haga clic en la habilidad y elija la pestaña Dialog . Aquí hay un fragmento del diálogo:

4. Cargar documentos de descubrimiento

De forma predeterminada, la aplicación creará una colección denominada watson-banking-chatbot , pero puede configurarla para usar otra colección configurando las variables de entorno de tiempo de ejecución DISCOVERY_COLLECTION_ID y DISCOVERY_ENVIRONMENT_ID .

Las siguientes instrucciones dependerán de si está aprovisionando Discovery desde IBM Cloud o desde un clúster de IBM Cloud Pak for Data. Elige uno:

Aprovisionamiento en IBM Cloud Pak para datos

• Busque el servicio Discovery en su lista de Provisioned Instances en su panel de control de IBM Cloud Pak for Data.
• Haga clic en View Details en el menú de opciones asociado con su servicio Discovery.
• Haga clic en Open Watson Discovery .
• Haga clic en un Project de descubrimiento existente o cree uno nuevo.
• Desde el panel de su Project , haga clic en la pestaña Collections .
• Haga clic en New Collection + .
• Seleccione la opción Upload data y haga clic en Next .
• Proporcione un nombre de colección.
• Seleccione el idioma English .
• Haga clic en Finish para crear la colección.
• Utilice Drag and drop your documents here or select documents para inicializar el contenido con los cinco documentos en data/discovery/docs de su repositorio clonado.
• Haga clic en la opción Integrate and deploy en el menú del lado izquierdo del panel Discovery. Luego seleccione la pestaña View API Details para ver el Project Id . Utilícelo como valor Collection ID al configurar su entorno de ejecución.

NOTA : El Environment Id de Cloud Pak para recopilaciones de datos siempre está configurado en default .

Aprovisionamiento en IBM Cloud

• Busque el servicio Discovery en su IBM Cloud Dashboard.

• Haga clic en el servicio y luego haga clic en Launch tool .

• Cree una nueva colección de datos presionando el botón Upload your own data .

  

  • Proporcionar un nombre de colección
  • Seleccione idioma English
  • Haga clic en Create

• Utilice Drag and drop your documents here or select documents para inicializar el contenido con los cinco documentos en data/discovery/docs de su repositorio clonado.

• Haga clic en el icono api superior derecho y guarde el Environment ID y Collection ID , ya que serán necesarios al configurar su entorno de ejecución.

  

5. Implementar la aplicación

Haga clic en una de las opciones siguientes para obtener instrucciones sobre cómo implementar el servidor Node.js.

6. Utilice la aplicación web

La aplicación web presenta un chatbot de servicio al cliente. Interactúe con el chatbot presionando los botones cuando se le solicite o use el cuadro Type something . El chatbot funciona con Watson Assistant con información adicional procedente de Discovery y Natural Language Understanding.

Solución de problemas

• Error: No se pueden enumerar los espacios de trabajo para Watson Assistant: Prohibido: acceso denegado debido a credenciales no válidas.

  Este error se produce con el botón Deploy to IBM Cloud . Configure una variable de entorno de ejecución para ASSISTANT_APIKEY para permitir la configuración automática de la habilidad predeterminada o configure SKILL_ID para usar otra habilidad.

• Error: hay una operación en curso para la instancia de servicio wbc-discovery-service.

  Este error ocurre al iniciar la aplicación antes de que el servicio esté listo. Actualmente, es un comportamiento común con el botón Deploy to IBM Cloud . En este caso, haga clic en el botón Run para reiniciar la aplicación. Tendrá éxito cuando el servicio esté listo.

• Error: el entorno {GUID} aún no está activo; vuelva a intentarlo una vez que el estado esté activo

  Esto es común durante la primera ejecución. La aplicación intenta iniciarse antes de que se cree por completo el entorno Discovery. Espere unos minutos y haga clic en el botón Run para reiniciar la aplicación.

• Error: solo se permite un entorno gratuito por organización

  Para trabajar con una prueba gratuita, se crea un pequeño entorno Discovery gratuito. Si ya tiene un entorno Discovery, esto fallará. Si no está utilizando Discovery, busque un servicio antiguo que desee eliminar. De lo contrario, utilice .env DISCOVERY_ENVIRONMENT_ID para indicarle a la aplicación qué entorno desea que utilice. Se creará una colección en este entorno utilizando la configuración predeterminada.

Campo de golf

• Demostración en Youtube
• Watson Node.js SDK
• Vídeo de demostración de formación de relevancia
• Cuaderno de demostración de capacitación de relevancia

Licencia

Este patrón de código tiene la licencia Apache, versión 2. Los objetos de código de terceros independientes invocados dentro de este patrón de código reciben licencia de sus respectivos proveedores de conformidad con sus propias licencias independientes. Las contribuciones están sujetas al Certificado de Origen de Desarrollador, Versión 1.1 y a la Licencia Apache, Versión 2.

Preguntas frecuentes sobre la licencia Apache