watson banking chatbot

ВНИМАНИЕ: этот репозиторий больше не поддерживается. ️

Этот репозиторий не будет обновляться. Репозиторий будет доступен только для чтения.

Создайте банковского чат-бота с поиском часто задаваемых вопросов, обнаружением гнева и пониманием естественного языка.

В этом шаблоне кода мы создадим чат-бота с использованием Node.js и Watson Assistant. Последовательность действий Ассистента будет определять эмоции клиентов и будет улучшена за счет использования функции распознавания естественного языка для определения объектов местоположения. Для часто задаваемых вопросов вызов службы Discovery будет использовать поиск отрывков для получения ответов из коллекции документов.

Когда читатель выполнит этот шаблон, он поймет, как:

• Создайте чат-бота, который общается через веб-интерфейс с помощью Watson Assistant и Node.js.
• Используйте Watson Discovery с поиском отрывков, чтобы найти ответы в документах с часто задаваемыми вопросами.
• Определите объекты местоположения с помощью Watson Natural Language Analysis

ПРИМЕЧАНИЕ . Этот шаблон кода был обновлен и теперь включает инструкции по доступу к службам Watson, работающим в IBM Cloud Pak for Data. Эти обновления можно найти в конкретных инструкциях по локальному развертыванию вашего приложения или по развертыванию вашего приложения в OpenShift в IBM Cloud. Основное необходимое изменение заключается в том, что вашему приложению потребуются дополнительные учетные данные для доступа к кластеру IBM Cloud Pak for Data, на котором размещены службы Watson.

Нажмите здесь, чтобы получить дополнительную информацию о IBM Cloud Pak for Data.

Поток

1. Документы с часто задаваемыми вопросами добавляются в коллекцию Discovery.
2. Пользователь взаимодействует с чат-ботом через пользовательский интерфейс приложения.
3. Пользовательский ввод обрабатывается с помощью технологии распознавания естественного языка (NLU). Контекст пополняется объектами и ключевыми словами, обнаруженными NLU (например, местоположением).
4. Введенные данные и расширенный контекст отправляются Ассистенту. Ассистент распознает намерения, объекты и пути диалога. Он отвечает ответом и/или действием.
5. При необходимости приложение выполняет запрошенное действие. Это может включать в себя одно из следующих действий:
   • Поиск дополнительной информации в банковских службах для добавления к ответу
   • Используйте Discovery, чтобы ответить ответом из документов часто задаваемых вопросов.

Входящие в комплект компоненты

• IBM Watson Assistant: создавайте, тестируйте и развертывайте бота или виртуального агента на мобильных устройствах, платформах обмена сообщениями или даже на физическом роботе.
• IBM Watson Discovery: система когнитивного поиска и контент-аналитики для приложений, позволяющая выявлять закономерности, тенденции и получать практические идеи.
• Понимание естественного языка IBM Watson: анализируйте текст для извлечения метаданных из контента, таких как понятия, сущности, ключевые слова, категории, настроения, эмоции, отношения, семантические роли, используя понимание естественного языка.

Рекомендуемые технологии

• Node.js: асинхронная среда выполнения JavaScript, управляемая событиями, предназначенная для создания масштабируемых приложений.

Шаги

1. Клонировать репозиторий
2. Создание служб Watson
3. Настройте навык Watson Assistant
4. Загрузка документов Discovery
5. Развертывание приложения
6. Используйте веб-приложение

1. Клонируйте репозиторий

Клонируйте watson-banking-chatbot локально. В терминале запустите:

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

2. Создайте службы Watson.

Предоставление следующих услуг:

• Ватсон Ассистент
• Уотсон Дискавери
• Понимание естественного языка Watson

ПРИМЕЧАНИЕ . Если вы будете использовать вариант развертывания Deploy to Cloud Foundry on IBM Cloud , вы можете пропустить следующие шаги и сразу перейти к разделу «Развертывание приложения». Этот вариант развертывания автоматически создает службы и связывает их с вашим приложением.

