华为云API对话机器人CBS的魅力—要是有AI，我要做“李白”- 5分钟开发作诗机器人

云服务、API、SDK，调试，查看，我都行

阅读短文您可以学习到：人工智能AI自言语言的情感分析、文本分词、文本翻译

1 IntelliJ IDEA 之API插件介绍

API插件支持 VS Code IDE、IntelliJ IDEA等平台、以及华为云自研 CodeArts IDE，基于华为云服务提供的能力，帮助开发者更高效、便捷的搭建应用。API插件关联华为云服务下的 API Explorer、DevStar、CodeLabs、SDK 中心和 CLI 中心产品，致力于为开发者提供更稳定、快速、安全的编程体验。

在本插件中，我们提供了但不局限于如下的功能：

对接华为云API开放平台，支持用户检索API、查看API文档、调试API、以及提供SDK示例代码供用户学习如何使用API。

提供华为云SDK代码片段补全功能，SDK依赖包自动引入，加速用户集成华为云API。

对接华为云开发体验馆Codelabs，提供500+云服务代码示例，向导式教程帮助用户快速学习。

说明：

在IntelliJ IDEA等系列平台和VS Code IDE，华为云API插件的名称是Huawei Cloud API。而在CodeArts IDE，API插件是IDE原生内置的，名称是华为云API开发套件。

API插件在IntelliJ IDEA等系列平台和VS Code IDE的使用依赖底座插件，请提前安装底座插件。

2 API插件安装--IntelliJ IDEA

2.1 IntelliJ IDEA等平台

安装准备：下载并安装JDK1.8或更高版本。下载并安装IntelliJ IDEA 2020.2或更高版本。

须知：IntellIj平台同时支撑包括Goland、Pycharm等在内的IDE，若在其它相关IDE上开发，请下载配置好对应语言的编译器或者解释器。这里以IDEA为例介绍IntelliJ平台插件的安装流程，其他IntelliJ系列的IDE请参考IDEA。

开始安装：

您可以在直接在IDE插件市场或者直接在JetBrains插件市场下载离线包安装。

https://developer.huaweicloud.com/develop/toolkit.html

IDE安装

1. 在IntelliJ IDEA顶部菜单栏中选择File > Settings，在Settings对话框的左侧导航栏中单击Plugins。
2. Plugins区域单击Marketplace,在搜索栏中输入Huawei Cloud API。
3. Search Results区域会出现Huawei Cloud API，单击Install，完成后重启IDE。

离线包安装：

1. 进入插件市场搜索Huawei Cloud API，进入插件详情页，在Versions页签下选择想要版本的API插件，点击Download下载离线的插件压缩包保存到本地。。
2. 在IntelliJ IDEA顶部菜单栏中选择File > Settings，在Settings对话框的左侧导航栏中单击Plugins。
3. 在Plugins区域单击 ，再单击Install Plugin from Disk...。
4. 在Choose Plugin File对话框中选择离线安装包（不用解压），并按照IntelliJ IDEA安装页面的提示，完成后续安装步骤。

说明：若当前您想要安装插件的IntelliJ IDE已经在桌面打开，则进入插件市场搜索Huawei Cloud API，进入插件详情页，在右上角会识别到本地已经打开的IDE，点击相应按钮，在弹出的IDE窗口中点击ok，则IDE后台会开始安装相应版本的API插件。

安装验证：在IntelliJ系列平台上安装插件成功后在左侧的导航栏中可以看到Huawei Cloud Toolkit图标，点击后面板会出现Huawei Cloud API的字样，则说明安装成功。

3 使用对话流程，搭建复杂逻辑的AI对话场景

3.1 华为云API

Toolkit-华为云

左侧展示API列表，可以查询所有API，目前云服务206，APIs9213

3.2 要是有AI，我要做“李白”- 5分钟开发作诗机器人

创建华为云账号并实名认证，点击右侧的浏览代码按钮，整包下载数据压缩包至本地，解压后可以看到有以下三个文件夹：

.

├── acrostic_dict.txt

├── poetry_demo.py

└── poetry_type_dict.txt

