自定义问答

语音问答（Q&A）是语音技能的简单版。不同的是，语音问答中的每一个用户输入，系统回复是确定的（可能是一个或者多个），不存在过多的逻辑处理。 举例
用户 ：你多大了？ 讯飞 : 我还小 / 不告诉你 / 我已经两岁了 用户 ：你是谁 ？ 讯飞 ：我叫叮咚 / 我是聪明的机器人

设备人设

什么是设备人设

通过配置年龄，性别等属性值与回复语，让产品拟人化。 
  1. 用户：你多大了？
  2. AIUI：我今年6岁

创建设备人设

在技能工作室的【设备人设】中创建。

问答 - 图1

默认人设蓝小飞不可删除，用户可在“蓝小飞”基础上编辑，也可以新建人设。新建人设的属性值默认开启且为空。

属性值与回复

设备人设有46种属性，分类为基础信息，联系方式，社会关系等。我们为每种属性配置了系统问法与回复。其中问法由AIUI定义，在页面中只展示了3种示例问法，回复则分为两种情况，属性值为空或非空：

问答 - 图2

问答 - 图3

如上图，当姓名的属性值为空时，系统回复：“这可是个秘密哦”；当属性值非空时，则会将属性值以参数的形式带入系统回复之中：“我叫{name}，是你的家庭小助理”等等，这里的{name}值=“小叮当”。需要注意的是，这里的系统回复也只展示3条示例回复，实际回复不止这些，当用户语料命中人设后，系统将会从众多的系统回复中随机返回一条给用户。 若系统回复不能满足开发者的个性化需求，可以采用自定义回复的形式。自定义回复不支持参数，只支持文本。 每个属性最多30条自定义回复，每条回复最多100字符。

输入建议

部分属性支持多个值，用空格键分隔 部分属性有关联关系，如果在【生日】属性中选择【具体日期】，系统会自动算出【年龄】【星座】【生肖】。

使用设备人设

设备人设默认关闭，引用步骤：【我的应用】-【应用配置】-【语义理解】-【管理技能配置】-【设备人设】

问答 - 图4

设备人设优先级：自定义技能>自定义问答>设备人设>商店技能
admin 2022年12月31日 18:51 转发文档 收藏文档

上一篇

下一篇

语义协议：重要字段和通用字段

消息格式

交互返回数据为JSON格式: 点击查看示例

应答消息字段定义

字段名称 字段类型 是否必须 说明
rc int 是 语义理解结果 0（成功） 1（输入异常） 2（系统内部异常） 3（业务操作失败，没搜索到结果或信源异常） 4（说法未命中技能）
error Object 否 错误信息
text String 是 用户的输入，可能和请求中的原始text不完全一致，因服务器可能会对text进行语言纠错
vendor String 否 技能提供者，不存在时默认表示为IFLYTEK提供的开放技能
service String 是 技能的全局唯一名称，一般为vendor.name，vendor不存在时默认为IFLYTEK提供的开放技能。
semantic Object 否 语义信息，每个技能自定义
data Object 否 数据结构化表示，各技能自定义
answer Object 否 对结果内容的最简化文本/图片描述，各技能自定义
dialog_stat String 否 用于客户端判断是否使用信源返回数据
moreResults Object 否 在存在多个候选结果时，用于提供更多的结果描述
shouldEndSession Boolean 否 当该字段为空或为 true 时表示技能已完成一次对话，如果为 false 时，表示技能期待用户输入，远场交互设备此时应该主动打开麦克风拾音
category String 是 技能类别
version String 否 版本
uuid String 是 （历史字段，请忽略）同sid
used_state Object 是 （历史字段，请忽略）交互使用状态
state Object 是 （历史字段，请忽略）交互状态
sid String 是 会话id，用于标识会话，调试时提供给讯飞帮助定位问题
save_history Boolean 否 是否有会话历史

语义semantic

意图的描述信息，通过该字段定位用户意图，并获取意图图参数，实现技能逻辑处理。 semantic字段说明：
字段名称 字段类型 是否必须 说明
intent String 是 技能中的意图
slots Object 是 参照后续不同技能的定义
slots字段说明：
字段名称 字段类型 是否必须 说明
name String 是 槽位名
value String 是 槽位值

Data字段

该字段表示应答结果，如果应用本身没有数据源，可以直接选择该结果解析和展现，无需处理语义信息。
字段名称 字段类型 是否必须 说明
header String 否 导语部分
result Object 否 结构化数据；如果没有查到数据，此字段不返回。参照后续不同技能的定义

简化图文结果表示

对于一些技能，支持直接返回一段文本应答结果，同时辅助一张图片和相关链接。应用可以无需解析和提取语义/结果的结构化数据信息，直接显示该字段的图文信息。同时用户可以选择通过开放平台编辑和上传/导入图文应答信息，快速自定义扩展应用交互。
字段名称 字段类型 是否必须 说明
“answer”
type String 否 显示的类型，通过这个类型，可以确定数据的返回内容和客户端的显示内容，默认值为 T 。 T：text数据 U：url数据 TU：text+url数据 IT：image+text数据 ITU：image+text+url数据
text String 是 通用的文字显示，属于text数据
imgUrl String 否 图片的链接地址，属于image数据
imgDesc String 否 图片的描述文字
url String 否 url链接
urlDesc String 否 url链接的描述文字
emotion String 否 回答的情绪，取值参见附录的情感标签对照表

moreResults结构表示

技能后处理协议：Request_v2.1协议

自定义技能开发包括以下步骤：
  • 处理AIUI发送的不同类型的请求
  • 在返回完整回复前选择性地发送一些信息给用户，比如告诉用户系统正在处理中
  • 对用户的请求返回合适的回复

请求校验

请求校验可以保障数据安全。
  • 每一个AIUI发送的请求均包含一个application_ID，你需要检查这个ID是否和你的技能ID相同；
  • 所有发送给技能的请求Header都包含Signature字段（校验步骤）
当请求不符合以上两点，你应该返回HTTP CODE: 400.

HTTP头

技能资源限制

技能限制

项目 限制
技能个数 20个
一个技能下的意图数 40个
一个意图下的提问语料数 500个
一个技能下的槽位数 60个
一个意图下的槽位数 40个
技能导入/导出次数 导入：10次/天

问答库限制

项目 限制
问答库个数 40个
一个问答对问题数 40个
一个问答对答案数 20个
一个问答库下的问答数 20000个问答对或50000个问题
问答库导入的文件大小/导入次数 文件大小：<5M 导入次数：30次/天

实体

项目 限制
实体个数 40个
一个词条类实体下的词条数 20000个
实体导入的文件大小/导入次数 <5M 30次/天
一个动态实体下的资源数 5个
签约客户可联系技术支持，免费提额。
admin 2022年12月29日 14:50 转发文档 收藏文档

上一篇

下一篇