【Azure 机器人】微软Azure Bot 编辑器系列(2) : 机器人/用户提问回答模式，机器人从API获取响应并组织答案 (The Bot Framework Composer tutorials)

欢迎来到微软机器人编辑器使用教程，从这里开始，创建一个简单的机器人。

在该系列文章中，每一篇都将通过添加更多的功能来构建机器人。当完成教程中的全部内容后，你将成功的创建一个天气机器人(Weather Bot)。在本系列中将学会以下内容：

1）创建一个简单的对话天气机器人

2）在机器人中提出问题，并获取从HTTP API获取响应

3）在机器人中增加帮助提示和取消功能

4）使用语言生成功能（LG: Language Generation)

5）把机器人的回复转换为卡片

6）添加LUIS功能，理解自然语言

准备条件

完成系列一种的简单对话机器人创建（https://www.cnblogs.com/lulight/p/14891002.html）
准备天气的API接口的Token（Open Weather: https://openweathermap.org/）

添加机器人提问

在机器人能获取天气之前，它需要知道请求天气的具体位置。为此，需要先创建一个文本输入操作来提示用户数据邮政编码（Postal Code），然后机器人根据它从Weather API中获取对应的天气数据。

第一步：启动编辑器(Bot Composer) 并打开 weather_bot项目

第二步：在“getWeather”对话中选中“BeginDialog”开始事件，点击“+”号按钮，添加一个 Ask a question(提问) --> Text(文本) 任务。

“提问文本”任务创建完成后，主界面中会多出三个节点，第一个节点是机器人提出问题，第二个节点的内容为用户输入的邮政编码. 第三个为其他：

1. Bot response：指机器人发出询问用户信息的提示
2. 用户输入：存储用户输入的内容，机器人可以使用这一值进行进一步的处理
3. 其他：验证用户输入，在输入无效时回复验证消息

第三步：在Bot response部分，在文本属性中输入问题文本(点击‘Add alternative’ 分两次输入下面的内容)

What's your postal code?

请输入邮政编码？

第四步：在用户输入部分，在"Property"中输入“ user.postalcode ”。这将把用户输入的邮政编码保存在user.postalcode属性中

第五步：在用户输入部分，在“Output format”中输入“ =trim(this.value) ”。函数trim()是Bot的默认方法，用于把用户输入值的的多用空格去除（前后空格）。

注：用户第一次输入邮政编码后，机器人不会再次提示输入值。如果希望机器人每一次都询问新的邮政编码，则在“其他”选项卡中，必须将“Always prompt”设置为 true。

请查看添加提问的演示动画：

添加输入验证规则

验证规则：用户输入的邮政编码长度必须大于5或者6个字符。如果输入短于5个或者长于6个，机器人都会发送错误消息。此消息在“Invalid prompt”字段中设定

第一步：接上一节操作，选中“其他”选项卡。这里指定验证规则，并根据规则设定消息提示。

第二步：展开“识别器”部分，在“Unrecognized prompt”中输入下面的内容

Sorry, I do not understand '${this.value}'. Please specify a 5 or 6 digit postal code in the format 123456.

输入有误，请输入5位，或者六位的邮政编码!

第三步：展开“验证”部分，在“验证规则”中输入规则 length(this.value) == 5 || length(this.value) == 6

第四步：在“Invalid prompt”部分，点击“Add alternative”。输入下面的文本

Sorry, '${this.value}' is not valid. I'm looking for a 5 or 6 digit number as postal code.

对不起，输入的内容'${this.value}' 不是有效的邮政编码，请输入5位或者6位编码。

第五步：展开“提示配置”部分，在"Default value Response"中可以输入默认值。

注：默认情况下，提示配置为向用户询问3次后（在 Max turn count 字段中指定，默认为 3）提示将停止，并且在继续对话之前，该属性将设置为默认值字段中定义的值。

请查看添加验证的演示动画：

现在，机器人已经将用户输入的邮政编码存放在user.postalcode 属性中。接下来，将在 HTTP 请求中将该属性的值传递给天气服务API。

[重要] 添加HTTP请求

在开始之前，需要把调用天气API的信息准备好。OpenWeather 站点中注册完成后，可以在用户的API Keys信息中获取到能够访问API的Token。当前的完整URL为：

GET  http://api.openweathermap.org/data/2.5/weather?zip=${user.postalcode},us&appid=f8b74e2161e8a98afa3fdc8233b74adb

