登录
基础
连接微信
办公目录
应用在专区的程序可调用本系列接口管理专区知识集。
服务商最多为一个应用创建100个知识集
一个知识集最多可以有1000个內容（本地文件或网页链接）
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 需具备「数据与智能专区-知识集」权限 |
| 代开发应用 | 需具备「数据与智能专区-知识集」权限 |
| 第三方应用 | 需具备「数据与智能专区-知识集」权限 |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名:
knowledge_base_list
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"kb_info_list": [{
"kb_id": "KBID",
"kb_name": "NAME"
}]
}参数说明:
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 错误码描述 |
| kb_info_list | 知识集信息列表，详见KBInfo说明 |
KBInfo说明:
| 参数 | 说明 |
|---|---|
| kb_id | 知识集ID |
| kb_name | 知识集名称 |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_create
每个企业的知识集总数量不能超过1000
请求包体：
{
"kb_name": "知识集名",
"doc_list": [{
"doc_name": "客服问答.pdf",
"type": 2,
"file_media_id": "MEDIA_ID"
},
{
"doc_name": "百度一下，你就知道",
"type": 101,
"web_url": "http://www.baidu.com"
}
]
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_name | 是 | string | 知识集名 不少于1个字符 不多于20个字符 |
| doc_list | 是 | obj[] | 內容列表 可填充个数：1 ~ 100 |
| doc_list.doc_name | 是 | string | 內容名，如果是文件，需要有准确的文件名后缀 不多于200字节 |
| doc_list.type | 是 | uint32 | 內容类型 取值范围： 2 - pdf 4 - xlsx(用于上传问答对表格，需从管理端下载模版配置后上传) 5 - doc 6 - docx 101 - 网页链接 |
| doc_list.file_media_id | 否 | string | 专区临时文件ID。当type非网页链接时必传 通过上传临时文件到专区接口获取 不多于1024字节 |
| doc_list.web_url | 否 | string | 网页链接。当type为网页链接时必传，以http或https开头的链接 不多于1024字节 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"kbid": "KBID",
"doc_list": [{
"doc_name": "客服问答.pdf",
"type": 2,
"file_media_id": "MEDIA_ID",
"docid": 1
},
{
"doc_name": "百度一下，你就知道",
"type": 101,
"web_url": "http://www.baidu.com",
"docid": 2
}
]
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
| kbid | string | 知识集ID |
| doc_list | obj[] | 內容列表 |
| doc_list.doc_name | string | 內容名 |
| doc_list.type | uint32 | 內容类型 |
| doc_list.file_media_id | string | 专区临时文件ID |
| doc_list.web_url | string | 网页链接 |
| doc_list.docid | uint64 | 临时文件添加到知识集后的內容ID |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_detail
请求包体：
{
"kb_id": "KBID"
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_ID | 是 | string | 知识集ID |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"kbid": "KBID",
"kb_name": "KB_NAME",
"doc_list": [{
"docid": 1,
"doc_name": "客服问答.pdf",
"type": 2,
"status": 1
},
{
"docid": 2,
"doc_name": "百度一下，你就知道",
"type": 101,
"web_url": "http://www.baidu.com",
"status": 0
}
]
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
| kbid | string | 知识集ID |
| kb_name | string | 知识集名 |
| doc_list | obj[] | 內容列表 |
| doc_list.docid | uint64 | 临时文件添加到知识集后的內容ID |
| doc_list.doc_name | string | 內容名 |
| doc_list.type | uint32 | 內容类型 |
| doc_list.web_url | string | 网页链接 |
| doc_list.status | int32 | 內容学习状态。 0-学习成功； 1-学习失败（网页无法访问/需鉴权/Excel没遵从模版格式等）； 2-学习中； |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_add_doc
请求包体：
{
"kb_id": "KBID",
"doc_list": [{
"doc_name": "客服问答.pdf",
"type": 2,
"file_media_id": "MEDIA_ID"
},
{
"doc_name": "百度一下，你就知道",
"type": 101,
"web_url": "http://www.baidu.com"
}
]
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_ID | 是 | string | 知识集ID |
| doc_list | 是 | obj[] | 內容列表 可填充个数：1 ~ 100。每个知识集的內容总数量不能超过100 |
| doc_list.doc_name | 是 | string | 內容名，如果是文件，需要有准确的文件名后缀 不多于200字节 |
| doc_list.type | 是 | uint32 | 內容类型 取值范围： 2 - pdf 4 - xlsx(用于上传问答对表格，需从管理端下载模版配置后上传) 5 - doc 6 - docx 101 - 网页链接 |
| doc_list.file_media_id | 否 | string | 专区临时文件ID。当type非网页链接时必传 通过上传临时文件到专区接口获取 不多于1024字节 |
| doc_list.web_url | 否 | string | 网页链接。当type为网页链接时必传，以http或https开头的链接 不多于1024字节 |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"doc_list": [{
"doc_name": "客服问答.pdf",
"type": 2,
"file_media_id": "MEDIA_ID",
"docid": 1
},
{
"doc_name": "百度一下，你就知道",
"type": 101,
"web_url": "http://www.baidu.com",
"docid": 2
}
]
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
| doc_list | obj[] | 內容列表 |
| doc_list.doc_name | string | 內容名 |
| doc_list.type | uint32 | 內容类型 |
| doc_list.file_media_id | string | 专区临时文件ID |
| doc_list.web_url | string | 网页链接 |
| doc_list.docid | uint64 | 临时文件添加到知识集后的內容ID |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_remove_doc
请求包体：
{
"kb_id": "KBID",
"docid_list": [0,1]
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_ID | 是 | string | 知识集ID |
| docid_list | 是 | uint64[] | 要删除的docid列表 可填充个数：1 ~ 100 |
返回结果：
{
"errcode": 0,
"errmsg": "ok"
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_modify_name
请求包体：
{
"kb_id": "KBID",
"kb_name": "NEW_NAME"
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_ID | 是 | string | 知识集ID |
| kb_name | 是 | string | 新名字 不少于1个字符 不多于20个字符 |
返回结果：
{
"errcode": 0,
"errmsg": "ok"
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
请求方法
通过SDK调用，具体方式参考专区程序使用指引。
请求接口名：
knowledge_base_delete
请求包体：
{
"kb_id": "KBID"
}参数说明：
| 参数 | 必须 | 类型 | 说明 |
|---|---|---|---|
| access_token | 是 | string | 调用接口凭证 |
| kb_ID | 是 | string | 知识集ID |
返回结果：
{
"errcode": 0,
"errmsg": "ok"
}参数说明：
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 返回码 |
| errmsg | string | 错误码描述 |
基础连接微信办公基础连接微信办公基础连接微信办公