案例:微视短视频推荐

本期案例将利用微视短视频API,配置短视频推荐和搜索短视频技能。开发者可以利用此接口丰富公众号及小程序的内容,或者沿用此配置逻辑,结合自定义接口,为用户提供自体资源的视频推荐和搜索。

效果展示

微视短视频API可实现:
1.推荐短视频(意图:微视短视频);
2.搜索目标短视频(意图:视频搜索);
3.允许用户连续多次发起推荐请求(意图:微视短视频第二轮)。

最终通过配置,期望实现以下效果:
1.用户发起看短视频的需求,机器人推荐一个短视频列表,用户可以点击列表中的视频进行观看。
2.用户给出要看的视频内容,机器人回复相应的视频H5页面;
3.当用户对所给出的视频不满意时,接着给用户推荐别的短视频。
weishi

步骤一:意图配置

weishi

(一)微视短视频(推荐短视频)

  • 用户问法
    配置用户在未给出搜索内容时,发起看短视频需求的用户问法。比如用户发问:微视短视频、有什么火爆的视频、我想看视频等等。 weishi
  • 语义槽设置
    同一技能下的语义槽是通用的,技能的三个意图都使用“微视短视频API”,此API下有“查询”、“单一结果”2个输入参数,其中“单一结果”无需与语义槽关联,“查询”对应着搜索内容的关键词。新建语义槽“关键词”,关联上词典“用户问法”。
    由于这个意图下用户未给出搜索内容,所以本意图下不涉及搜索内容和关键词,无需对关键词语义槽进行追问。 weishi
  • 机器人回答
    在此意图下,机器人将随机给出短视频列表,供用户在列表中点选想看的短视频。首先选择机器人回复类型为“服务接口调用”,并选择“微视短视频”API,在【接口配置处】将输入参数“查询”与“关键词”关联。
    weishi
    配置完成后,API的输出参数会在语义槽设置处自动建槽。 接口配置完成后,下一步将配置机器人回答的话术。当成功时:
    weishi
    其中:
    (1)特殊标志符“_[ ]_”表示符号中间可以填写一个或者多个槽位信息,这个特殊标志符的作用是将其中的槽位信息列表化并可点击,以实现将推荐的短视频列表化,并允许点击。
    (2)<a> 标签定义超链接,是HTML中从一张页面链接到另一张页面的语法规则。href是其最重要的属性,它指示链接的目标。按照此规则输入微视短视频的网址,并关联上接口返回的短视频id{feedid}。
    (3)展示API返回的“视频标题”语义槽的内容,使之成为网址的前端展示。
    当接口调用失败后,提示调用失败,并附上错误码:
    weishi

最终此意图的配置效果如下:
weishi

(二)微视短视频第二轮

  • 用户问法
    添加发起下一轮视频推荐的用户问法:
    weishi
  • 语义槽设置
    同意图“微视短视频”中的语义槽设置
  • 机器人回答
    同意图“微视短视频”中的机器人回答
    最终实现如下效果:
    weishi

(三)视频搜索(搜索目标短视频)

  • 用户问法
    配置给出了想看的视频的搜索需求时,机器人将回复一张相应的H5卡片,卡片上标注有短视频名称、播放次数等信息。
    weishi
  • 语义槽设置
    本意图下,用户会给出想看的内容发起搜索,所以在语义槽设置处新建语义槽“要看的视频”,并关联上相关的词典。此处用户也可以关联相关的自定义词典以提升体验。由于此意图下,想看的内容信息是必须给到接口的,所以在此处打开追问并设置追问话术。具体配置如下:
    weishi
  • 机器人回答
    首先在机器人回答处选择服务接口调用-微视短视频,将输入参数“查询”关联上语义槽“要看的视频”,点击确定后系统将对输出参数自动建槽。
    接着在调用成功的状态下选择直接回复-H5。在标题、摘要、封面图片处等用“$语义槽$”的形式关联对应的输出参数语义槽。
    weishi
    最终配置效果如下:
    weishi

步骤二:多轮对话

由于意图“微视短视频”和“微视短视频第二轮”有承接关系,将意图“微视短视频第二轮”承接意图“微视短视频”。
weishi
经过如上配置,利用微视短视频API的短视频推荐和搜索技能就实现啦。