在 VM0 上搭建企业知识库问答工作流，核心是把「提问 → 检索 → 生成答案」的过程固化成可管理的节点，并确保知识库始终与最新文档同步。搭建前需要先确认两个边界：一是 VM0 知识库能解析哪些文档格式，二是工作流中哪些节点会消耗检索资源。以下按配置顺序给出操作路径。
判断：VM0 企业知识库问答工作流适合已有明确文档目录、需要统一回答高频问题的团队。操作上应先核对知识库支持的文件格式，再按「用户输入 → 意图分类 → 向量检索 → 答案生成」顺序配置节点，同时打开增量更新开关。验证时用固定测试集跑一遍，观察日志中每个节点的耗时与错误码。风险边界：模型回答准确性取决于知识库覆盖范围和检索阈值，不承诺业务级正确性。
先确认 VM0 知识库支持的数据源格式
VM0 知识库通常支持常见的文本型文档，例如 PDF、Markdown、Word（.docx）、TXT 等。但不同版本或部署环境的解析能力会有差异，特别是图片型 PDF（扫描件）需要 OCR 支持，在部分环境中默认不开启。所以在上传第一批文档前，建议在「知识库管理」→「数据源配置」中查看当前环境支持的格式清单，或在「上传文档」界面查看文件类型限制。
检查格式识别状态的办法：上传文档后，在文档列表中找到对应文件，观察「解析状态」列。常见状态有「解析中」「已完成」「失败」。「解析中」表示文件正在转换和切片；「已完成」代表已进入索引队列；「失败」则需要点击状态图标查看具体错误原因，常见原因是文件损坏、格式不支持或超出单文件大小限制。如果文档显示「失败」但格式属于支持列表，可以尝试重新上传或转成 Markdown 后再试。
用自然语言创建问答工作流的关键节点
在 VM0 的工作流编辑器中，可以从空白画布开始，用自然语言描述节点行为和连接关系。一个标准的问答工作流至少包含四个节点的顺序连接：用户输入、意图分类、向量检索、答案生成。
节点顺序说明：
- 用户输入：捕获用户从对话窗口发送的文本，存入变量供后续节点使用。
- 意图分类：判断当前问题是否与知识库内容相关，决定是否继续走检索链路，或转入转人工等分支。
- 向量检索：从已配置的知识库索引中搜索与用户问题最相近的文档片段，通常需要指定返回数量（top_k）。
- 答案生成：把检索到的片段拼接成上下文，调用大模型生成回答文本，并返回给用户。
在 VM0 中，可以直接用自然语言指令描述节点，例如：
用户输入：读取用户消息，写入变量 user_query
意图分类：如果 user_query 包含“报销政策”，则进入向量检索节点；否则返回“该问题不在知识库范围内”
向量检索：基于 user_query 从“企业知识库”索引检索，返回 top_k=5 的文档片段
答案生成：将检索片段作为上下文，调用生成模型，要求“仅根据上下文回答，不要编造”编辑器会根据这段文字自动生成对应的节点和参数，后续也可以手动修改条件分支条件来扩展适用范围。
配置知识库索引与更新策略
创建索引的步骤：在「知识库管理」中点击「新建索引」，填写索引名称，选择需要关联的数据源（文件夹或文档集），保存后系统会自动开始首次解析。索引创建完成后，在「向量检索」节点中就能选择该索引名称进行引用。
增量更新开关在索引配置的「同步设置」里，通常标识为「自动同步」或「增量更新」。打开后，知识库会定时检查数据源目录下的文件变化，把新增或修改的文件增量解析进索引，避免每次都要全量重建。建议打开此开关，并设定一个适合团队更新频率的检查周期（如每 15 分钟或每小时）。
如果手动改动了大量文档，可以在索引列表中找到对应索引，点击「重建」按钮强制重新解析全量文件。重建过程会占用一定的计算资源，在数据量较大时耗时较长，可以观察索引详情页的重建进度决定是否等待。
用测试集验证问答结果并修正边界
工作流配置完成后，先不要直接发布，建议用一组固定的测试用例来验证回答质量。测试集应覆盖高频问题、边缘问题和不在知识库内的问题，将每个问题的期望回答和实际回答记录成表格。
| 输入 | 期望回答 | 实际回答（记录时填写） |
|---|---|---|
| 加班费怎么算 | 返回具体的加班费计算规则和政策依据 | 如果只返回了“加班费”三个字相关文档标题，说明检索命中不精准 |
| 如何申请办公设备 | 给出申请流程步骤和所需材料 | 如果回答是通用客服话术，可能未检索到对应文档 |
| 公司年假天数上限 | 返回明确的天数和限定条件 | 如果无法回答，可能是文档缺失或索引未同步到位 |
根据测试结果，优先调整两个位置：
- 检索阈值：在「向量检索」节点中调低相似度阈值会返回更多片段，适合答案分散在多个文档的场景；调高阈值则只返回高匹配片段，适合文档密集、需要精确答案的场景。调整后重新跑同一组测试集。
- 提示词：在「答案生成」节点中，把提示词改写为更严格的要求，例如「仅根据上下文回答，不要推测」；如果希望回答更有条理，可以要求「按步骤列出」。提示词修改对答案边界的影响通常比检索阈值更明显。
通过日志确认发布后请求链路是否完整
工作流发布后，点击 VM0 左侧菜单的「运行日志」进入请求列表。通过时间筛选和关键词搜索，可以看到每一次调用的请求 ID、工作流名称、完成状态和耗时。点击请求 ID 可进入链路详情页，按节点顺序展示每个步骤的名称、耗时和状态码。
以下是配置完成后运行日志中会出现的请求结构样例：
Request ID: a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d
Workflow: 企业知识库问答（发布版）
节点执行顺序：
[1] 用户输入 耗时 5ms 状态 success
[2] 意图分类 耗时 12ms 状态 success
[3] 向量检索 耗时 132ms 状态 success
[4] 答案生成 耗时 1.2s 状态 success需要重点看两个地方：一是每个节点后面的状态是否为 success，如果有 failure，错误码会显示在状态旁；二是节点耗时是否异常，向量检索耗时突然增大时，往往需要确认索引是否需要重建。错误码查看位置在详情页「错误信息」区域，常见码如 401（认证失败）、404（索引不存在或已删除）、503（模型服务超时）。确认四个节点都执行成功，且耗时稳定，发布后的请求链路才算真正完整。