1 技能概述

简介

• 1个应用（设备）包含多个技能
• 1个技能包含多个意图
• 1个意图包含多个语料

技能开发步骤

1. 设计交互流程

1. 在控制台创建技能
   查看指引
2. 完善技能的交互模型
   将第1步的意图配置在技能中。完善用户语料。查看指引
3. 技能逻辑处理
   当语义理解识别意图后，你需要编码来满足用户的意图，支持 在线云函数 和 webhook 。当用户交互时，你的技能会收到讯飞服务器发送给你的 Request，你在接到Request之后进行处理并返回Response，讯飞将会根据返回的Response进行后续处理。查看指引

1. 测试技能

用户：今天天气？
系统: 今天16摄氏度
用户：要带伞吗？
系统：不需要

意图和语料

1 意图

1.1 意图分类

入口意图：不需要历史信息就响应用户
对话意图：为了减少不同技能的说法串扰，先命中A技能的入口意图，才能命中A技能的对话意图。存在历史交互信息，响应存在上下文关联。

// 正常命中
用户：今天天气   （入口意图）
AIUI：晴
用户：明天呢     （对话意图）
AIUI：阴天

// 无法命中
用户：明天呢     （对话意图）
AIUI：对不起，我没听懂 （未命中）

1.2 意图类型切换

1. 打开意图，并点击意图信息内的编辑按钮
   
2. 切换后保存
   

2 语料

• 今天天气
• 今天下雨吗
• 告诉我今天天气
• ……

2.1 语料分类

例句语料：由纯文本构成，可用鼠标选择其中的词来配置词槽和绑定实体、辅助词。 例：今天天气
优点：简单直观
缺点：易存在较多未绑定实体或辅助词的文本时，存在误吸收问题
模版语料：由{词槽}和文本构成，{}内为槽位，每个词槽都可以绑定实体或辅助词。 例：{time}天气
优点：可灵活配置语料构成，可一句语料实现多句式匹配
缺点：不直观，词槽命名需要注意和词槽的关联

意图中不能同时存在例句语料和模板语料，会导致无法正常命中。

语料类型区分 ：

2.2 语料编写

2.3 特殊符号功能介绍

• 今天天气
• 今天的天气

• 天气
• 今天天气
• 今天的天气

例句语料如需配置词槽可有可无，可将对应词槽转换为辅助词，并取消勾选表述必须。

3 词槽

实体和辅助词

实体

实体：就是词库，同一类型的词归纳为实体。
例：{city}实体包含北京、上海、广州
建议将以下词性的词设置为实体：名词、动词、形容词、数词、量词和代词

{
    //语义内容
  "semantic":[
    {
        //意图名称
      "intent":"QUERY",
      "slots":[
        {
           //实体名
          "name":"datetime",
          //词槽的命中词
          "value":"今天",
          //词条名或规整后取值，建议取该值进行逻辑处理
          "normValue":"{"datetime":"2018-01-22","suggestDatetime":"2018-01-22"}"
        },
        {
          "name":"location.city",
          "value":"帝都",
          "normValue":"北京市"
        }
      ]
    }
  ],
  //技能唯一标识
  "service":"weather",
  //识别文本
  "text":"查看帝都今天的天气",
  //展示或TTS播报内容
  "answer":{
    "text":""北京今天晴"，"-10℃ ~ -2℃"，"西南风微风""
  },
  "save_history":true
}

静态实体

用户说法：明天合肥天气怎么样、明天厦门天气怎么样
抽象为技能：{time} {localtion} 天气怎么样

动态实体

通配实体

{
  "slots":[
    {
      "name":"time",
      "normValue":{
          "datetime":"T15:00:00",
          "suggestDatetime":"T15:00:00"
      },
      "value":"下午三点"
    },
    {
      "name":"location",
      "normValue":"A1楼1407",
      "value":"A1楼1407"
    }
  ]
}

辅助词

• [帮我] (定一下)从 {合肥} 到 {广州} 的 (飞机票)
• [我要] (买一张)从 {合肥} 到 {广州} 的 (机票)
• [给我] (预约) 从 {合肥} 到 {广州} 的 (航班)

• {helpMe}{book}从{startCity}到{endCity}的{ticket}

必选属性

1、技能场景定义

1.1、 定义技能

1. 这个技能能做什么？为什么用户需要这个技能?
2. 用户在使用这个技能之前、当时、之后，会干什么？
3. 在这个技能中，有什么是用户不使用这个技能或使用别的技能得不到的？
4. 有什么信息是用户希望得到的？
5. 用户通过说/做什么能唤醒这个技能？
6. 哪一个功能点能直接支持这个技能？
7. 技能提供的信息是否需要从别的网页或应用中调用？