创建试用版智能问答机器人，由于技能管理是专业版智能问答机器人下的功能，因此首先我们需要购买一个试用版专业版问答机器人。 点击此链接，进入对话机器人服务智能问答机器人页面，点击右上角的购买问答机器人，进入问答机器人购买页面。

分别输入问答机器人名称，选择试用的计费模式，并点击立即购买完成支付，即完成试用专业版机器人创建。

问答机器人创建成功后，返回对话机器人服务主页面，等待机器人创建成功后，点击“机器人名称”进入机器人，左侧的标签栏中会有一项技能管理。

 

问答机器人创建成功后，返回对话机器人服务主页面，等待机器人创建成功后，点击“机器人名称”进入机器人，左侧的标签栏中会有一项技能管理。

创建实体：

添加诗歌类型实体，创建实体，点击此链接，进入对话机器人服务，点击进入相应的机器人，点击“实体管理”，再点击“创建实体”按钮，按照下图指导添加诗歌类型实体：https://console.huaweicloud.com/cbs/?region=cn-north-4#/home/qa-robot

词典标注：POETRY_TYPE

词典名称：诗歌类型

点击“确认”按钮，创建该条词典，并进入“编辑”页面。

添加词条

点击页面上的“导入词条”按钮，然后点击“添加文件”按钮，上传本地文件夹下的poetry_type_dict.txt文件，导入模式选“追加”，最后点击“确定”按钮，即可完成诗歌类型词典词条导入。如下图所示：

导入成功后，点击“构建词典”，可以看到如下词条：

添加藏头诗词典：创建词典

点击进入此页面，参看上述创建诗歌类型词典的方式，创建藏头诗词典。点击“创建词典”按钮，并进入“编辑”页面。填写内容如下：https://console.huaweicloud.com/cbs/?region=cn-north-4#/home/qa-robot

词典标识：ACROSTIC

词典名称：藏头诗判断

点击“确认”按钮。

添加词条

进入“编辑”界面后，点击“导入词条”按钮，点击“添加文件”按钮，选择本地文件夹中的acrostic_dict.txt文件，导入模式选择“追加”，最后点“确定”按钮，完成藏头诗判断词典词条导入，如下图所示：

导入完成后，点击“构建词典”。如下图所示：

至此，两条词典创建成功，返回词典管理页面，点击“发布词典”，如下图所示：

技能配置

本节将添加语料并标注，配置作诗机器人的技能。

点击此链接，进入对话机器人服务的“技能管理”，新建写诗技能并进行技能配置。

创建技能

点击“添加技能”按钮，选择“多轮对话技能”，点击下一步，输入技能名称：写诗技能，如下图所示：

创建意图

技能创建完成后，点击进入写诗技能，在意图列表中点击“创建”按钮，如下图指导填写：

意图标识：poem

意图名称：写诗

然后点击“确认并继续设置”按钮，继续配置该意图。

添加用户问法语料

进入“poem”意图的“用户问法”，点击“用户问法语料”输入框下方的蓝色字体“批量添加用户问法语料”，复制下方的语料至弹出对话框，点击“确认”完成用户问法预料导入。

以秋思为题写首诗

作诗一首

写一首五言绝句

写一首诗

写个诗

写首七言绝句

来一个七言律诗

来首诗吧

用白云写一首诗

用秋思写个五言律诗

给我写个诗

语料添加完之后，滑动页面到最下方，点击“保存”。可以得到如下结果：

添加槽位

往下滑动页面，找到“槽位管理”页面，分别创建槽位:poetryType(诗歌类型)，poetryName(诗歌名称)，acrostic(藏头诗)三个槽位。槽位是触发意图的关键信息。

然后点击“添加槽位”按钮，按照如下指导，添加poetryType槽位：

关联槽位：不关联

槽位标识：poetryType

槽位名称：poetryType

是否必须：是

追问轮数：1

输入框：请问诗歌类型是什么？

词典选择：POETRY_TYPE

答案候选:勾选

然后点击“确定”按钮。

再次点击“添加槽位”按钮，按照如下指导，添加poetryName槽位：

关联槽位：不关联

槽位标识：poetryName

槽位名称：poetryName

是否必须：是

追问轮数：1

