# 创建语文知识库 #### 场景介绍 知识库是一个组织、存储及管理知识的系统，包括文档、图表、表格等多种形式的信息的分类、整理和归纳，可以帮助用户组织和管理大量的信息，平台为用户提供了创建并管理知识库的能力，且创建的知识库可在工作流和Agent中调用。 对于需要处理大量问答知识、对检索效率有较高要求的场景，通过创建知识库组织和管理信息，可以提升信息获取效率。本实践以创建语文知识库为例进行介绍，主要完成以下设置： - 上传[语文知识库.word](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/语文知识库.docx)文档，对文档进行层级分段切分。切分出来的切片效果如[图1]所示。 图1切片效果 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538382756.png "点击放大") - 对切片内容进行提取，用于向量化检索。 - 对问题做向量化检索，附加返回答案内容。 - 使用语义检索、关键字检索、混合检索等方式检索内容。 #### 前提条件 - 已[实名认证](https://support.huaweicloud.com/usermanual-account/account_auth_00001.html)的华为账号或IAM用户。 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。 #### 准备工作 准备需要上传的知识素材，并进行预处理，以便达到更好的拆分效果。 - 本实践使用的语文知识库请参见[语文知识库.word](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/语文知识库.docx)，仅供参考。 - 您也可自行准备知识素材，并参考[表1]的拆分配置规则对素材进行预处理。确保素材样式结构逻辑清晰，以便提升拆分效果。 #### 创建知识库 1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 在左侧导航栏中选择"开发中心 \> 组件库"。 3. 选择"知识库"页签，在"知识库"页面，单击"新建知识库"。 4. 在"选择创建类型"弹框中选择"平台知识库"，单击"确定"。 5. 在"创建知识库"弹框中，填写参数配置信息，填写完成后单击"确定"。 图2创建语文知识库（以**AgentArts企业版** 为例） ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342487.png "点击放大") 表1创建语文知识库 | 区域 | 参数 | 示例 | 说明 | |:---|:---|:---|:---| | 基本信息 | 知识库图标 | ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569422453.png "点击放大") | 知识库LOGO。单击当前显示的知识库图标，在弹出的对话框中，选择要上传的新图标文件。 支持jpg、jpeg、png及gif格式，大小不大于200KB。 | | 基本信息 | 知识库名称 | 语文知识库 | 用于标识知识库。它是用户在创建知识库时必须填写的字段。 命名规则：可以包含字母、数字、中文、下划线_、连字符-，且必须以字母、数字或中文开头，长度1\~50个字符。 | | 基本信息 | 描述 | 语文知识库 | 用于对知识库内容和用途的简要说明。它提供了关于知识库的详细信息，帮助用户了解知识库的内容和使用场景。 命名规则：长度不大于100个字符。 | | 模型配置 | 向量模型 | embedding-zh | 向量模型是一种将文本、图像等非结构化数据转换为数值向量的模型。例如，在文本处理阶段，用于对文本文档进行切片，转换成向量化表示；在知识检索阶段，根据用户输入的信息对切片进行召回。 向量模型用于在海量的知识库中，快速识别和用户输入信息语义相近的词或句子，进行信息的初步筛选，解决"大海捞针"的效率问题。 **AgentArts企业版用户** 在开通KooSearch后，如果需要在AgentArts中使用自定义向量模型，请先在KooSearch中进行配置。配置时，模型类型选择"搜索Embedding模型"。配置完成后，该模型即可在AgentArts中使用。定义模型的具体步骤，请参考[创建及管理KooSearch模型服务](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_8001.html)。 | | 模型配置 | 精排模型 | rerank-zh | 精排模型是一种用于对检索结构进行精细排序的模型。针对用户输入的信息，对向量模型召回的切片进行从高到低的相关度排序，把相关度最高的前几个信息（例如Top10）呈现给用户。 精排模型用于进一步提升系统搜索的相关性精度。 **AgentArts企业版用户** 在开通KooSearch后，如果需要在AgentArts中使用自定义精排模型，请先在KooSearch中进行配置。配置时，模型类型选择"搜索精排模型"。配置完成后，该模型即可在AgentArts中使用。定义模型的具体步骤，请参考[创建及管理KooSearch模型服务](https://support.huaweicloud.com/usermanual-koosearch/koosearch_06_8001.html)。 说明： - 限时免费版用户在创建知识库后，无法修改精排模型的配置。 - 企业版用户在创建知识库后，可以通过"高级配置"选项来修改精排模型。具体操作步骤，请参考[更多操作](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0152.html#section3)。 | | 解析配置 | OCR增强 | 去勾选 | 开启后，即可调用OCR服务进行智能文档识别，如表格解析或扫描文件等。 | | 解析配置 | 页眉页脚解析 | 去勾选 | - 未开启，解析结果中不包含页眉页脚。 - 开启后，解析结果中包含页眉页脚。 | | 解析配置 | 目录页解析 | 勾选 | 未开启，解析结果中不包含目录页。 开启后，解析结果中包含目录页。 | | 解析配置 | 图片解析 | 勾选，选择"仅保留原图" | 不开启，则在文档中遇到图片默认跳过，不处理图片。 开启后，根据需要选择"提取图片文本"或者"仅保留原图"。 | | 拆分配置 | 拆分设置 | 层级分段 根据文档结构和内容进行如下设置： - 层级解析模型：自动解析。 - 标题层级深度：2（文档标题层级深度）。 - 标题保存方式：保存多标题组合。 - 跨标题合并：关闭。 - 分段标识符：默认全选。 - 分段预计长度：500（分段内容包含题目+答案）。 | 系统默认自动分段。支持如下分段策略。 - 自动分段：按照系统默认预设的规则和分隔符切分。 - 长度分段：基于内容的长度来决定如何进行分段。 - 层级分段：根据内容的结构层次来进行分段。 | 6. 配置完成后，单击"确定"，完成知识库创建。 #### 上传知识文档 1. 在"知识库"页签，单击知识库列表中的"语文知识库"名称，进入该知识库详情页面。 2. 在知识库详情页面选择"知识文档"页签，单击"上传"进入文档上传页面。 3. 单击"点此上传"，在弹出的对话框中，选择要上传的文档。 图3上传文档（以**AgentArts企业版** 为例） ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342463.png "点击放大") 4. 单击"确定"，文件列表中有对应文件，即完成文件上传。 待文件状态为"成功"，即完成文件解析。 #### 查看文档切片 1. 在知识库详情页面选择"知识文档"页签，单击"状态"是"成功"的文件名称，进入到文档详情页面。 2. 左侧是文档基本信息和拆分配置信息，右侧是文档切片信息，如[图4]所示。 图4切片信息 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002538542704.png "点击放大") #### 命中测试 1. 在知识库列表中，单击语文知识库操作列的"命中测试"。 2. 在页面左侧文本框中输入问题，并单击"命中测试"。 命中结果可根据右上方的分值查看结果，分值越高，命中结果越精确。 图5命中测试 ![](https://support.huaweicloud.com/bestpractice-agentarts0/zh-cn_image_0000002569342477.png "点击放大") 3. 在页面右侧将根据不同的检索方式（语义检索、关键词检索、混合检索、FAQ检索），展示多条匹配的内容，并按照匹配分值降序排列。 4. 用户可以根据分值与匹配到的信息数量来评估当前知识库是否满足需求。 如果满足需求，则知识库接入完成，您可以在智能体或工作流中使用该知识库。 #### 相关文档 配置本地知识库的详细信息，请参考[创建本地知识库](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0150.html)。