创建知识库接口
POST
/v1/kbs该接口支持创建、管理知识文档。相关操作流程如下:
1.新建知识库后得到知识库 ID;
2.上传文件,获取文件 ID;
3.通过文件 ID 与知识库 ID 进行知识库文件关联,知识库中可以关联多个文档。
4.调用对话接口时通过 knowledge_base 字段传入知识库 ID 列表,大模型使用检索到的知识信息回答问题。
请求参数
Header 参数
Content-Type
string
必需
示例值:
application/json
Authorization
string
必需
请求鉴权的 APIKey,由百川提供。Bearer 开头
示例值:
Bearer $API_KEY
Body 参数application/json
name
string
必需
description
string
必需
split_type
integer
必需
split_config
object
必需
chunk_overlap_len
integer
必需
chunk_max_len
integer
必需
separators
array[string]
必需
示例
{
"name": "string",
"description": "string",
"split_type": 2,
"split_config": {
"chunk_overlap_len": 500,
"chunk_max_len": 100,
"separators": [
".",
"。",
"\n"
]
}
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
id
string
必需
唯一标识,在 api 请求中使用
object
string
必需
对象类型,固定为“knowledge-base”
name
string
必需
知识库名称,50 字以内
description
string
必需
知识库描述,100 字以内
file_ids
array[string]
知识库关联文件列表
created_at
integer
必需
创建时间,Unix 时间戳(秒)
updated_at
integer
必需
更新时间,Unix 时间戳(秒)
status
string
必需
init:待解析;parsing:解析中;online:解析成功;fail:解析失败。
split_config
object
分片配置
chunk_overlap_len
integer
必需
分片重叠长度, (2*chunk_overlap_len+1 <= chunk_max_len)
chunk_max_len
integer
必需
分片最大长度, 最大 512。
separators
array[string]
文件切分字符
示例
{
"id": "kb-abc123",
"object": "knowledge-base",
"name": "string",
"description": "string",
"file_ids": [],
"created_at": 1677610602,
"updated_at": 1677610602,
"status": "online",
"split_type": ,
"split_config": {
"chunk_overlap_len": 512,
"chunk_max_len": 100,
"separators": [".","。","\n"]
}
}
最后修改时间: 1 年前