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"
}

results matching ""

    No results matching ""