最佳实践

最近更新时间:2019-05-24 15:04:37

下文以“差旅机器人”为例介绍 Bot 的创建、配置、发布和接入的全流程。

1. 创建 Bot

TBP 配置平台 主页面单击【新建 Bot】,在弹出的对话框中输入 Bot 标识名,例如:TravelBot,确定后即完成 Bot 创建:

2. 配置 Bot

单击 TravelBot 操作列的【配置】,进入 Bot 配置主界面,主要展示 Bot 相关的信息:

新建与配置意图
切换至【意图管理】模块新建意图,以订机票的意图为例,单击操作列的【新建意图】,在弹出的对话框中输入意图标识名,例如:BookTicket,确定后即完成意图创建:

单击操作列的 BookTicket【配置】,进入意图的配置页面,包括【用户说法】、【槽位】、【服务实现】和【机器人自动回复】四个配置模块:

逐一配置各个模块,例如:
a. 用户说法
添加不带槽位和带槽位的用户说法:

  • 我想订机票
  • 我要订 {DepartureTime} 的机票
  • 帮我订从 {DepartureCity} 到 {DestinationCity} 的机票

b. 槽位
添加槽位并进行相关设置:

槽位 对应词典 槽位是否必填 追问话术
出发地 DepartureCity 城市词典 请问您的出发地是哪个城市?
目的地 DestinationCity 城市词典 请问您的目的地是哪个城市?
出发时间 DepartureTime 时间词典 请问您想订什么时候的机票?
机票舱位 TicketClass 舱位词典 -
机票数量 PersonNum 数量 -

c. 服务实现
服务实现方式选择 Web Service,并输入服务调用的 URL 地址。
d. 机器人自动回复
因服务实现方式选择 Web Service,不允许设置。
意图配置完成后进行保存:

新建和配置自定义词典
在配置意图的槽位时需要为各个槽位设置对应的词典,此时可在【槽位】配置模块选择词典时快速新建自定义词典,例如为槽位 TicketClass 新建一个包含各类舱位的自定义词典 ticket_class:

也可先保存意图配置后,切换到【词典管理】模块新建自定义词典 ticket_class:


但无论通过哪种途径新建自定义词典,都需要在【词典管理】模块对自定义词典进行配置,添加词条。例如词典 ticket_class,有如下词条:

词条序号 标准词 同义词
1 经济舱 普通舱
2 商务舱 公务舱
3 头等舱 豪华舱

则进入该词典的配置页面添加以上词条:

引用内置词典
槽位对应的词典除了可以选择自定义词典之外,还可以引用平台提供的内置词典。引用内置词典同样有类似新建自定义词典的两种途径,例如在【槽位】配置模块为槽位 DestinationCity 引用包含所有城市名的内置词典 T.loc_city:

或先保存意图配置,后切换到【词典管理】模块引用内置词典 T.loc_city:

3. 编译、测试和发布 Bot

意图和词典配置无误后,需先对 Bot 进行编译才可以测试与发布。
编译 Bot
在 Bot 配置的任意页面单击【编译】都可以对 Bot 进行编译,编译过程中不允许更改 Bot 的配置和测试 Bot,例如此时 TravelBot 正在编译中:

每次 Bot 编译通过后,都会自动更新【发布管理】模块中的调试版本:

测试和发布 Bot
Bot 存在调试版本时,可进行测试,在 Bot 配置的任意页面单击【测试】,弹出测试侧边栏,与 Bot 进行对话测试,测试无误后可对当前调试版本进行发布上线。例如测试 TravelBot:

TravelBot 测试无误后,进入【发布管理】模块,单击【发布上线】,将当前版本发布为线上版本:

4. 接入 Bot

线上版本可供各类应用或终端接入使用,下面以微信公众号接入 TravelBot 为例进行介绍。
当 TravelBot 存在线上版本时,可在【应用接入】模块开启微信公众号接入按钮,此时将弹出接入配置对话框:


单击【微信公众号授权接入】,将跳转到公众平台账号授权页面,使用公众平台绑定的管理员个人微信号扫描页面的二维码,并授权接入。授权成功后公众号便接入了 TravelBot,此时可在公众号对话界面与 TravelBot 进行对话: