## 8.1 常见概念 本节针对开发过程中常见的名词,给出了明确的解释。 ### 8.1.1 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/cddad5bfaf9e745da5b9e85cc298f398/9.png) + 数据统计:每日更新用户数据,提供多种统计图表,便捷查看分析用户增长情况。其中包含数据概要(用户总数、新增用户、活跃用户数、新增交互数、人均交互数、新增用户/活跃用户)技能插件调用情况、趋势图。 + 粉丝管理:实时更新用户消息与回复,零距离观测用户问答体验。粉丝管理用户包含消息列表、用户个人问答对详情,其中每个问答对包含用户说,微信/硬件机器人答、以及此问答对的json详情,意图的准确率、以及意图的编辑修改(系统插件除外)和智能语音纠错。 + 机器人:ruyi.ai 语义理解平台提供语义理解服务的模块。 + 对话场景:针对某一特定场合、用户下的意图组。 + 意图:终端用户在对话过程中,潜在表述的目的,其主要负责将自然语言转化为如意开发者平台具体动作。 + 词典实体:在如意语义理解平台上,词典指词典实体,即相同类型实体的集合。词典分系统词典和自定义词典,它们都是用来表达同一类型的词语。例如,“1、2、3……”这些实体表达的都是“数字”。当编写用户说时,同类型的词语可被词典所代替。并且词典条目的值可在“机器人答”中引用或者通过暗号传递给其他意图。因此,学会灵活运用词典,就能减少编写用户说的时间与成本。 + 导入知识库:支持按照示例导入问答对,导入纠错问答对,导入、导出词典。 + 机器人设置:包括属性设置、触发器设置、微信授权三部分。 * 属性设置:包含机器人名称、机器人类型、机器人描述设置以及机器人的姓名、语音纠正、性别、生日、父母亲信息等基本属性和缺省回复的设置。 * 触发器设置:触发器是在实体解析、意图识别之后,根据识别的意图和解析的实体进行自定义逻辑处理的功能接口。它可以获取解析到的实体作为参数,在此基础上进行开发,并把结果加入 ruyi.ai 语义接口的返回结果中。 * 微信授权:用户可通过微信授权引用微信后台资源,授权包括用户管理权限、素材管理权限、消息管理权限等。 + 提交发布技能:开发了技能插件后,可以发布机器人至如意技能插件商店,同时支持一键发布到合作平台,让开发者的知识和能力以技能插件的形式,为更多的bot产品赋予能量,影响更多的人。 + 技能商店:ruyi.ai为通用场景设计的开放服务,只需要获取希望在机器人中使用的服务,机器人便可获得相应领域的服务能力。目前,技能商店有70多个技能插件,包含了官方自有技能插件,如闹钟、天气、百科等;官方开发的第三方技能插件,如豆果菜谱等;由开发者开发的第三方技能插件,如佛学人物等。 + 素材管理:在素材管理中添加的图片、音频、视频素材可在意图详情页中被引用,用来作为问题的回答。开发者后台的素材管理针对于硬件端产品,如使用微信端需在相应的公众号后台进行素材的编辑,之后在机器人答中直接引用。 + 试一试:写好的意图可以在这里试试看,开发人员可以在此查看json代码。试一试的时候注意微信端和硬件端的选择。 ### 8.1.2 意图编辑页面 + ①用户说:触发当前意图的自然语言话术,用于后台意图匹配模型训练。可添加多种说法,当用户说的话与其中一个说法匹配时,触发意图。同一意图中的多条用户说可以拖拽排序,自上而下优先级逐条递减。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/8fbaec4b6369757ad94381443925d4da/3-2-1.png) + ②机器人答:机器人返回给终端用户的信息,机器人答支持多种回答方式,可以返回文本、图片、音频、视频、图文(仅限于微信)。支持添加多条回复、多条文字或多媒体回答,意图被触发时会回复每一项回复中的随机一条。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/5c44e916cf8c4de957370944b7c7fd5a/回复0.png) + ③接受暗号:如果意图A接受了一个暗号X,意味着:1、意图A可以使用暗号X携带的词典条目的值;2、如果没有存活的暗号X存在,意图A不可能被触发。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/77fbf4cf79f2237bcc84c29272275066/3-2-3.png) + ④发出暗号:如果意图A发出了一个暗号X,意味着: 只有意图A被触发后,才会发出暗号X; 暗号X会携带意图A中所有在意图处理中进行了配置的词典条目。 在没有意图重新发出暗号X的情况下,暗号X会存活N次对话,N取决于X的生命周期,默认为1。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/c741fd4979e748f6c01a784bd0303218/3-2-4.png) + ⑤意图处理:词典条目的配置。在这里我们对引用的词典进行配置。包含名称,值,类型,和默认值的配置。其中如果意图使用到暗号,则需要在值的部分以“#接受暗号的名称.名称”的格式去完成值的传递。如果要在机器人答中引用词典的值,则需要在机器人答中以“&名称(切记后面要加空格)”来引用。另如果勾选了“是否必须”,那么则需要添加提示语,每个必须词条的循环周期为3,3次过后自动跳出流程,3次之内则会根据提示语进行询问。必须词条满足一些特定场景的需求。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/f4192f7565daa0b73cee37191b83eb85/3-2-5.png) + ⑥事件:事件为除自然语言以外触发意图的第二种方式,用户可以特定行为触发意图,进入对话。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/e9ceeece0bf2b9b954bb88ea1b91bb62/10.png) + ⑦触发器:如意语义理解平台提供了经典的“用户说”、“机器答”形式的问答对编辑,并提供了实时生效的自定义词典实体编辑,以及可以通过暗号控制的多轮对话等。但是当客户希望自定义实现一些复杂的功能时,那么就需要给意图开发相应的触发器。触发器是在实体解析、意图识别之后,根据识别的意图和解析的实体进行自定义逻辑处理的功能接口。它可以获取解析到的实体作为参数,在此基础上进行开发,并把结果加入如意语义接口的返回结果中。如果第三方接口返回的数据不满足需求,还可以对第三方数据进行进一步逻辑处理,触发器上填入“包装”后的接口url即可。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/28792e0ea98e9d11643e1426f348e3a7/3-2-6.png) + ⑧意图优先级:共有5个等级,当用户说可以同时触发多个意图时,可以调整意图优先级确保触发到正确意图。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/b90dfe6a715f3900dab9fdce82bd0230/3-2-7.png) + ⑨机器学习:开启机器学习后,针对意图和导入问答对中的“用户说”里已经撰写的句子,自动识别更多说法,扩大意图识别范围。 ![](http://gitlab.ruyi.ai/ruyi-ai/ruyi-fuwu/uploads/ccb55e8c31ab5f17ad0fc252208dbd89/3-2-8.png)