# 搭建知识库问答工作流 #### 案例概述 在实际业务中，经常需要创建一个带有知识库的AI助手来回答特定领域的问题（如企业规章、行业报告），通过引入知识库功能，可以解决大模型在面对垂直领域或私有数据时出现的知识缺失与事实性错误问题。 本章节的案例中，构建一个"旅游景点介绍知识库"，随后编排知识库问答工作流，并通过大模型进行内容总结。 图1效果展示 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002518193658.png "点击放大") #### 操作视频 #### 操作流程 搭建知识库问答工作流流程如下，仅需四步即可完成知识库问答助手的搭建。 图2用户旅程 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002522591714.png "点击放大") | 操作步骤 | 说明 | |:---|:---| | [准备工作] | 注册华为账号并开通华为云、完成实名认证，开通AgentArts服务。 | | [步骤一：创建知识库] | 创建知识库并上传文档，执行命中测试以确保系统能准确召回文档中的关键信息。 | | [步骤二：创建工作流应用] | 新建一个"工作流"类型的应用，并进入工作流编排画布，准备编排工作流。 | | [步骤三：编排工作流节点] | 搭建知识库问答工作流的核心逻辑，通过 "知识检索"节点连接您的知识库，并将检索结果流转至 "大模型"节点进行总结与回答。工作流包含以下四个节点： 开始--\>知识检索--\>大模型--\>结束 | | [步骤四：试运行工作流] | 验证知识问答工作流的结果是否符合预期。 | #### 准备工作 在使用AgentArts智能体平台前，需要参考如下内容，提前申请华为账号并完成实名认证。 1. 进入[华为云官网](https://www.huaweicloud.com/)，单击页面右上角的"注册"。 2. 参考[注册华为账号并开通华为云](https://support.huaweicloud.com/usermanual-account/account_id_001.html)中操作，完成注册。 3. 注册成功后，进行实名认证。 - 个人账号：[个人实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914254.html) - 企业账号：[企业实名认证](https://support.huaweicloud.com/usermanual-account/zh-cn_topic_0077914253.html) 如果您使用的是IAM用户，也可使用该账户开通AgentArts服务。 4. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)，参考[开通AgentArts](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)开通服务。 #### 步骤一：创建知识库 本章节将指导您创建知识库并上传演示文档（[全国旅游城市精选.docx](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/全国旅游城市精选.docx)），通过命中测试验证文档召回能力，为后续的工作流提供支撑。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"开发中心 \> 组件库"，在"知识库"页签，单击页面右上角"创建知识库"，**并选择"创建平台知识库"** 。 图3创建知识库 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002659554993.png) 3. 在"创建知识库"弹窗中根据[表1]配置知识库参数，填写完成后单击"创建并上传"。 图4配置知识库参数 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002659560173.png "点击放大") 知识库参数详细说明 - 知识库名称：用于标识知识库 - 描述：用于对知识库内容和用途进行简要说明。 - 向量模型：向量模型是一种将文本、图像等非结构化数据转换为数值向量的模型。例如，在文本处理阶段，用于对文本文档进行切片，转换成向量化表示；在知识检索阶段，根据用户输入的信息对切片进行召回。 - 精排模型：精排模型是一种用于对检索结果进行精细排序的模型。针对用户输入的信息，对向量模型召回的切片进行从高到低的相关度排序，把相关度最高的前几个信息呈现给用户。 - 解析配置：用于设置文档解析时是否调用文字识别（OCR）服务、是否包含页眉页脚 / 目录页以及如何处理图片。当需要解析含表格 / 扫描件的文档、保留页眉页脚或目录页信息，或需提取图片中的文字（如图片含关键文本）、保留原图用于图文问答时使用。 - 拆分设置：通过自动分段、长度分段、层级分段方式，将文档切分为符合需求的片段（可设置分段长度、标题处理规则等），当需要将长文档拆解为便于向量化存储、知识检索的小片段，或需按文档结构（如标题层级）、特定符号（如句号、空格）规范片段划分时使用。 表1参数配置 | 参数 | 配置示例 | |:---|:---| | 知识库名称 | 填写"景点介绍知识库"。 | | 描述 | 填写"景点介绍知识库，提供全国各地景点介绍"。 | | 向量模型 | 选择"pangu_embedding"。 | | 精排模型 | 选择"pangu_rerank"。 | | 解析配置 | 不配置 | | 拆分设置 | 选择"自动分段"。 | 4. 下载演示文档（[全国旅游城市精选.docx](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/全国旅游城市精选.docx)），并上传至知识库，并单击"完成"。 5. 创建好的知识库将自动显示到知识库列表中，单击知识库名称，进入知识库详情页。 6. 单击页面右上角"命中测试"。 图5命中测试 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002629414694.png "点击放大") 7. 输入与演示文档（[全国旅游城市精选.docx](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/agentarts/全国旅游城市精选.docx)）内容相关的问题，如"上海有哪些景点"。检查知识库的召回情况，并**记录召回的相似度分值** 。 ![](https://support.huaweicloud.com/qs-agentarts/public_sys-resources/note_3.0-zh-cn.png) 该分值在后续[步骤三：编排工作流节点]中，要作为"搜索召回"节点参数的取值参考（示例中使用"上海有哪些景点"作为测试问题时，相似度分值为0.69）。 图6命中测试演示 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002629414890.png "点击放大") #### 步骤二：创建工作流应用 应用是承载业务的主体。在编排工作流节点之前，需要先创建一个工作流应用，并进入工作流编辑界面。 1. 返回至"开发中心 \> 智能体管理"页面，进入"工作流"页签，单击页面右上角"创建工作流"。 图7创建工作流 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002518737668.png "点击放大") 2. 选择"对话型工作流"，并设置名称、描述。 - 名称：知识库问答助手 - 描述：知识库问答助手 图8创建对话型工作流 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002583595315.png "点击放大") 3. 单击右下角"立即创建"。 创建完成后会进入工作流编辑页面，请参考[步骤三：编排工作流节点]执行后续操作。 #### 步骤三：编排工作流节点 这是构建知识库问答工作流的核心环节。通过可视化拖拽的方式，依次**连接 "开始 -\> 知识检索 -\> 大模型 -\> 结束" 四个关键节点** ，并**进行参数设置**，将静态的知识库与大模型推理能力串联起来，实现"先检索、后生成"的业务逻辑。 1. 工作流默认展示"开始 -\> 大模型 -\> 结束"节点。鼠标指向在开始节点、大模型节点中间，单击![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002517990390.png)，添加"知识检索"节点。 图9添加知识检索节点 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002581716174.png "点击放大") 2. 单击节点，可展开节点的参数配置页面，参考[表2]依次设置各节点参数。 表2工作流节点参数表 | 节点类型 | 参数修改说明 | |:---|:---| | 开始节点 | 使用默认的"query"参数，用于提取用户问题。 不进行改动。 图10开始节点配置示例 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002517991514.png "点击放大") | | 知识检索节点 | 对知识库检索节点的以下参数进行设置： - 输入参数 引用开始节点的"query"参数，表示将用户问题传递给知识库进行搜索。 图11输入参数配置示例 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002524431372.png "点击放大") - 知识库 添加知识库，选择先前创建的"景点介绍知识库"。 图12添加知识库 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002517991628.png "点击放大") - **知识库设置** 单击知识库右侧按钮，配置知识库参数。检索策略设置为"混合检索"；**相关度阈值** **设置为0.1**，防止出现问题与知识库内容相似度低，召回为空的情况发生。 图13配置知识库参数 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002517991684.png "点击放大") | | 大模型节点 | 对大模型节点的以下参数进行设置： - 模型配置 选择一个模型，如"DeepSeek-V4-Flash"。 - 输入参数 1. 保留预置的输入参数query及其引用类型和值。后续模型总结时，需要将用户原始问题、知识检索的召回一并传给大模型进行总结。 2. 大模型需要读取搜索召回的内容进行总结，因此需要引用"知识检索"节点的输出参数。单击输入参数右侧![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002666595160.png)，新增一个output_list参数，引用知识检索节点的输出参数output_list。 图14新增输入参数 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002581717294.png "点击放大") - 系统提示词 输入下面的内容 ``` # 角色定义 您是一名专业的**内容分析总结师**，擅长提炼各类文档片段关键信息，也能基于问题本身进行专业解答。 # 核心任务 理解用户提问，优先依托知识库检索返回的相关文档片段提取信息、生成回答；如果检索无结果或信息不完整，直接基于问题本身作答。 # 处理原则 1. 优先用知识库检索内容，筛选核心相关信息，舍弃无关内容，不编造原文未提及的信息； 2. 整合多片段信息，合并重复内容、补全关联信息，保证事实准确； 3. 检索内容不足或无检索结果时，直接围绕问题核心给出专业解答。 # 输出规范 - 语言简洁专业，避免口语化 - 不透露知识库相关技术细节 ``` - 用户提示词 输入下面的内容 ``` ## 用户原始问题 {{query}} ## 知识库检索返回的文档片段 {{output_list}} 请根据以上文档片段，回答用户问题。 ``` 图15系统提示词、用户提示词示例 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002611997649.png "点击放大") | | 结束节点 | 输入参数引用大模型节点的输出内容，其余参数使用默认配置。 图16结束节点配置示例 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002612000051.png "点击放大") | #### 步骤四：试运行工作流 工作流编排完成后，必须通过实际运行来验证逻辑的正确性。本章节将引导您输入具体的测试问题，检查工作流能否准确检索到文档片段，并验证大模型是否能基于检索结果生成符合预期的回答。 1. 单击工作流页面右上角"试运行"，此时系统会自动检测工作流参数是否设置正确。如果某一节点报错，请参考[步骤三：编排工作流节点]检查节点参数。 2. 输入测试内容，如"国内有哪些景点"，检查工作流是否有产生回答。 图17调试工作流 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002611999759.png "点击放大") 注意：测试过程中，如果发现回答截断，请检查"大模型"节点的"最大回复长度"是否设置过小，导致模型回答不完整。更新节点配置后，需单击右下角"确定"使配置生效。 图18优化大模型节点回复长度 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002555278109.png "点击放大") 3. 完成工作流调试后，单击界面右上角的"提交版本"按钮。 4. 系统将默认以单击提交版本时的时间填写版本名称，按需修改版本名称和版本描述后，单击"确定"。 随后，弹窗提示"部署成功"，则工作流搭建成功。 ![](https://support.huaweicloud.com/qs-agentarts/public_sys-resources/note_3.0-zh-cn.png) 工作流创建完成后，如果需要通过API调用，则需要将提交的版本部署至实例，具体操作请参考[发布并部署应用为API服务](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0031.html)。 图19提交版本 ![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002688570825.png "点击放大") #### 更多操作 - **可选：**在左侧导航栏中选择"开发中心 \> 智能体管理"，进入"工作流"页签，单击目标应用，选择"渠道管理"页签，可查看应用的调用方式，同时支持将应用分享至多个渠道。 - 在左侧导航栏中选择"开发中心 \> 智能体管理"，进入"工作流"页签，单击目标应用，单击界面右上角的版本历史图标"![](https://support.huaweicloud.com/qs-agentarts/zh-cn_image_0000002688506409.png)"，可查看当前工作流发布历史记录。 #### 相关文档 - 除手动搭建外，AgentArts平台还支持使用预置应用模板搭建智能体应用，可参考[使用模板搭建智能体](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0001.html)。 - 更多AgentArts的进阶使用实践请参见[AgentArts最佳实践](https://support.huaweicloud.com/bestpractice-agentarts/agentarts_06_0001.html)。