Инструкции будут зависеть от того, предоставляете ли вы услуги с помощью IBM Cloud Pak for Data или IBM Cloud.

Нажмите, чтобы развернуть один:

IBM Cloud Pak для данных

Используйте следующие инструкции для каждой из трех служб.

Установка и предоставление экземпляров службы

По умолчанию услуги недоступны. Администратор должен установить их на платформе IBM Cloud Pak for Data, а вам должен быть предоставлен доступ к сервису. Чтобы определить, установлена ​​ли служба, щелкните значок «Службы» ( ) и проверьте, включена ли служба.

IBM Облако

Создайте экземпляры службы

• Если у вас нет учетной записи IBM Cloud, зарегистрируйте бесплатную пробную учетную запись здесь.
• Нажмите здесь, чтобы создать экземпляр Watson Assistant .
• Нажмите здесь, чтобы создать экземпляр Discovery .
• Нажмите здесь, чтобы создать экземпляр функции распознавания естественного языка .

3. Настройте навык Watson Assistant.

Следующие инструкции будут зависеть от того, предоставляете ли вы Assistant из IBM Cloud или из кластера IBM Cloud Pak for Data. Выберите один:

Положение о IBM Cloud Pak for Data

• Найдите службу Assistant в списке Provisioned Instances на панели мониторинга IBM Cloud Pak for Data.
• Нажмите View Details в меню параметров, связанном с вашим сервисом Assistant.
• Нажмите Open Watson Assistant .
• Перейдите на вкладку Skills .
• Нажмите Create skill
• Выберите параметр Dialog skill и нажмите Next .
• Откройте вкладку Import skill .
• Нажмите Choose JSON file , перейдите в каталог клонированного репозитория и Open файл JSON в data/conversation/workspaces/banking_US.json (или используйте старую полную версию в full_banking.json ). banking_IN.json используется для контента банковского дела в Индии, а banking_US.json используется для контента банковского дела в США.
• Выберите Everything и нажмите Import .

Предоставление в IBM Cloud

• Найдите службу Assistant на своей информационной панели IBM Cloud.
• Нажмите на службу, а затем нажмите Launch tool .
• Перейдите на вкладку Skills .
• Нажмите Create skill .
• Выберите параметр Dialog skill и нажмите Next .
• Откройте вкладку Import skill .
• Нажмите Choose JSON file , перейдите в каталог клонированного репозитория и Open файл JSON в data/conversation/workspaces/banking_US.json (или используйте старую полную версию в full_banking.json ). banking_IN.json используется для контента банковского дела в Индии, а banking_US.json используется для контента банковского дела в США.
• Выберите Everything и нажмите Import .

Чтобы найти Skill ID для Watson Assistant:

• Вернитесь на вкладку Skills .

• Нажмите на три точки в правом верхнем углу карточки и выберите View API Details .

• Скопируйте GUID Skill ID . Используйте это значение при настройке среды выполнения.

• По умолчанию приложение импортирует и использует навык с именем watson-banking-chatbot , но вы можете настроить его на использование другого навыка, задав переменную среды выполнения SKILL_ID .

  

Чтобы просмотреть диалоговое окно «Ассистент», нажмите на навык и выберите вкладку Dialog . Вот фрагмент диалога:

4. Загрузите документы Discovery

По умолчанию приложение создаст коллекцию с именем watson-banking-chatbot , но вы можете настроить ее на использование другой коллекции, задав переменные среды выполнения DISCOVERY_COLLECTION_ID и DISCOVERY_ENVIRONMENT_ID .

Следующие инструкции будут зависеть от того, предоставляете ли вы Discovery из IBM Cloud или из кластера IBM Cloud Pak for Data. Выберите один:

Положение о IBM Cloud Pak for Data

