更新时间:2025-07-22 GMT+08:00
分享

查询知识库版本列表

功能介绍

查询知识库版本列表。

URI

GET /v1/{project_id}/applications/{application_id}/uni-search/knowledge-repo/{repo_id}/versions

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

application_id

String

参数解释:

应用ID,获取方法请参见获取应用ID

约束限制:

字符串

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

repo_id

String

参数解释:

知识库ID。

获取方式:

账号登录KooSearch体验平台,在左侧导航栏选择:"知识库管理" ,在此界面获取"知识库ID"字段的值,表示该知识库在向量数据库中存储的ID,具有唯一性。

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线。

默认取值:

不涉及

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

total

Integer

参数解释:

版本总数。

取值范围:

不涉及

versions

Array of KnowledgeVersion objects

参数解释:

版本列表。

取值范围:

不涉及

表3 KnowledgeVersion

参数

参数类型

描述

id

String

参数解释:

版本id。

取值范围:

不涉及

repo_id

String

参数解释:

知识库ID。

取值范围:

不涉及

name

String

参数解释:

版本名称。

取值范围:

不涉及

detail

String

参数解释:

版本描述。

取值范围:

不涉及

status

String

参数解释:

版本状态。

取值范围:

  • active:使用中

  • open:可用

  • closed:关闭。

create_options

String

参数解释:

创建选项。

取值范围:

不涉及

progress

Integer

参数解释:

以索引方式重建时,reindex进度。当重建完成后,此字段会清空。

取值范围:

不涉及

create_user

String

参数解释:

知识库创建用户名。

取值范围:

不涉及

create_time

String

参数解释:

创建时间。

取值范围:

不涉及

update_time

String

参数解释:

更新时间。

取值范围:

不涉及

project_id

String

参数解释:

项目标识。

取值范围:

不涉及

embedding_model

String

参数解释:

embedding模型名称为版本重建时embedding模型集合中所选,未重建时为知识库中的embedding模型名称。

约束限制:

此参数只有25.7.T1及之后版本支持。

取值范围:

embedding模型名称长度不超过32位。

默认取值:

跟知识库的embedding模型名称一致。

请求示例

查询知识库版本列表。

/v1/1ed40ceefc8d40f8b884edb6a84e7768/applications/fb9731ab-7085-474f-b6c7-64473586f0f3/uni-search/knowledge-repo/05335b17-21f2-45f8-afeb-40bc1c583eb4/versions

响应示例

状态码:200

响应体。

{
  "total" : 1,
  "versions" : [ {
    "id" : "df611892-3ebe-4168-9049-20a1c5f25fc0",
    "name" : "chy",
    "status" : "active",
    "create_user" : "cssmonitoruser",
    "create_time" : "1751685280110",
    "update_time" : "1751685280110",
    "project_id" : "b25446daeb1a41a7953c5deba2b2677a",
    "embedding_model" : "cjh-embedding-8k"
  } ]
}

状态码

状态码

描述

200

响应体。

错误码

请参见错误码

相关文档