内容接口类快服务接入指南（一）-华为开发者话题

1. 概述

华为快服务智慧平台通过API接口从开发者服务器获取数据，然后向产品提供内容接口类服务，服务显示方式由产品自己定义。

内容接口类服务创建步骤：

［步骤一］注册为华为开发者
创建华为开发者联盟账号，成为开发者，参考：注册认证。

［步骤二］开发内容接口类服务
提供内容接口，接口需要满足华为接口规范，参考：3.接口规范要求。

［步骤三］接入内容接口服务
在华为开发者联盟的快服务智慧平台注册内容接口类服务相关信息。

2. 服务接入流程

2.1 接入准备

开发者提供内容数据获取接口，接口规范参见：3.接口规范要求。

2.2 创建快服务

1、登录华为开发者联盟，点击“管理中心” > “快服务”选择“华为快服务智慧平台”。

2、点击“创建快服务”，创建内容接口类服务。

内容接口类服务需要中选择、服务分类，填写快服务名称，如“语音天气预报”。点击“确定”后进入服务具体配置页面。

3、在“配置/交互模型”菜单下，点击“添加”快服务的触发意图。

说明：

（1）意图名称：填写意图名称；

（2）意图分类：点击下拉框选择意图的分类；

（3）输入交互方式：

语音：用户通过语音输入可搜索到此服务；
语音触发方式说明：
当选择语音触发方式之后，会有“是否自定义语音意图触发规则”选择框，如果快服务需要“自定义技能请求词、槽位、语料等信息”的时候，需要将当前选择框设置为勾选状态。在该意图保存之后，配置页面的二级导航栏下面将会新增“语音能力配置”的导航。

图片：用户通过拍照图片可搜索到此服务；
关键词：填写此意图的关键字，用户在全局搜索输入对应的关键词可搜索相关联的服务。关键字只能包含汉字、字母、数字，以英文输入法的逗号对关键词进行分隔才会生效。

（4）输出交互方式，默认为“系统卡片”，

4、在“配置/Fulfillment配置”菜单下，配置接口的详细信息或者快服务Function。

（1）配置接口详细信息

可以选择认证方式并设置认证相关参数，然后填写服务部署的地址信息后保存。

注意：
服务地址及服务内容的URL只接受https协议来确保传输层的安全，例如服务内容中的音频或者图片地址必须为https协议。

（2）配置快服务Function

说明：

（1）环境变量：一些敏感字段不宜在js代码里面直接定义的时候，可以设置为环境变量key/value对的形式，然后在js代码里面通过context.env.key的方式获取；

（2）index.js：基于nodeJS的函数编程模型，入口方法为myHandler；

（3）依赖集：可以在“依赖集”tab页中查看当前已经支持的依赖集，单击依赖集可以查看该依赖集中支持的依赖描述，双击依赖集选中使用的依赖集，有且只能选中一个依赖集（当前华为快服务智慧平台只提供一个依赖集供开发者选择，依赖集中包含的依赖有“request”，“request-promise”，“got”，“superagent”，“axios”，“node-fetch”，“urllib”，“download”，“sequelize”，“underscore”，“async”），并且点击“保存代码按钮”进行保存；

（4）保存代码：在保存Fulfillment配置之前，需要点击“保存代码按钮”，将配置的环境变量、代码框里面最新的js代码以及选中的依赖集进行保存；

（5）重新配置代码：确定重新配置代码之后，代码编辑框中的代码将会恢复为平台预置的js代码片段。

注意：
Fulfillment配置方式只能选择“HTTPS”或者“快服务Function”中的一种。

5、在“配置/个人数据权限”菜单下，选择此服务使用到的用户个人数据权限，选择后点击“保存”；如果不涉及任何个人数据，直接点击“保存”即可：

注意：
服务提供者需要按照《华为快服务智慧平台合作协议》中的约定规则来处理个人数据。

6、在“配置/账号授权”菜单下，配置账号绑定信息。

说明：

（1）授权类型：授权码模式

（2）授权地址：华为向开发者服务器申请授权请求的地址；

（3）Token地址：获取Token的地址；

（4）Scope：申请的权限范围；

（5）回调地址：完成授权后，开发者服务器调用该地址重新向华为快服务智慧平台同步用户的AT/RT;

（6）账号获取配置：

强制账号绑定：该服务必须依赖账号绑定才可正常使用；
双向账号绑定：用户完成帐号绑定后，如果开发者服务器需要对华为用户推送事件消息，则需要实现双向账号绑定流程。

注意：
如果此服务不涉及授权信息，关闭授权信息配置开关，直接点击“保存”即可。

7、在“配置/输出能力”菜单下，配置此服务支持分发的设备。

说明：

