watson banking chatbot

警告：此存储库不再维护️

该存储库将不会更新。存储库将以只读模式保持可用。

创建具有常见问题解答发现、愤怒检测和自然语言理解功能的银行聊天机器人

在此 Code Pattern 中，我们将使用 Node.js 和 Watson Assistant 创建一个聊天机器人。助理流程将检测客户情绪，并通过使用自然语言理解来识别位置实体来增强。对于常见问题解答，对 Discovery 服务的调用将使用段落检索从文档集合中提取答案。

当读者完成此模式后，他们将了解如何：

• 使用 Watson Assistant 和 Node.js 创建一个通过 Web UI 进行对话的聊天机器人
• 使用 Watson Discovery 进行段落检索以在常见问题解答文档中查找答案
• 使用 Watson Natural Language Understanding 识别位置实体

注意：此 Code Pattern 已更新，包含有关访问在 IBM Cloud Pak for Data 上运行的 Watson 服务的说明。这些更新可以在本地部署应用程序或将应用程序部署到 OpenShift on IBM Cloud 的具体说明中找到。所需的主要更改是您的应用程序需要额外的凭证才能访问托管 Watson 服务的 IBM Cloud Pak for Data 集群。

单击此处了解有关 IBM Cloud Pak for Data 的更多信息。

流动

1. FAQ 文档已添加到 Discovery 集合中。
2. 用户通过应用程序 UI 与聊天机器人交互。
3. 用户输入通过自然语言理解 (NLU) 进行处理。通过 NLU 检测到的实体和关键字（例如位置）丰富了上下文。
4. 输入和丰富的上下文会发送到 Assistant。 Assistant 可以识别意图、实体和对话路径。它以回复和/或操作进行响应。
5. 可选地，应用程序执行请求的操作。这可能包括以下其中一项：
   • 从银行服务中查找附加信息以附加到回复中
   • 使用 Discovery 来回复常见问题解答文档中的答案

包含的组件

• IBM Watson Assistant：跨移动设备、消息传递平台甚至物理机器人构建、测试和部署机器人或虚拟代理。
• IBM Watson Discovery：认知搜索和内容分析引擎，用于应用程序识别模式、趋势和可操作的见解。
• IBM Watson Natural Language Understanding：使用自然语言理解分析文本，从概念、实体、关键字、类别、情感、情感、关系、语义角色等内容中提取元数据。

特色技术

• 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 for Data

对于这三项服务中的每一项，请使用以下说明。

安装和配置服务实例

默认情况下，这些服务不可用。管理员必须将它们安装在 IBM Cloud Pak for Data 平台上，并且您必须有权访问该服务。要确定是否已安装该服务，请单击“服务”图标 ( ）并检查该服务是否启用。

IBM 云

创建服务实例

• 如果您没有 IBM Cloud 帐户，请在此处注册免费试用帐户。
• 单击此处创建Watson Assistant实例。
• 单击此处创建Discovery实例。
• 单击此处创建自然语言理解实例。

3. 自定义 Watson Assistant 技能

以下说明取决于您是从 IBM Cloud 还是从 IBM Cloud Pak for Data 集群供应 Assistant。选择一项：

IBM Cloud Pak for Data 上的配置

• 在 IBM Cloud Pak for Data Dashboard 的Provisioned Instances列表中找到 Assistant 服务。
• 从与您的助手服务关联的选项菜单中单击View Details 。
• 单击Open Watson Assistant 。
• 转到Skills选项卡。
• 点击Create skill
• 选择Dialog skill选项，然后单击Next 。
• 单击Import skill选项卡。
• 单击Choose JSON file ，转到克隆的存储库目录，然后在data/conversation/workspaces/banking_US.json中Open JSON 文件（或在full_banking.json中使用旧的完整版本）。 banking_IN.json用于印度银行业务的内容， banking_US.json用于美国银行业务的内容。
• 选择Everything并单击Import 。

IBM Cloud 上的配置

• 在 IBM Cloud Dashboard 中找到 Assistant 服务。
• 单击该服务，然后单击Launch tool 。
• 转到Skills选项卡。
• 单击Create skill 。
• 选择Dialog skill选项，然后单击Next 。
• 单击Import skill选项卡。
• 单击Choose JSON file ，转到克隆的存储库目录，然后在data/conversation/workspaces/banking_US.json中Open JSON 文件（或在full_banking.json中使用旧的完整版本）。 banking_IN.json用于印度银行业务的内容， banking_US.json用于美国银行业务的内容。
• 选择Everything并单击Import 。

要查找 Watson Assistant 的Skill ID ：

• 返回Skills选项卡。

• 单击卡片右上角的三个点，然后选择View API Details 。

• 复制Skill ID GUID。设置运行时环境时使用此值。

• 默认情况下，应用程序将导入并使用名为watson-banking-chatbot 的技能，但您可以通过设置运行时环境变量SKILL_ID将其配置为使用其他技能。

  

要查看“助手”对话框，请单击该技能并选择Dialog选项卡。这是对话框的片段：

4.加载Discovery文档

默认情况下，应用程序将创建一个名为watson-banking-chatbot的集合，但您可以通过设置运行时环境变量DISCOVERY_COLLECTION_ID和DISCOVERY_ENVIRONMENT_ID将其配置为使用另一个集合。

以下说明将取决于您是从 IBM Cloud 还是从 IBM Cloud Pak for Data 集群供应 Discovery。选择一项：

IBM Cloud Pak for Data 上的配置

• 在 IBM Cloud Pak for Data Dashboard 的Provisioned Instances列表中找到 Discovery 服务。
• 从与您的 Discovery 服务关联的选项菜单中单击View Details 。
• 单击Open Watson Discovery 。
• 单击现有的 Discovery Project ，或创建一个新项目。
• 在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值。

注意：Cloud Pak for Data 收集的Environment Id始终设置为default 。

IBM Cloud 上的配置

• 在 IBM Cloud Dashboard 中找到 Discovery 服务。

• 单击该服务，然后单击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 Understanding 的附加信息。

故障排除

• 错误：无法列出 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
• 相关性培训演示视频
• 相关性培训演示笔记本

执照

此 Code Pattern 根据 Apache 许可证版本 2 获得许可。此 Code Pattern 中调用的单独第三方代码对象由其各自的提供商根据其自己单独的许可证进行许可。贡献须遵守开发者原产地证书 1.1 版和 Apache 许可证 2 版。

Apache 许可证常见问题解答