appid= Your_API_Token . 如果需要实验，可以使用以上的Token，但是该token有效期无法保证。
zip=${user.postalcode}表示输入的内容为邮政编码
us 表示地区是美国，CN表示中国。但是由于中国区的邮政编码在openweathermap中没有包含。所以无法通过邮编获取。如果有兴趣的可以自己使用城市名来查看天气情况。使用城市名的接口如：

GET http://api.openweathermap.org/data/2.5/weather?q=ChengDu&appid=f8b74e2161e8a98afa3fdc8233b74adb



Response Body:

{"coord":{"lon":-122.088,"lat":37.3855},

"weather":[{"id":721,"main":"Haze","description":"haze","icon":"50d"}],

"base":"stations","main":{"temp":291.68,"feels_like":291.39,"temp_min":284.81,"temp_max":297.16,"pressure":1007,"humidity":69},

"visibility":9656,"wind":{"speed":2.06,"deg":290},"clouds":{"all":1},"dt":1624026023,

"sys":{"type":2,"id":2010364,"country":"US","sunrise":1624020446,"sunset":1624073504},

"timezone":-25200,"id":0,"name":"Mountain View","cod":200}

第一步：在“getWeather”的对话中，选择编辑区中最下面的“+”按钮，添加一个“访问外部资源”-->“发送HTTP请求”

第二步：在HTTP的属性中，设置请求方式为GET. 请求的URL为 http://api.openweathermap.org/data/2.5/weather?zip=${user.postalcode},us&appid=Your_API_Token （注：Token需替换）， ${user.postalcode}为参数占位符，在机器人运行时根据输入自动替换。

第三步：在“Result Property”中，输入 dialog.api_response 。 Response的数据类型为"json"

第四步：在HTTP请求发送后，需要根据API的返回做下一步的操作，当请求返回200(成功)或者是其他状态(失败)，使用if/else模块来完成逻辑判断

第五步：在“分支 If/Else” 的 “Condition” 中输入 ”= dialog.api_response.statusCode == 200“表达式。注意必须要在语句前有”=“号表达式。

第六步：在“分支 If/Else” 的 ”True“ 部分，点击“+”按钮，添加“管理属性 --> 设置属性”。然后添加下列属性（注：如在添加属性时，无法添加多个属性值，可以修改编辑器的语言版本为英文后，重新加载试一试）

Property	Value
dialog.weather	=dialog.api_response.content.weather[0].description
dialog.icon	=dialog.api_response.content.weather[0].icon
dialog.city	=dialog.api_response.content.name
dialog.country	=dialog.api_response.content.sys.country
dialog.kelvin	=dialog.api_response.content.main.temp
dialog.fahrenheit	=round((9/5 * (dialog.kelvin-273)) + 32,0)
dialog.celsius	=round(dialog.kelvin-273.15)

第七步：在“True”的分支中，继续点击“+”按钮，添加一个“发送响应”任务。在响应中回复如下内容：

The weather is ${dialog.fahrenheit}F or ${dialog.celsius}C and ${dialog.weather}

当前地区的温度为${dialog.celsius}C， ${dialog.weather}

第八步：当HTTP请求返回失败时，在False的分支中也需要设定回复消息。点击“+”按钮，同样选择“发送响应”任务。在响应中回复如下内容：

I got an error: ${dialog.api_response.content.message}.

调用天气接口失败，错误消息： ${dialog.api_response.content.message}.

注：由于调用API失败的情况应为用户输入的邮政编码无效，为了保证数据的有效性，需要在False分支中删除错误的user.postalcode属性。继续点击“+”按钮，在“管理属性”下选择“删除属性”任务。输入需要删除的属性值：user.postalcode

以上步骤，就完成了机器人的问答，获取API数据并提供响应的整个功能。在测试机器人环节中验证是否正常工作。

请查看添加HTTP请求的演示动画：

测试机器人

第一步：在编辑器的右上角点击 “Start Bot”按钮，启动机器人

第二步：启动后，会弹出一个“Local bot runtime manager”的窗口，选择“Open Web Chat”，打开一个页面聊天窗口

第三步：在对话框中输入“weather” 或者“天气”来触发机器人的对话

第四步：输入邮编“94040”查看机器人的正常返回，

第五步：再次输入“weather” 或者“天气”来触发机器人的对话，输入错误的内容

在下一篇中将演示：在机器人中增加帮助提示和取消功能

(以上内容均是参考微软官方的机器人文档进行的中文操作步骤，原文连接见参考资料)

参考资料

Tutorial: Add actions to your dialog：https://docs.microsoft.com/en-us/composer/tutorial/tutorial-get-weather?tabs=v2x

Current weather data：https://openweathermap.org/current

[完]