2、语料设计

2.1、简洁直白，亲切友好

1. 使用简洁、口语化语言。
   正确示范

• 用户：订今晚去北京的机票。
• 技能：今晚飞北京已经没有票了，要不要改坐高铁呢？

• 用户：订今晚去北京的机票。
• 技能：今晚去往北京的机票已无剩余，无法购买，可否改乘高铁？

1. 语料兼备幽默、风趣、委婉、温柔、俏皮的多重风格转换，增加生动活泼力。

• 用户：你最喜欢的人是谁
• 技能：欲把相思说似谁，当然是你呀~

• 用户：你最喜欢的人是谁？
• 技能：没什么喜欢的

1. 尽可能避免使用歉意词。

• 用户：打电话给爸爸
• 技能：通讯录中没有找到“爸爸”呢。

• 用户：打电话给爸爸。
• 技能：对不起，通讯录中没有找到“爸爸”。

1. 回应简洁，避免重复。
   正确示范

• 用户：帮我找手机。
• 技能：好的，请说一下你的电话号码哦。

• 用户：帮我找手机。
• 技能：感谢使用找手机技能，本技能可以通过拨打你的电话找到你的手机。现在说出你的手机号码，帮你拨打哦。

1. 尽可能只回复重点，省略无关消息。
   正确示范

• 用户：今天要带伞吗？
• 技能：今天北京雷阵雨，需要带伞哦。

• 用户：今天要带伞吗？
• 技能：今天北京雷阵雨，气温15~21度，空气湿度80%，记得要带伞哦。

1. 避免无意义交互。
   正确示范

• 用户：给我讲个笑话吧。
• 技能：（随机讲笑话）

• 用户：给我讲个笑话吧。
• 技能：你是要听笑话对吗？

1. 避免要求用户用特定的方式表达意图。
   正确示范

• 用户：明晚八点有个饭局。
• 技能：需要我帮你设置一个明晚八点的提醒吗？

• 用户：明晚八点有个饭局。
• 技能：如果你想设置提醒，请对我说：提醒我明晚八点有个饭局。

2.2、丰富多变，应变能力强

1. 答复多样化。

• 用户：红烧肉怎么做？
• 技能回复1：鱼香肉丝是道不错的美味呦，做法是这样的：…
• 技能回复2：做菜我最拿手哦，红烧肉的步骤是：…
• 技能回复3：帮你找到啦：…

2.3、以服务用户的核心意图为前提

• 用户：我想看新浪财经频道。
• （没有新浪财经频道的信源，但找到爱奇艺财经频道）
• 技能：没有找到新浪财经频道，可以看看爱奇艺财经频道。

• 用户：我想看新浪财经频道。
• （没有新浪财经频道的信源，但找到爱奇艺财经频道）
• 技能：为你找到爱奇艺财经频道。

2.4、清晰地给出选择

• 用户：帮我定杯拿铁。
• 技能：你是想要中杯还是大杯呢？
• 用户：大杯。

• 用户：帮我定杯拿铁。
• 技能：你是要中杯或者大杯吗？
• 用户：是的。

2.5、回应要为用户的 “耳朵” 服务

• 用户：火箭队和魔术现在比赛情况怎样？
• 技能：火箭队目前得分66，魔术队目前得分54，比赛进行到第三场。

• 用户：火箭队和魔术现在比赛情况怎样？
• 技能：火箭（65-17-1）66，魔术（25-57-0）54，第三场，剩余时间 5:24。

2.6、兜底语料

• 用户：红烧肉怎么做？
• 技能回复1：我突然想不起来了，问我别的菜呗。
• 技能回复2：脑袋空空，咱们换个菜吧。

• 用户：红烧肉怎么做？
• 技能：我没听清，能再说一遍吗？

2.7、考虑用户关闭数据获取的情况

• 用户：今天天气怎样？
• 技能：请问你现在在哪个城市？
• 用户：我在北京。
• 技能：今天北京天气晴朗，气温为15~21度。

• 用户：今天天气怎样？
• 技能：你还没授权定位数据，无法使用天气查询哦。

3、多轮对话设计

3.1、首先列出最短的对话路径

3.2、将备选路径和决策树列举出来

3.3、概括出系统逻辑

3.4、对话中加入引导语

1. 提示用户何时需要提供更多信息。
2. 一次只要求一个信息。
3. 给用户提供选择，但尽量不要给出三个以上的选项。
4. 向用户确认他的选择和重要信息。
5. 传达多个信息时应通过“第一步”、“然后”、“最后”等序列词便于用户理解。

