1. 知识库通用API
用于维护知识库中的专业问答
1.1. 查询标准问题列表
/knowledge/common/queryStandQuestionList
接口描述
根据关键字调用引擎服务相关接口,获取标准问题列表
调用协议
HTTPS GET
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
productId | String | 是 | 应用ID |
keyword | String | 是 | 关键词 |
size | Number | 否 | 查询条数,默认5条 |
响应参数
参数 | 类型 | 说明 |
---|---|---|
question | Number | 查询到的标准问题 |
answer | String | 问题答案 |
questionId | String | 查询到的标准问题的ID(根据配置,使用小钛问题ID或外部平台问题ID) |
answerId | Number | 问题答案ID |
score | Number | 相关度,分值越高相关度越高 |
返回示例
HTTPS 200 OK
{
"code": 0,
"data": [
{
"question": "购物小票有什么用",
"questionId": 1731958,
"answerId": 1188636,
"answer": "购物小票,就是在收银台支付成功之后,商场开局的小票。有的可以凭小票后期补发票。一定要仔细阅读小票的内容。有的小票就直接说明哪些东西不予退换喔哈。",
"score": 4.0206895
}
],
"msg": "success"
}
1.2. 专业问答-编辑知识库
/knowledge/common/updateConversation4Open
接口描述
编辑知识库,相似问法更改,将以先全部删除再重新批量写入的方式进行
调用协议
HTTPS POST
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
productId | String | 是 | 应用ID |
id | String | 是 | 问题ID |
questionType | String | 是 | 问答属性 1: 闲聊对话,2: 专业问答 |
answerText | String | 是 | 问题答案,长度 < 6000 |
topicLevels | String Array | 是 | 分类,格式:默认分类 [],一级分类 ["xxx1"] 二级分类["xxx1","xxx2"] |
associateQuestions | String | 否 | 关联问题:json 字符串,questionType 为2时可能用到,例如:[1731730,1731732] |
similarQues | Object Array | 否 | 相似问题列表,questionType 为2时可能用到,例如:{"question":"退货要求","openQuestionId":"xxx"},{"question":"不满意可以退换货的吗","openQuestionId":"xxx",} |
date | String | 否 | 有效期,0:永久有效,1:期限有效,2:停用questionType 为1时可能用到,例如{"type":2},{"type":0},{"type":1,"start":"2018-12-06 16:41:40","end":"2018-12-06 16:41:40"} |
响应参数
参数 | 类型 | 说明 |
---|---|---|
id | Number | 问题ID |
question | Number | 标准问题 |
answer | String | 问题答案 |
editor | String | 编辑人员 |
editTime | Number | 编辑时间 |
返回示例
HTTPS 200 OK
{
"code": 0,
"data": {
"id": 1,
"question": "什么是微证券fff",
"answer": "wwwwwwww",
"editor": "elonchen",
"editTime": "2017-07-28 20:15:30"
},
"msg": "success"
}