【对话API】用工具调用对话API并实现多轮对话
TroubleMaker源 发布于2019-05 浏览:25809 回复:23
13
收藏
最后编辑于2022-12

本帖帮助初级开发者在零代码情况下体验和调用对话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:正在为您预订车票

收藏
点赞
13
个赞
共23条回复 最后由灬小魂淡回复于2022-12
#4177******01回复于2019-05

多轮对话挺好的,期待应用到实际场景中

0
#3liguanghui2588回复于2019-05

多轮对话啊

0
#2177******01回复于2019-05

谢谢分享,小白学习了

0
TOP
切换版块