上传知识库

最近更新时间:2019-08-30 15:01:32

功能描述

第三方为指定的机器人导入知识库信息,小微客服机器人后台会使用训练后的模型对导入的知识库信息进行处理,生成可进行查询的数据信息。
上传知识库有两种方式,第一种通过 Rest API 的批量上传协议,单次最多上传 20 条。第二种是通过 excel 文件形式上传,单次最多上传1000 条。
知识库问题字段最大长度 341 个汉字;答案 682 个汉字。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet/upload_qa?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

URL 详细字段说明请参阅 URL 字段说明 文档。

请参数

字段名称 描述 类型 必填
botid 机器人唯一标识,由用户指定 String
auth 第三方账号认证信息,用作回调验证第三方账号合法性 String
qa_list 知识库列表,单次最大 20 条 String
same_question 相似问题列表 String
question 问题 String
answer 答案列表 String

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String
total_num 总上传条数 String
succeed_num 成功条数 String

示例

请求示例

https://yun.tim.qq.com/v3/prophet/upload_qa?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

{
    "botid": "bot_identifier", 
    "auth": "", 
    "qa_list":
    [
        {
            "same_question": ["question1", "question2"],
            "question": "问题",
            "answer": ["answer1"]
        },
        {
            "same_question": ["question1", "question2"],
            "question": "问题",
            "answer": ["answer1"]
        }
    ]
}

响应示例

{
    "ActionStatus": "ok", 
    "ErrorCode": 0, 
    "ErrorInfo": "",    
    "total_num": 20, 
    "succeed_num": 20
}