欢迎来到微软机器人编辑器使用教程,从这里开始,创建一个简单的机器人。
在该系列文章中,每一篇都将通过添加更多的功能来构建机器人。当完成教程中的全部内容后,你将成功的创建一个天气机器人(Weather Bot)。在本系列中将学会以下内容:
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(文本) 任务。
“提问文本”任务创建完成后,主界面中会多出三个节点,第一个节点是机器人提出问题,第二个节点的内容为用户输入的邮政编码. 第三个为其他:
- Bot response:指机器人发出询问用户信息的提示
- 用户输入:存储用户输入的内容,机器人可以使用这一值进行进一步的处理
- 其他:验证用户输入,在输入无效时回复验证消息
第三步:在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
[完]