本帖帮助初级开发者在零代码情况下体验和调用对话API进行对话,共设置了3个任务及其教程,大家可按需浏览。
- 任务一、成功调用一次技能对话API
- 任务二、使用 技能对话API 实现多轮对话
- 任务三、使用 机器人对话API 实现多轮对话
阅读前,需要开发者对以下内容有初步的了解:
- 技能对话API:https://ai.baidu.com/docs#/UNIT-v2-API/top
- 机器人对话API :https://ai.baidu.com/docs#/UNIT-v2-service-API/top
一、成功调用一次技能对话API
初次调用对话API我们需要完成3步(1.在百度智能云“产品服务 / 理解与交互技术UNIT”中创建应用、2.利用这个应用的API Key和Secret Key获取请求技能的Access Token、3.携带Access Token请求技能对话API)
1.首先下载并安装测试API 测试工具-postman( https://www.getpostman.com/downloads/ )
2.接着创建应用:进入百度智能云“产品服务 / 理解与交互技术UNIT”( https://console.bce.baidu.com/ai/?_=0&fromai=1#/ai/unit/app/list ),点击“创建应用”,输入应用名称并完成创建,获得应用的API Key和Secret Key。
3.然后获取Access Token:打开安装好的postman,设置请求方式为POST,并输入以下请求链接:
https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=API Key&client_secret=Secret Key&
(API Key和Secret Key的值来源于第2步创建好的应用)
点击蓝色的“Send”按钮,发送请求后会收到响应,响应中有我们需要的access_token的值。
4.最后调用技能对话API:在postman中新建一个页面,设置请求方式为POST,并输入以下请求链接:
https://aip.baidubce.com/rpc/2.0/unit/bot/chat?access_token=access_token
(access_token的值来源于第3步获取到的值)
点击蓝色的“Send”按钮,发送请求后会收到响应,响应中如果出现282008错误(非法请求内容错误类型),表明我们成功调用了技能对话API,接着提供您在unit平台已经训练成功的技能ID,然后在postman中填写如下请求Body:
{
"bot_session": "",
"log_id": "1234567890",
"request": {
"bernard_level": 1,
"query": "预订火车票",
"query_info": {
"asr_candidates": [],
"source": "KEYBOARD",
"type": "TEXT"
},
"updates": "",
"user_id": "1234567890"
},
"bot_id": "52708",
"version": "2.0"
}
(query是用于测试的语句,bot_id是您用于测试的技能ID)
再次点击蓝色的“Send”按钮,发送请求后会收到响应,如果响应中出现了模型解析结果,表明我们成功请求了技能模型。
以上,我们成功调用了技能对话API,接着我们利用技能对话API的session_id字段实现多轮对话。
二、使用 技能对话API 实现多轮对话
历史会话信息bot_session会在平台中保留2小时,当前请求中的bot_session.session_id的值与保留中的某个会话相同时,当前会话将继承历史会话的意图和词槽信息以及对话状态,来实现多轮对话。
下面举例说明:要实现以下的多轮对话效果,需要请求2和请求3中session_id的值来源于响应1。
- 请求1:预订火车票
- 响应1:你想什么时间出发
- 请求2:明天早上
- 响应2:请告诉我您的目的地
- 请求3:北京西站
- 响应3:正在为您预订车票
可以使用以下两种方式传入session_id值:
- 您可以单独上轮响应的session_id值,由于bot_session字段的类型是string,传入K-V结构的数据需要先转化成json字符串,然后需要对该json字符串转义成string类型后传入该字段,例如:"bot_session": "{\"session_id\":\"value\"}"
- 也可以传入上轮响应完整的bot_session值,上轮响应的bot_session值已经是转义好的数据,不需要开发者再次进行转义。
二、使用 机器人对话API 实现多轮对话
1.调用技能对话API:在postman中新建一个页面,设置请求方式为POST,并输入以下请求链接:
https://aip.baidubce.com/rpc/2.0/unit/service/chat?access_token=access_token
(access_token的值来源于 任务一 第3步 获取到的值)
接着提供您在unit平台创建好的机器人ID(机器人需要添加已经训练成功的技能),然后在postman中填写如下请求Body:
{
"log_id":"1234567890",
"version":"2.0",
"service_id":"S17842",
"session_id":"",
"request":{
"query":"预订火车票",
"user_id":"1234567890"
},
"dialog_state":{
"contexts":{
"SYS_REMEMBERED_SKILLS":[
""
]
}
}
}
(service_id是您用于测试的机器人,query是用于测试的语句,)
点击蓝色的“Send”按钮,发送请求后会收到响应,如果响应中出现了解析结果,表明我们成功调用机器人API并成功请求了技能模型。
2.实现对轮对话:要实现以下的多轮对话效果,需要请求2和请求3中session_id的值来源于响应1,且dialog_state.contexts["SYS_REMEMBERED_SKILLS"]的值为需要进行多轮对话的技能ID,避免对应技能session被清空,导致无法完成多轮对话。
- 请求1:预订火车票
- 响应1:你想什么时间出发
- 请求2:明天早上
- 响应2:请告诉我您的目的地
- 请求3:北京西站
- 响应3:正在为您预订车票
多轮对话挺好的,期待应用到实际场景中
多轮对话啊
谢谢分享,小白学习了