华为快服务智慧平台提供了一系列引导问题，开发者根据此服务的实际能力完成选择后，系统会自动匹配出此服务支持分发的华为设备类型。完成选择后，点击“保存”。

8、在“配置/服务信息”页面填写服务的基本信息。

说明：

（1）服务版本：填写服务版本号，只支持数字输入；

（2）服务名称：用户可以直接感知或者体验的服务名，只填写服务的名称，不需要写App名字。例如：叫外卖、订电影票、买机票、预定酒店等。

（3）简单描述：服务的简单描述信息（一句话描述）；

（4）详情描述：服务的详细描述信息；

（5）账号绑定跳转地址：开发者向用户提供的使用该服务的第三方账号URL地址;

（6）服务截图：上传一张服务卡片的截图给华为运营人员审核。图片格式支持JPG或JPEG格式，截图不小于： 800*450（宽高比为16:9），单张图片最大为2M。

（7）小图标：上传一张服务卡片的截图给华为运营人员审核，同时会作为服务露出展示的图标，提供App的图标即可。图标格式，正方形图标，尺寸：72*72px，图片格式：png、jpg、jpeg格式。

（8）版本描述：填写此服务版本的详细描述。

（9）服务引导信息：系统根据当前配置的触发类型与输出类型，判断出来当前快服务支持的引导类型。

总共有四种类型的引导类型：

（i）智慧提醒：开启引导填写开关时，需要填写“能力介绍”与上传“截图”，截图格式支持png/jpg/jpeg三种类型，尺寸为720*1280px，单张图片不超过2M，至少需要3张截图，最多能上传6张截图；

（ii）智慧语音：开启引导填写开关时，需要填写“常用语句”，最多支持输入10条常用语句

（iii）智慧视觉：开启引导填写开关时，需要填写“能力介绍”与上传“截图”，截图格式支持png/jpg/jpeg三种类型，尺寸为720*1280px，单张图片不超过2M，至少需要3张截图，最多能上传6张截图；

（iv）直达服务：开启引导填写开关时，需要填写“能力介绍”与上传“截图”，截图格式支持png/jpg/jpeg三种类型，尺寸为720*1280px，单张图片不超过2M，至少需要3张截图，最多能上传6张截图；

当快服务正式上线之后，将可以在服务中心app上，找到对应的快服务，服务介绍中将展示服务引导信息。

9、在“配置/语音能力配置”页面填写服务的基本信息（配置有自定义语音意图的快服务需关注）。

前面配置意图的时候讲到，当配置了“语音”触发方式并且勾选了“是否自定义语音意图触发规则”勾选框的时候，将会在“配置”一级导航栏下新增“语音能力配置”二级导航栏。“语音能力配置”页面展示了当前所配置的所有“自定义语音意图触发规则”类型的意图。

（1）在服务配置信息发生过变更的时候，请点击弹框中的“确定”按钮进行测试发布。

（2）当点击“基础信息”后面的“配置”按钮或者意图列表中的“配置”操作时，都将跳转到“华为小艺平台”进行技能的配置。

（3）完成基础信息配置之后，需要创建意图关联“华为快服务平台”意图。

（4）配置“槽位类型”、“分词词表”（具体参考“华为小艺平台帮助文档”）

（5）完成以上操作之后，可以在小艺平台上进行技能训练。

（6）训练成功之后，可以进行技能的“灰度发布”和“正式发布”。当然也可以跳转到“华为快服务智慧平台”进行快服务的上架或者升级。

注意：
关于跳转到“华为小艺平台”上的具体操作，请参考“华为小艺帮助文档”。

2.3 测试快服务

2.3.1 发布测试态快服务

点击“测试/测试发布”菜单，然后点击“测试发布”按钮。

2.3.2 快服务测试

针对内容接口类服务，华为快服务提供页面测试能力，供开发者在线验证提供的内容接口是否正常。

1、确认已在开发者联盟上创建内容接口类服务并进行测试发布。

2、在“测试/接口测试”菜单下，选择快服务对应意图，在语句表达式中输入用户表达意图的原始语音文本内容，如“天气如何”，点击“接口测试”按钮进行测试。

3、检查开发者提供的内容接口测试结果，根据接口测试结果继续输入用户可能表达的语音文本进行多轮测试。

说明：

在接口测试里面具有 “卡片预览”的功能，可以进行快服务上线之前卡片在不同的终端（手机、TV、平板）上展示真实效果预览，其前提是当前快服务提供了文字、图片内容，且在服务履行的FulfillmentRspBody -> Reply -> Command -> DisplayTemplateCommandBody模型中，templateType字段（参考业务垂类Schema结构定义）和templateContent必须有对应垂类下定义的数据内容。

当前支持卡片预览的垂类有：天气，打车，美食，工具，百科，游戏，体育赛事，店招。

4、成功后点击“测试成功并保存”按钮保存测试结果。