小微Skill入门

最近更新时间:2019-08-30 10:10:59

申请 Skill

如果您还没有通过审核,请前往Skill 开发申请,并填写相关注册信息,提交开通申请。

在配置使用小微 Skill 前,您需要先在产品介绍页 Skill 开发申请 实现信息注册,并开通小微 Skill 功能。 注册需要提供如下信息:

  1. 基本信息:请确保信息准确无误,以免耽误后续审核的过程中的联系失败;
  2. 公司信息:请上传公司的营业执照进行资质认证,并确保提交的公司规模信息准确;
  3. 能力展示:请简单描述需要使用小微 Skill 的产品能力。

完成以上信息填写,单击【确认提交】,即可完成小微 Skill 注册和申请。

配置 Skill

在通过了 Skill 开放平台的资格审核后,您就可以进入 Skill 配置平台配置第一个 Skill 了。Skill 类型目前分为 2 类:自定义类和设备类。如果您的设备是像智能灯一样的智能设备,需要被小微语音控制开关等,请选择设备类型。其他类型的接入都请选择自定义类型。下文以新建设备类型 Skill 为例,快速创建属于您的小微 Skill。

基本配置

进入 Skill 的配置平台后,可以在右上角单击【新建技能】。其中名称一栏只能为字母、数字、下划线的组合,不超过 32 位。

新建技能之后,就进入了基本配置页面:

  • 技能 ID: Skill 在腾讯云小微的唯一标识;
  • 技能类型: 您在上个页面选择的技能类型;
  • 技能名称:仅用户内部区分,不是用户在 Skill 市场上看到的最终名字;
  • 仅限设备使用: 这个开关只有当前帐号已在小微的硬件开放平台新建了设备时才出现,打开开关后,Skill 的意图不再发送对 Endpoint 服务器,而是返回到设备本身,用于设备自身的控制,例如让机器人跳舞。
  • Endpoint: 是对接您的服务器的地址;
  • 设备类型:选择使用该技能的设备类型,如门锁、电视、冰箱等;
  • 绑定帐号: 新建设备类 Skill 需要单击【开始配置】按钮来配置 OAuth2 相关内容。小微 Skill 平台的帐号登录体系仅支持 OAuth2 的标准协议,如果您的服务不支持 OAuth2 就无法使用帐号登录功能。
    OAuth2 登录相关的授权页面地址、ClientID、授权模式等都是标准协议,请根据您自己的服务协议填写和选择。

填写完以上所有基本配置内容后,单击页面右上角的【保存】按钮,可以将您填写的信息保存。

测试训练

在使用 App 前,需要在测试训练页面打开【是否启用测试】的开关。之后使用开发的 QQ 账号登录小微 App,在技能市场页面单击【我的技能】>【开发中】,找到开发中的 Skill 并启用。

发布 Skill

在您自测完成之后就可以在 Skill 平台提交上线审核,在提交前建议您参考 Skill上线认证要求,先进行自我检查。
提交审核发布需先填写以下内容:

  • 技能全称: 用户在 Skill 市场里看到的您的 Skill 的名字,必须唯一。
  • 描述: 用户在 Skill 市场里看到的您的 Skill 的介绍,越详细越好。
  • 最佳示例: 需要提供 3 句能够指导用户使用您的 Skill 的例句。
  • 关键字: 用户在 Skill 市场搜索时的关键字,可以多个。
  • 技能分类: 您的 Skill 在市场里的分类。
  • 图标: 您的 Skill 在市场里显示的图标。

在填写完所有这些内容之后,可以在右上角单击【提交审核】。提交审核之后,小微的工作人员会对 Skill 进行全方位的测试审核,预计需要 1-2 周时间才能完成整个流程。不论审核通过还是驳回,您都会收到平台的消息。

注意:

在审核期间您不能修改任何配置,所以请确保配置正确再提交审核。

上线发布之后,您需要时刻关注用户的测试和体验,不断更新 Skill 添加更多功能或者解决 Bug。