【8.4升级】对话API接口3.0上线
置顶
夏天再见777 发布于2021-08-04 浏览:1701 回复:8
2
收藏
最后编辑于5天前

对话API作为UNIT平台的基础服务,也是广大开发者使用UNIT的核心功能,本次迎来了3.0版本的更新升级,接下来将为大家介绍本次更新升级的亮点~

 

统一机器人与技能对话API

对话API接口3.0,不再使用两种接口区分调用技能和机器人,已经将二者统一为一个接口,通过传入不同的参数进行机器人或技能的调用。

对话API接口3.0文档:https://ai.baidu.com/ai-doc/UNIT/qkpzeloou

1、 只传入skill_ids(技能ID),可以调用一个或多个技能。

2、 只传入service_id(机器人ID),调用某一个机器人(调用该机器人下的所有技能)。

3、 同时传入service_id和skill_ids,调用某一个机器人下的一个或多个技能。

 

简化输入和输出字段

对话API接口3.0大幅简化了字段,输入和输出整体下降70%,且由接口2.0迁移至接口3.0成本较低。

1、精简可选请求参数。比如bot_views、dialog_state等一些不需要的参数在3.0中已经去掉。

2、优化返回数据格式。调整了一些特殊格式(比如string(json)),不再有转为字符串类型的json数据。当前统一的KV层级结构更清晰,更方便获取所需的参数。每个参数都有其明确的作用,比如:schema保存当前语句的意图、词槽解析结果;actions保存答复信息; slots_history保存所有的词槽信息。

3、简化session数据 。更新前的技能对话接口,返回用于多轮对话的bot_session数据太多,内容冗杂,3.0只返回session_id,字段简洁明了。

 

兼容两种接口的TaskFlow机器人

1、接口兼容。区分新老用户,对于老用户2.0接口仍继续保持,同时可切换至3.0接口,新用户默认不再显示2.0接口。

2、编程模式升级。内置了更多变量、函数和Python包,以支持开发者更复杂的业务需求;Python版本从2.7.3升级到3.8.5。

3、不同接口版本对应不同的对话API版本。

     文档链接:https://ai.baidu.com/ai-doc/UNIT/Bkq6hce7t

 

对话API接口3.0当前已更新上线,欢迎大家根据自己的需求测评和反馈哦~

指路链接:unit.baidu.com

 

收藏
点赞
2
个赞
共8条回复 最后由unit_internal9回复于5天前
#5unit_internal9回复于5天前
#3 Lynn李媛回复
请问2.0还能用吗?知秋改规则了,3.0不适配了啊qvq

2.0可以继续使用,但是建议使用3.0接口,修改请求参数和返回数据的内容即可,参考:https://ai.baidu.com/ai-doc/UNIT/qkpzeloou

0
#4unit_internal9回复于5天前
#2 jonerxq回复
改变意图的传参数,怎么是无效的参数类型: [代码]

updates需要转成字符串,参考:https://ai.baidu.com/forum/topic/show/968762

0
#3Lynn李媛回复于8天前

请问2.0还能用吗?知秋改规则了,3.0不适配了啊qvq

0
#2jonerxq回复于12天前

改变意图的传参数,怎么是无效的参数类型:

{
"log_id": "96ee652f-22cd-4a96-a9bd-c081934fbf66",
"request": {
"query": "你好",
"updates": {
"type": "DEFINE",
"ops": [
{
"op": "DEFINE",
"target": "INTENT",
"value": "天气"
}
]
},
"terminal_id": "88888"
},
"session_id": "b0350301-0968-47fe-956b-2e2d4c537161",
"version": "3.0",
"service_id": "S61311"
}
0
TOP
切换版块