• Найдите службу Discovery в списке Provisioned Instances на информационной панели IBM Cloud Pak for Data.
• Нажмите View Details в меню параметров, связанном с вашей службой Discovery.
• Нажмите Open Watson Discovery .
• Нажмите на существующий Project Discovery или создайте новый.
• На панели Project перейдите на вкладку Collections .
• Нажмите New Collection + .
• Выберите опцию Upload data и нажмите Next .
• Укажите название коллекции.
• Выберите English язык.
• Нажмите Finish чтобы создать коллекцию.
• Используйте Drag and drop your documents here or select documents чтобы заполнить содержимое пятью документами в data/discovery/docs вашего клонированного репозитория.
• Нажмите кнопку Integrate and deploy в левом меню панели «Обнаружение». Затем выберите вкладку View API Details , чтобы просмотреть Project Id . Используйте это значение в качестве значения Collection ID при настройке среды выполнения.

ПРИМЕЧАНИЕ . Environment Id для Cloud Pak для коллекций данных всегда установлен по default .

Предоставление в IBM Cloud

• Найдите службу Discovery на панели управления IBM Cloud.

• Нажмите на службу, а затем нажмите Launch tool .

• Создайте новую коллекцию данных, нажав кнопку Upload your own data .

  

  • Укажите название коллекции
  • Выберите English язык
  • Нажмите Create

• Используйте Drag and drop your documents here or select documents чтобы заполнить содержимое пятью документами в data/discovery/docs вашего клонированного репозитория.

• Щелкните значок api в правом верхнем углу и сохраните Environment ID и Collection ID , поскольку они потребуются при настройке среды выполнения.

  

5. Разверните приложение

Нажмите на один из вариантов ниже, чтобы получить инструкции по развертыванию сервера Node.js.

6. Используйте веб-приложение

Веб-приложение представляет собой чат-бота для обслуживания клиентов. Взаимодействуйте с чат-ботом, нажимая кнопки при появлении запроса или воспользуйтесь полем Type something . Чат-бот работает на базе Watson Assistant, а дополнительная информация поступает от Discovery и Natural Language Assessment.

Поиск неисправностей

• Ошибка: невозможно вывести список рабочих пространств для Watson Assistant: Запрещено: доступ запрещен из-за неверных учетных данных.

  Эта ошибка возникает при нажатии кнопки Deploy to IBM Cloud . Настройте переменную среды выполнения для ASSISTANT_APIKEY , чтобы разрешить автоматическую настройку навыка по умолчанию, или настройте SKILL_ID для использования другого навыка.

• Сбой: выполняется операция для экземпляра службы wbc-discovery-service.

  Эта ошибка возникает при запуске приложения до того, как служба будет готова. В настоящее время это обычное поведение для кнопки Deploy to IBM Cloud . В этом случае нажмите кнопку Run , чтобы перезапустить приложение. Это удастся, когда сервис будет готов.

• Ошибка: среда {GUID} все еще не активна. Повторите попытку, как только статус станет активным.

  Это обычное явление во время первого запуска. Приложение пытается запуститься до того, как среда Discovery будет полностью создана. Подождите несколько минут и нажмите кнопку Run чтобы перезапустить приложение.

• Ошибка: для каждой организации разрешена только одна бесплатная среда.

  Для работы с бесплатной пробной версией создается небольшая бесплатная среда Discovery. Если у вас уже есть среда Discovery, это не удастся. Если вы не используете Discovery, проверьте наличие старой службы, которую вы, возможно, захотите удалить. В противном случае используйте .env DISCOVERY_ENVIRONMENT_ID, чтобы сообщить приложению, какую среду вы хотите использовать. В этой среде будет создана коллекция с использованием конфигурации по умолчанию.

Ссылки

• Демо на YouTube
• Watson Node.js SDK
• Демонстрационное видео обучения релевантности
• Демо-блокнот для обучения релевантности

Лицензия

Этот шаблон кода лицензируется по лицензии Apache версии 2. Отдельные объекты стороннего кода, вызываемые в этом шаблоне кода, лицензируются соответствующими поставщиками в соответствии с их собственными отдельными лицензиями. На вклад распространяется действие Сертификата происхождения разработчика версии 1.1 и лицензии Apache версии 2.

Часто задаваемые вопросы по лицензии Apache