输入框：请问诗歌名称是什么？

词典选择：sys.any

答案候选:不勾选

然后点击“确定”按钮。

再次点击“添加槽位”按钮，按照如下指导，添加acrostic槽位：

关联槽位：不关联

槽位标识：cangtou

槽位名称：acrostic

是否必须：是

追问轮数：1

输入框：请问需要藏头诗么？

词典选择：ACROSTIC

答案候选:不勾选

然后点击“确定”按钮。

三个槽位添加完成后，滑动页面到最下方，点击“保存”。可以得到如下列表：

语料标注

往上滑动页面，回到“用户问法”，对“用户问法语料”列表中的语料进行标注。

选中关键词，然后使用槽位对关键词标注。例如：七言绝句——poetryType，秋思——poetryName。

标注完成后，如下图所示：

添加用户问法模板

点击“用户问法”中的“用户问法模板”页面中添加模板。

点击“添加模板”按钮。模板内容如下图所示，在相应位置点击下方槽位名称插入相应槽位。完成配置后用户即可使用模板的问法与机器人进行对话。

添加第一个模板：

添加第二个模板：

两个问法模板添加完成后，滑动页面到最下方，点击“保存”。可以看到如下列表：

机器人回复管理

配置通过函数的方式调用作诗接口。

创建函数

向下滑动页面，找到“回复管理”页面。

选择“调用函数回复”，并点击右侧“创建新函数”按钮进入函数工作流控制台，如下图所示：

在函数工作流控制台中，点击进入“函数”——“函数列表”，点击右上角的“创建函数”按钮：https://console.huaweicloud.com/functiongraph/?region=cn-north-4#/serverless/functions

按照如下指导，填写参数：

模板：使用空模板

函数名称：poem

所属应用：default

委托名称：不使用任务委托

运行时语言：Python3.6

函数执行入口：index.handler

代码上传方式：在线编辑。将本地文件夹下poetry_demo.py文件中的代码复制粘贴进来。然后填入真实的账号名、用户名、密码。再点击“部署”。

注意：需要修改代码中的账号名、用户名、密码为自己的真实信息（如果是主账号，用户名和账户名相同）

代码主要功能：获取槽位信息，调用写诗接口，返回接口调用结果。

最后点击“创建函数”按钮：

创建成功后，会自动跳转到函数配置页面。

设置函数

配置函数的超时时间，点击“设置”页签，然后将执行超时时间改为10，点击保存，如下图所示：

配置测试用例

点击右上角的“请选择测试事件”下拉框中的“配置测试事件”按钮，如下图所示：

在测试事件输入框中填入:{"slots":{"poetryType":["五言绝句"],"poetryName":["秋思"],"acrostic":["true"]}}，如下图所示：

保存测试事件后，点击“测试”按钮，查看测试结果，测试结果如下：

选择函数回复

返回poem意图管理页面，选择调用函数回复，在下拉框中选择已创建的函数poem，如下图所示：

然后点击页面下方的“保存”按钮，保存意图所有配置信息。

模型训练发布：

在“写诗技能”页面中，进入“发布测试”页面，点击“训练模型”按钮，勾选“用户常用问法”，技能阈值默认即可。点击“确定”开始模型训练，训练时长大概3分钟。

模型训练完成后，点击“线上发布”按钮发布模型。

3.3 技能体验

模型发布完成后，回到“技能管理”页面，点击右上角“对话体验”按钮(诗歌类型槽位已配置开启候选项，因此用户可通过点击响应类型进行自动回复)

下图是一组对话样例：

恭喜你：

祝贺您，您已经使用CBS技能平台完成了技能机器人的配置！接下来您可以结合不同的需求为机器人配置各项技能，实现不同场景下的多轮对话能力。

接下来您可以

和作诗机器人尝试其他形式的多轮对话。

尝试对话机器人服务中的其他功能。

4 参考文献

https://support.huaweicloud.com/usermanual-cbs/cbs_01_0029.html

https://console.huaweicloud.com/cbs/?region=cn-north-4#/cbs/management/skills

5 体验插件的魅力

华为云devkit已上线：https://developer.huaweicloud.com/develop/toolkit.html