# 管理知识空间 知识空间用于集中管理知识库，支持将企业内部文档、技术资料等知识内容上传，作为上下文参考使华为云码道代码智能体生成的答案更精准。知识空间**仅支持在云端创建和管理** ，且仅**已开启席位的账号**可进行相关操作。 #### 快速了解知识库 知识库主要应用于华为云码道代码智能体插件的单元测试生成、代码续写和研发知识问答等场景，可显著提升智能体在这些任务中的准确性和响应效率。 - [工作原理] - [基本概念] 通过可视化的方式，展示知识库从用户提问到答案返回的完整处理流程，涵盖信息检索、逻辑推理等关键环节，便于您全面掌握其工作原理。 图1知识库工作原理 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693572282.png "点击放大") 1. 根据业务需要将知识按类型整理划分，如通用知识、领域知识和个人知识。 2. 新建知识空间，用于管理知识库。 3. 创建知识库并上传知识文件，对知识进行切片、向量化处理后入库存储。 4. 在华为云码道代码智能体中引用知识库，检索知识库信息，辅助生成更准确。 在使用知识库前，建议先了解以下基本概念，助您快速上手。 表1基本概念 | **基本概念** | **概念说明** | |:---|:---| | 知识空间 | 知识空间是将用户上传的数据进行切片、模型向量化处理、索引过滤后入库形成的知识集合，按照实际使用维度进行划分。知识空间本身不存储知识，只用于集中管理知识库。 | | 知识库 | 知识库用于存储和管理各类知识文档，支持按知识类型和来源进行分类划分，有助于提升信息组织的清晰度，增强知识的可读性与可检索性。 | | 文件 | 文件是知识的载体，知识从导入到检索，需配置正确的加载切片规则、选择合理的向量化模型、设置匹配的索引过滤条件与检索策略，才能确保端到端的检索效果。 | | 切片 | 切片是知识文件经过加载与切分后形成的文本块，是向量化、存储与召回的基本单元。 | #### 约束与限制 表2约束与限制 | 新版套餐版本 | 旧版套餐版本 | 容量上限 | 可创建的知识空间类型 | |:---|:---|:---|:---| | 个人体验版 | 体验版 | 500MB | 个人级 | | 个人标准版/个人高级版/个人旗舰版 | 基础版 | 5GB | - 个人标准版/个人高级版/个人旗舰版：个人级 - 基础版：企业级、团队级、个人级 | | 企业专业版 | 专业版 | 20GB | 企业级、团队级、个人级 | #### 前提条件 已[启用席位](https://support.huaweicloud.com/usermanual-enterprise/codeartsagent_enterprise_0006.html)，若未启用，无法创建和管理知识空间。购买个人版（新版套餐）的账号默认已启用席位。 #### 新建知识库 1. 新建知识空间。 知识空间用于集中管理多个知识库。在创建知识库之前，须先创建一个知识空间。 1. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？ - 是，使用**购买套餐的账号** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 - 否，使用**企业成员或企业管理员** 登录[码道代码智能体控制台](https://codearts.huaweicloud.com/portal)。 2. 在左侧导航栏选择"智能体设置 \> 知识空间"，进入"知识空间"页面。 3. 单击右上角的"新建空间"，参考[表3]完成参数配置。 图2新建知识空间 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693732148.png "点击放大") 表3新建知识空间参数说明 | **参数** | **说明** | |:---|:---| | 知识空间名称 | 新建知识空间的名称。 命名规则：不能以下划线开头，支持中文、英文、数字、下划线（_）和中划线（-），长度不超过18个字符。 | | 可见范围 | 仅企业版（新版套餐）或基础版、专业版（旧版套餐），支持配置该参数。 对成员访问权限进行管控。 - 个人：仅成员本人可用。 - 团队：仅本团队成员可用，由企业管理员或团队管理员创建。 - 企业：所有企业成员都可用，由企业管理员创建。 | | 可用团队 | 仅"可见范围"设置为"团队"时，展示此参数。 在下拉列表中选择团队。 企业管理员可查看所有团队，但只能选择其中一个团队，团队管理员仅可查看并选择其所属团队。 | | 标签 | 可选，为知识空间添加标签，用于分类和管理内容，最多可选择10个标签。 1. 若尚未创建标签，参考以下步骤创建。否则，请执行下一步。 在下拉列表中单击"添加"，弹出"新增标签"对话框。输入标签名称，单击"确定"。 标签名称命名规则：不能以下划线开头，支持中文、英文、数字、下划线（_）和中划线（-），长度不超过32个字符。 2. 勾选目标标签。 | | 描述 | 可选，输入知识空间的描述信息，长度不超过300个字符。完善的描述有助于华为云码道代码智能体准确地理解内容范围，提升检索匹配的精准度。 | 4. 单击"确定"，完成知识空间的创建。 在知识空间列表中，可查看到已创建的知识空间。 2. 新建知识库。 基于已创建的知识空间创建知识库，并根据知识的类型和来源进行分类，确保信息结构清晰、易于检索。 1. 在知识空间列表中，单击已创建的知识空间，进入知识空间详情页面。 2. 单击右上角的"新建知识库"，弹出"新建知识库"对话框。 3. 参考[表4]完成基本信息配置。 图3新建知识库 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723251711.png "点击放大") 表4知识库基本信息参数说明 | **参数** | **说明** | |:---|:---| | 知识库名称 | 新建知识库的名称。 名称规则：不能以下划线开头，支持中英文、数字、下划线（_）和中划线（-），长度不超过32个字符。 | | 知识类型 | 选择知识库的类型，支持"非结构化格式"和"结构化格式"。 - 非结构化格式：数据没有固定的格式。 - 结构化格式：数据有固定格式、字段、结构。 | | 数据来源 | 选择知识库的数据来源，包括"本地文件"和"代码"两种类型。 - "知识类型"为"非结构化格式"时，支持的数据来源如下。 - 本地文件：主要包含文本内容，可以包括文章、报告、书籍等，支持TXT、DOCX、PDF、MD、CSV、XLS和XLSX格式文件。 - 代码：仅支持ZIP格式的压缩包，内含Java 、Python、C、C++或Vue代码文件。 - "知识类型"为"结构化格式"时，仅支持"本地文件"，文件格式为JSON。 | | 知识库描述 | 可选，输入知识库的描述信息，介绍知识库中包含的内容，长度不超过300个字符。详细的描述有助于指导智能体更准确地调用知识库。 | 4. 单击"下一步"，参考[表5]完成入库信息的配置。 表5入库配置参数说明 | **参数** | **说明** | |:---|:---| | Embedding模型 | 选择Embedding模型，对上传的文件/代码进行向量化，提供以下模型可供选择： - bge-m3：多语种的1024维文本嵌入模型，支持向量/稀疏/多表征混合检索，最大支持8192 tokens长文本，适合复杂多语言场景。 - m3e-base：中英文文本的通用型768维的嵌入模型，适用于大多数中英文基础语义理解与检索任务。 - bge-large-zh-v1.5：中文专用模型，适用于检索、分类、聚类及语义匹配等任务。 - paraphrase-multilingual-MiniLM-L12-v2：中英文文本的364维嵌入模型，在文本相似度计算中表现优异，适合对速度有要求的场景。 - VESO-v1.3：代码专用模型，针对代码数据深度优化，在代码数据向量化与搜索任务中表现突出。 | | 切分器 | "知识类型"为"非结构化格式"，且"数据来源"为"本地文件"时，展示此参数。 不同切分器的切片方式和结果不同，在不同的语言场景下可以选择不同的切分器，当前支持以下切分器。 - 基于段落的切分器：按照两个连续的换行符（\\n\\n）分割或文本段落结构分割。 - 基于行的切分器：按照换行符（\\n）分割。 - 基于句子的切分器（适用于英文文本）：将文本按照英文句子分割。 - 基于字符的切分器：逐个字符（含空白字符）分割。 | | 分段预计长度 | "知识类型"为"非结构化格式"，且"数据来源"为"本地文件"时，展示此参数。 分片长度的取值范围为50\~1200，默认值为1000。 | | 分段重叠长度 | "知识类型"为"非结构化格式"，且"数据来源"为"本地文件"时，展示此参数。 当前分片与上一个分片重叠的文本长度，取值范围为：0 ≤ 重叠长度 ≤ 分片长度-1，默认值为0。 | | 子切分器 | "知识类型"为"非结构化格式"，且"数据来源"为"本地文件"时，展示此参数。 切片长度超过最大长度时应用子切分器。当前支持以下切分器： - 基于字符的切分器：逐个字符（含空白字符）分割。 - 基于句子的切分器（适用于英文文本）：将文本按照英文句子分割。 - 基于单词的切分器（适用于英文文本）：将文本按照空白字符分割。 | | 需建立索引的字段 | "知识类型"设置为"结构化格式"时，展示此参数。 请输入JSON中的Key，作为检索时的索引字段。最多支持20个字段，多个字段间请用英文逗号（,）分隔。 | | 过滤配置字段 | "知识类型"设置为"结构化格式"时，展示此参数。 请输入JSON中的Key，作为检索时的过滤条件。最多支持2个字段，字段之间请用英文逗号（,）分隔。 | | 索引字段 | "数据来源"设置为"代码"时，展示此参数。 选择索引字段，即指定系统需要为哪些数据字段预先构建索引。智能体在检索时，将仅对这些已建立索引的字段进行关键词匹配。 例如，索引字段选择为函数体，则用户输入关键词搜索时，智能体将优先在代码的"函数体"部分进行匹配查找。 | | 使用滑动窗口 | "数据来源"设置为"代码"时，展示此参数。 开启后，可进一步将复杂函数切分成多个片段，提高搜索的准确性。 | 5. 单击"确定"，完成知识库的创建。 在知识库列表中，可查看到已创建的知识库。 3. 导入文件。 知识库创建后，您可以将存储在本地的各类文档上传至知识库。上传后，系统将自动进行数据清洗与索引构建，确保您导入的内容能够被快速检索和调用，从而实现知识的即时沉淀。 1. 在知识库列表中，单击已创建知识库的名称，进入知识库详情页面。 2. 单击右上角的"导入文件"，弹出"导入文件"对话框。 3. 选择本地待导入的文件或代码，单击"确定"，返回知识库页面。 图4上传文件或代码 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693572284.png "点击放大") 请根据所需知识类型上传相应的文件或代码。**单个文件或压缩包最大支持20MB，** **单个知识库最大支持50MB。** 表6导入文件说明 | 知识类型 | 数据来源 | 说明 | |:---|:---|:---| | 非结构化格式 | 本地文件 | 支持TXT、DOCX、PDF、MD、CSV、XLS和XLSX格式文件。 | | 非结构化格式 | 代码 | 仅支持ZIP格式的压缩包，内含Java、Python、C、C++或Vue代码文件。 | | 结构化格式 | 本地文件 | 支持JSON格式文件。 | 4. 查看导入结果。 当"导入状态"由"上传中"变更为"入库成功"时，表示文件已成功导入。 #### 在上下文中引用知识库 1. 套餐版本是否为新版套餐的个人版（个人体验版、个人标准版、个人高级版、个人旗舰版）？ - 是，使用**购买套餐的账号**登录客户端。 - 否，使用**企业成员或企业管理员**登录客户端。 2. 在聊天界面的输入框内输入"#"，或单击 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723252623.png)选择"添加上下文"，再选择"Knowledge Bases"。 3. 在Knowledge Bases列表中，选择[1]中新建的知识空间（如个人知识空间）。 图5选择知识空间 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723372541.png "点击放大") 4. 在目标知识空间中，选择[3]中创建的知识库（如服务介绍文档），将知识库添加到上下文。 5. 知识库添加后，即可基于该知识库发起会话。 #### 管理知识库 [表7]展示了不同角色对[管理知识库]的操作权限差异，具体如下： 表7不同角色对知识库的操作权限说明 | 角色 | 企业级知识库 | 团队级知识库 | 个人级知识库 | |:---|:---|:---|:---| | 企业管理员 | 可对所有知识库执行全量操作。 | 可对所有知识库执行全量操作。 | 可对所有知识库执行全量操作。 | | 团队管理员 | 可执行以下操作： - 知识库命中测试。 - 查看知识库操作动态。 | 可对本团队成员（含团队管理员）创建的知识库执行全量操作。 | 可对本人创建的知识库执行全量操作。 | | 团队成员 | 可执行以下操作： - 知识库命中测试。 - 查看知识库操作动态。 | 可对本团队成员（含团队管理员）创建的知识库执行以下操作： - 知识库命中测试。 - 查看知识库操作动态。 | 可对本人创建的知识库执行全量操作。 | | 企业成员 | 可执行以下操作： - 知识库命中测试。 - 查看知识库操作动态。 | 无任何操作权限。 | 可对本人创建的知识库执行全量操作。 | ![](https://support.huaweicloud.com/usermanual-enterprise/public_sys-resources/note_3.0-zh-cn.png) 仅企业版（新版套餐）或体验版、基础版、专业版（旧版套餐），涉及[表7]的操作权限。 表8管理知识库 | 操作 | 具体步骤 | |:---|:---| | 编辑知识空间 | 在知识空间页面，单击目标知识空间卡片上的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002723253757.png)，选择"编辑"，即可对知识空间进行编辑。 | | 删除知识空间 | 删除知识空间前，须先清空该空间下的所有知识库。 1. 在知识空间页面，单击目标知识空间卡片上的 ![](https://support.huaweicloud.com/usermanual-enterprise/zh-cn_image_0000002693574332.png)，选择"删除"，弹出"删除知识空间"对话框。 2. 输入"DELETE"或单击"一键输入"，然后单击"确定"，即可删除知识空间。 目标知识空间已从知识空间页面移除，表示删除知识空间成功。 注意： 删除知识空间会将该空间内的所有资源彻底清除。一旦确认，数据将无法找回，请在执行前做好备份。 | | 知识库命中测试 | 命中测试旨在对知识库执行搜索查询，并验证检索结果的准确性与相关性。 1. 在知识空间页面，单击右上角的"命中测试"，进入"命中测试"页面。 2. 选择知识库，即需要检索的目标知识库，最多支持选择10个。 3. 指定要检索的字段，直接在下拉框中选择即可。 4. 选择检索方式。 - 文本检索：基于传统关键词匹配，适合精确词匹配、短查询。 - 向量检索：基于语义相似度，能理解上下文和同义词，适合自然语言查询。 - 混合检索：结合"文本检索"加"向量检索"，取两者结果加权融合。通常效果更好，尤其对复杂语义查询。 5. 输入您想要搜索的内容，最多支持1000个字符。 6. 设置返回结果条数。 7. 单击"开始调试"，在"片段结果"中可查看到最终的调试结果。 | | 删除知识库 | 当内容严重过时且无保留价值，或存在严重错误且修正成本过高/无法修正时，可以通过如下操作删除知识库。 1. 在知识空间页面，单击知识库所在的知识空间，进入知识空间详情页面。 2. 在目标知识库所在行，单击"删除"，弹出"删除知识库"对话框。 3. 输入"DELETE"或单击"一键输入"，然后单击"确定"，即可删除目标知识库。 目标知识库已从知识空间详情页面移除，表示删除知识库成功。 注意： 删除操作执行后，该知识库内的所有数据将被永久清除，且无法恢复。请确认已备份重要数据后再进行操作。 | | 批量删除知识库 | 手动逐条删除知识库效率较低，您还可以通过以下方式批量删除知识库。 1. 在知识空间页面，单击知识库所在的知识空间，进入知识空间详情页面。 2. 勾选目标知识库，单击右上角的"批量删除"，弹出"批量删除知识库"对话框。 3. 输入"DELETE"或单击"一键输入"，然后单击"确定"，即可删除选中的多个知识库。 目标知识库已从知识空间详情页面移除，表示批量删除知识库成功。 注意： 删除操作执行后，该知识库内的所有数据将被永久清除，且无法恢复。请确认已备份重要数据后再进行操作。 | | 查看知识库操作动态 | 1. 在知识空间页面，单击知识库所在的知识空间，进入知识空间详情页面。 2. 单击右上角的"操作动态"，即可查看知识空间内所有知识库的操作日志。 | | 重新导入文件 | 如果文件上传失败，请检查网络连接或文件格式后，单击"重新导入"重试。 1. 在知识空间页面，单击知识库所在的知识空间，进入知识空间详情页面。 2. 单击目标知识库的名称，进入知识库详情页面。 3. 单击右上角的"重新导入"，查看导入结果。 | | 删除文件 | 文件数量较少时，逐条删除操作更直观灵活，便于精准定位并清除目标内容。 1. 在知识空间页面，单击目标文件所在知识空间的名称，进入知识空间详情页面。 2. 单击目标文件所在知识库的名称，进入知识库详情页面。 3. 单击目标文件后的"删除"，弹出"删除文件"对话框。 4. 输入"DELETE"或单击"一键输入"，然后单击"确定"，即可删除该文件。 目标文件已从知识库详情页面移除，表示删除文件成功。 注意： 删除操作执行后，文件将会被永久清除，且无法恢复。请确认已备份重要数据后再进行操作。 | | 批量删除文件 | 手动逐条删除文件效率较低，您还可以通过以下方式批量删除文件，快速清理冗余文件。适用于知识库重构、版本迭代及去重场景，助您快速保持知识库整洁。 1. 在知识空间页面，单击目标文件所在知识空间的名称，进入知识空间详情页面。 2. 单击目标文件所在知识库的名称，进入知识库详情页面。 3. 勾选目标文件，单击右上角的"批量删除"，弹出"批量删除文件"对话框。 4. 输入"DELETE"或单击"一键输入"，然后单击"确定"，即可删除选中的多个文件。 目标文件已从知识库详情页面移除，表示批量删除文件成功。 注意： 删除操作执行后，文件将会被永久清除，且无法恢复。请确认已备份重要数据后再进行操作。 |