# 小微蓝牙设备自定义技能

# 概要

耳机厂商在技能平台上配置好对话机器人，并绑定到硬件平台的蓝牙耳机上之后，耳机就能在用户query对应指令时收到App发来的的技能、意图以及槽位信息。

借此，耳机可以更灵活的实现具体功能。

# 自定义简单技能

• 创建机器人

  打开并登录技能平台，输入机器人名称后，点击完成。

• 创建技能

  点击新建技能或创建技能，输入技能名称后，点击确定 技能名称会透传到耳机，建议使用英文字母及数字，如hp_custom_skill

• 创建意图

  点击技能列表右侧的编辑链接，进入技能编辑页面。

  点击搜索框右侧的➕按钮添加意图，同样意图名称建议使用英文字母及数字，如hp_simple_intent。

  添加完意图后，在右侧增加该意图的问法，可添加多个。 作为演示，这里添加一个问法打开运动模式 暂时忽略下方的槽位以及回答

• 耳机绑定机器人

  打开硬件平台并编辑耳机的设备信息。在设备能力的自有技能模块中，绑定之前创建的机器人。

  绑定机器人之后，点击新增账号，使用小微App扫码绑定调试账号，最后打开调试开关。

  注：目前需要使用特殊版本的小微App来扫码绑定（请联系小微团队）。

• 调试技能

  打开小微App并连接耳机，query打开运动模式之后，App会将收到技能结果（意图、槽位）转发给蓝牙耳机，如

  {
    "skill_name": "hp_custom_skill",
    "intentName": "hp_simple_intent"
  }
  

  具体协议参考蓝牙耳机协115命令

# 带槽位的技能

假设需求为调整运动模式为“长跑”、“慢跑”、“步行”中的一种，支持的query有

运动模式长跑
运动模式设置为长跑
运动模式慢跑
运动模式设置为慢跑
运动模式步行
运动模式设置为步行

再次新建一个意图hp_complex_intent, 并添加两个问法运动模式{workoutName}和运动模式设置为{workoutName}，如下图所示

接下来要给槽位设置词典：点击槽位workoutName右侧的设置词典，并点击自定义词典中的新增词典。

在词典管理的页面,新建一个词典,并点击右侧管理进入词典编辑页面。

点击新增一条，在词条中输入长跑，并确定。 重复增加慢跑、步行。

词典添加完成之后，回到技能编辑页面，为槽位workoutName设置词典：点击设置词典，选择刚才创建的词典，点击确认。

技能配置好后可以打开App并连上耳机测试。

query运动模式长跑时，耳机将收到

{
  "skill_name": "hp_custom_skill",
  "intentName": "hp_complex_intent",
  "slots": [
    {
      "slot_name": "workoutName",
      "slot_value": "长跑"
    }
  ]
}

query运动模式设置为步行时，耳机将收到

{
  "skill_name": "hp_custom_skill",
  "intentName": "hp_complex_intent",
  "slots": [
    {
      "slot_name": "workoutName",
      "slot_value": "长跑"
    }
  ]
}

更多关于槽位及字典的配置，可以参考自定义技能-基础概念