3.5、汇总选择

• 用户：帮我订今天去北京的机票。
• 技能：好的，请说出发地点。
• 用户：广州
• 技能：好的请说起飞时间段。
• 用户：中午十二点之后。
• 技能：好的，你需要订X月X日，中午十二点后，从广州飞往北京的航班对吗？
• 用户：是的。
• 技能：好的，为你找到…

• 用户：帮我订今天去北京的机票.
• 技能：好的，请说出发地点。
• 用户：广州。
• 技能：好的，请说起飞时间段。
• 用户：中午十二点之后。
• 技能：好的，为你找到….

3.6、处理潜在需求

3.7、精细化拆分

• 用户：成语接龙
• 技能：已为你打开成语接龙，你可以选择你先开始或者我先开始，不想玩了请对我说“退出”。
• 用户：你先开始。
• 技能：好的，那我先来咯~ 和风细雨。
• 用户：雨过天晴。
• 技能：真棒，回答正确，再接再厉。下一个，雨过天晴。
• 用户：熠熠生辉。
• 技能：你的回答不正确哦，再试一次吧~
• 用户：提示一下吧
• 技能：好的，雨过天晴可以接晴天霹雳。
• 用户：换一个吧
• 技能：如果你想重开一局，可以对我说“重来”。

• 用户：打开成语接龙
• 技能：和风细雨
• 用户：雨过天晴
• 技能：晴天霹雳
• 用户：熠熠生辉
• 技能：你的回答不对哦，再试一次~
• 用户：提示一下吧
• 技能：我好像没听懂…
• 用户：换一个吧
• 技能：我好像没听懂…

3.8、无响应时主动反馈

• 用户：我想查天气。
• 技能：请问要查哪个城市的天气呢？
• 用户：天气热要多喝水。
• 技能：这个没听清呢，请你说出要查天气的城市名哦。

• 用户：我想查天气。
• 技能：请问要查哪个城市的天气呢？
• 用户：天气热要多喝水。
• 技能：这个没听懂，自动为你退出技能。

4、发布技能

4.1、确保服务稳定可靠

4.2、技能信息有标识度

4.3、技能描述简洁易懂

技能接入审核规范

目 录

1. 技能名称和别名
2. 图标
3. 描述
4. 技能内容
5. 审核时效

1、技能名称和别名

• 名称长度应介于2-8个字之间，不能包含特殊字符。若名称中包含英文可能会造成用户无法进入你的技能。
• 我们不建议名称使用生僻字、生僻词组，否则用户会因为不会读而无法进入你的技能。
• 名称中不能包含AIUI中用于进入技能的词汇，如：“打开”，“启动”，“进入”等。
• 名称中不能包含AIUI的通用唤醒词，如：“小飞”、“蓝小飞”、“小飞小飞”、“来小飞”等。
• 名称中不能包含AIUI常用指令，如：“查天气”，“我要听歌”，“打开空调”等。
• 为了减少重复，技能名称不得以电话、邮件、日历等广义归纳类、普遍且不具有识别性词语来命名。
• 技能名称、功能涉及第三方企业或产品的信息或其他内容时，需要有其相关方面的授权。
• 技能名称不得侵犯第三方知识产权（包括版权、商标和宣传权）。

2、 图标

• 建议尺寸为 480 x 480 的 png 或 jpg 图片。
• 像素清晰，无水印。
• 避免图标存在透明区域或者白边，避免文字过多。
• 不可涉及版权问题。
• 具体可查看技能图标图片规范

3、描述

• 详细描述功能，至少10个字，不超过200个字。
• 技能名称、摘要、功能描述与实际应用应有直接关联。
• 可以在描述信息中提供更多技能内的常用表达示例，为用户快速了解技能功能。

4、技能内容

• 保证技能的后端技能稳定可靠，快速响应用户请求，达到用户良好的使用预期。
• 运用日常用语，简洁直白，语气友好。
• 技能交互中涉及到与技能名称相关的内容，需与技能名称保持一致。
• 适用于技能的实际使用场景，可以成功调用功能。
• 技能内容不得侵犯第三方知识产权（包括版权、商标和宣传权）。
• 技能内容不能违反现有法律规范，不得出现粗俗，暴力，色情，反动等语句。
• 技能相关链接不得包含非法信息。

5、审核时效

• 审核一般会在提交审核后的3个工作日内完成，审核结果会通过短信的方式通知你。
• 若长时间未审核通过，或对审核结果有异议，可在平台上提交工单进行反馈。

技能图标图片规范

• 480px * 480px 大小
• 正方形无倒角
• 无透明像素
• 在圆形框内完整呈现logo主体