# 知识库版本操作 - ModifyKnowledgeVersion #### 功能介绍 **参数解释：** 知识库版本管理，版本状态和操作表： | 状态 | 重建 | 启用 | 关闭 | 删除 | 激活 | 更新 | |:---|:---|:---|:---|:---|:---|:---| | 使用中 | 1 | - | - | - | - | 1 | | 可用 | 1 | - | 1 | 1 | 1 | 1 | | 关闭 | - | 1 | - | 1 | - | 1 | 版本状态为使用中：支持重建和更新； 版本状态为可以：支持重建、关闭、删除、激活和更新； 版本状态为关闭：支持启用、删除和更新。 **取值范围：** 不涉及 #### URI POST /v1/{project_id}/applications/{application_id}/uni-search/knowledge-repo/{repo_id}/versions/{version_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | | application_id | 是 | String | **参数解释：** 应用ID，获取方法请参见[获取应用ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 **约束限制：** 字符串 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 | | repo_id | 是 | String | **参数解释：** 知识库ID。 获取方式： 账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理" ，在此界面获取"知识库ID"字段的值，表示该知识库在向量数据库中存储的ID，具有唯一性。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线。 **默认取值：** 不涉及 | | version_id | 是 | String | **参数解释：** 知识库版本ID，1～64个字符，只能包含数字、字母、中划线和下划线。 获取方式： 账号登录KooSearch体验平台，在左侧导航栏选择："知识库管理"，单击进入具体的知识库后，选择"版本管理"页签，在此界面获取"版本ID"字段的值，表示该知识库版本标识，具有唯一性。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | operation | 是 | String | **参数解释：** 知识库版本操作。 **约束限制：** 不涉及 **取值范围：** - reindex: 重建，限制最多10个版本 - open：启用 - active：激活 - close：关闭 - delete：删除 - update：更新。 **默认取值：** 不涉及 | | name | 否 | String | **参数解释：** 版本名称，重建操作时必选。 **约束限制：** 不涉及 **取值范围：** 只能包含1到64位英文字母、中文、数字、中划线或者下划线，并且以字母、数字或者中文开头。 **默认取值：** 不涉及 | | detail | 否 | String | **参数解释：** 知识库描述，允许重建、更新。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | options | 否 | [KnowledgeVersionCreateOptions] object | **参数解释：** 重建版本选项： source: 重建来源， 取值范围：index(索引)和file(文档)， 默认值：file parser: 文档解析规则设置，重建来源为file时生效。 取值范围：inherit(继承)和 latest（最新）， 默认值：inherit active： 是否立即激活， 取值范围：布尔值， 默认值： 重建来源为index时默认false，重建来源file为true。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | 表3KnowledgeVersionCreateOptions | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | source | 否 | String | **参数解释：** 重建来源。 **约束限制：** 不涉及 **取值范围：** - index(索引) - file(文档) **默认取值：** file | | parser | 否 | String | **参数解释：** 文档解析规则设置，重建来源为file时生效。 **约束限制：** 不涉及 **取值范围：** - inherit(继承) - latest（最新） **默认取值：** inherit | | active | 否 | Boolean | **参数解释：** 是否立即激活。 **约束限制：** 不涉及 **取值范围：** - true 立即激活 - false 未激活 **默认取值：** 重建来源为index时默认false，重建来源file为true。 | | embedding_model | 否 | String | **参数解释：** embedding模型名称为版本重建时embedding模型集合中所选，未重建时为知识库中的embedding模型名称。 **约束限制：** 此参数只有25.7.T1及之后版本支持。 **取值范围：** embedding模型名称长度不超过32位。 **默认取值：** 与对应知识库的embedding_model名称一致。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version_id | String | **参数解释：** 版本ID，如果是重建操作，返回新创新的。 **取值范围：** 不涉及 | #### 请求示例 知识库版本操作。 ``` /v1/b25446daeb1a41a7953c5deba2b2677a/applications/5071b12e-8c5c-4181-a15b-41e6ae3915ea/uni-search/knowledge-repo/ae63178c-f9d1-46c9-96d2-de045dfc6810/versions/940a8712-e3c0-4293-82ef-159c7baccbf7 { "operation" : "reindex", "name" : "重建索引", "detail" : "", "options" : { "embedding_model" : "embedding-zh", "source" : "index", "active" : false } } ``` #### 响应示例 **状态码：200** 修改知识库版本管理信息响应体。 ``` { "version_id" : "cb70621f-bd02-4fcb-ae81-db06574fb04a" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 修改知识库版本管理信息响应体。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。