1. 知识库问题学习API
从用户真实语料学习新的机器人知识库语料
问题学习-添加为新问题
/knowledge/learning/addQuestionAsStand
接口描述
(开放接口)需配合标准问题查询接口。先执行问题在知识库的存在校验,再执行问题入库,然后从问题列表删除
调用协议
HTTPS POST
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
productId | String | 是 | 应用ID |
type | Number | 是 | 问题类型1,相似问题学习2,未知问题学习 |
questionId | Number | 是 | 待学习的问题id |
openQuestionId | Number | 否 | 外部平台标准问题Id,默认-1 |
question | String | 是 | 标准问题 |
answer | String | 是 | 标准问题答案 |
返回示例
HTTPS 200 OK
{
"code": 0,
"data": "ok",
"msg": "success"
}
问题学习-添加为相似问题
/knowledge/learning/addQuestionAsSimilar
接口描述
(开放接口)需配合标准问题查询接口。先执行问题在知识库的存在校验,再执行相似问题添加,然后从问题列表删除
调用协议
HTTPS POST
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
productId | String | 是 | 应用ID |
type | Number | 是 | 问题类型1,相似问题学习2,未知问题学习 |
questionId | Number | 是 | 待学习的问题id |
openSimilarQuestionId | Number | 否 | 外部平台标准问题Id,默认-1 |
standId | Number | 是 | 标准标准问题Id,内外部问题Id均可以,小钛将依据签名参数source判断使用,统一转化为内部Id问题答案 |
返回示例
HTTPS 200 OK
{
"code": 0,
"data": "ok",
"msg": "success"
}
问题学习-查询具体会话信息
/knowledge/learning/getSessionListById
接口描述
根据学习列表的sessionId获取会话信息
调用协议
HTTPS GET
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
productId | String | 是 | 应用ID |
sessionId | Number | 是 | 会话Id,待学习问题列表接口返回的idList字段中的某一个 |
query | Number | 是 | 待学习的问题 |
响应参数
参数 | 类型 | 说明 |
---|---|---|
id | Number | 消息id |
listKey | String | 咨询用户身份编号 |
openId | String | 用户uuId,H5渠道自行生成,公众号渠道使用用户微信openId |
name | String | 用户名称 |
isFirst | Number | 是否用户首条消息,已废除,可忽略,0:不是,1:是 |
sessionId | Number | 服务单Id,若来自服务单则值>0 |
commentId | Number | 留言单Id,若来自留言单则值>0 |
role | Number | 角色,0:系统,1:管理员,2:客服,3:用户,4:机器人,9:超级管理员 |
headUrl | String | 用户头像地址 |
msgType | Number | 消息类型,0文本,1图片,2,富媒体,最新默认都为富媒体类型 |
content | Number | 消息内容 |
mediaId | String | 公众号多媒体消息Id |
extInfo | String | 扩展信息,可忽略 |
productId | String | 扩展信息,可忽略 |
date | DateTime | 扩展信息,可忽略 |
channel | Number | 消息来源渠道-1:未知渠道,0:openApI,1:公众号,2:pc网站,3:移动网站,4:企业微信 |
返回示例
HTTPS 200 OK
{
"code": 0,
"data": [
{
"id": 23351,
"listKey": "102598:1:ogud109MV-_9DggP2KJYQzO_u_wA",
"openId": "ogud109MV-_9DggP2KJYQzO_u_wA",
"name": "8S",
"isFirst": 0,
"sessionId": 4786,
"commentId": -1,
"role": 3,
"headUrl": "http://thirdwx.qlogo.cn/mmopen/Q3auHgzwzM61aWfkkgJ7HaT6rZibvce2hUeskuoYnd4bk3aFYjPVRIrICdTKSMv91HboGkSGepy1SXm2A40mBibRJYRpfpbrcojatugHavcaY/132",
"msgType": 2,
"content": "2",
"mediaId": "0",
"extInfo": "1",
"date": "2018-05-09 15:56:09",
"productId": 1,
"channel": 1
}
],
"msg": "success"
}