更新知识库 | 大装置帮助中心
跳到主要内容

更新知识库

接口描述(Description)

更新已有知识库


请求地址(Request URL)

[PUT] https://api.sensenova.cn/v1/llm/knowledge-bases/{knowledge_base_id}

请求头(Request Header)

无特殊Header,请参考接口鉴权


请求参数(Path Parameters)

名称类型必须默认值可选值描述
knowledge_base_idstring--知识库ID

请求体(Request Body)

名称类型必须默认值可选值描述
descriptionstring--知识库描述
长度不超过256字符
filesstring[]--文件管理模块对应的文件ID(注意,文件必须是知识库支持的格式)
如果在这里传了文件列表,则无需再调用“给知识库添加文件”接口

请求示例(Request Example)

curl --request PUT "https://api.sensenova.cn/v1/llm/knowledge-bases/{knowledge_base_id}" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_TOKEN" \
-d '{
"description": "string",
"files":[
"string"
]
}'

响应(Response)

名称类型描述
knowledge_baseobject知识库
  • knowledge_base 部分参数如下:
名称类型描述
idstring知识库ID
descriptionstring知识库描述
filesobjetc[]文件详情
configsobject知识库构建参数详情
created_atstring知识库创建时间,ISO 8601标准时间格式,精确到纳秒
updated_atstring知识库更新时间,ISO 8601标准时间格式,精确到纳秒
statusstring知识库状态
可用:AVAILABLE
不可用:UNAVAILABLE
正在准备:LOADING
等待中:PENDING
  • files 部分参数如下:
名称类型描述
idstring文件ID
descriptionstring文件描述
statusstring文件状态,枚举值
未上传/上传中:NOTUPLOADED
已上传:UPLOADED
文件无效:INVALID
文件有效:VALID
  • configs 部分参数如下:
名称类型描述
text_splitobject文本分割配置
embeddingobjectembedding配置
  • text_split 部分参数如下:
名称类型描述
modestring文本分割模式
configobjectdelimiter模式下的分隔符配置,semantics模式无此配置
  • config 部分参数如下:
名称类型描述
max_lengthstring每个分割片段最大字数长度
punctuationsobject[]分割每个片段的标记符号列表
  • punctuations 部分参数如下:
名称类型描述
markstring分割标记
priorityint分割标记优先级
  • embedding 部分参数如下:
名称类型描述
modelstring模型ID

响应示例(Response Example)

{
"knowledge_base": {
"id": "string",
"description": "string",
"files":[
{
"id": "string",
"description": "string",
"status": "string"
}
],
"configs":{
"text_split":{
"mode": "string",
"config": {}
},
"embedding":{
"model": "string"
}
},
"created_at": "2023-06-28T17:23:01.243566533Z",
"updated_at": "2023-06-28T17:23:01.243566533Z",
"status": "string"
}
}

错误信息

参考错误码