扣子开源版知识库怎么搭建？导入 FAQ 并验证三类提问

在扣子开源版 Coze Studio 中搭知识库，关键是完成“文档被解析、问题召回正确片段、回答忠于片段”这三个环节。文件出现在列表里，只证明上传了；智能体说得流畅，也不能证明它读过你的资料。下面用一份虚构 FAQ，把每个环节拆开检查。

本文适用于已经部署并能登录 Coze Studio、能够创建知识库和工作流的用户。开源项目的功能与部署入口见官方 README。商业版低代码平台的账号入口与开源版不同：在自己的 Studio 里操作，无需寻找“回到旧版”。本文未在读者实例上实测，FAQ、提问和目标答案均为演示。

先准备一份容易核对的 FAQ

将下面材料保存为 UTF-8 文本文件 faq_demo.txt。这是虚构的“青杉资料站”规则，不对应任何真实商家。每个问题保留编号和完整答案，方便发现召回串题。

FAQ-A：资料下载链接多久有效？
回答：下载链接从生成时起有效 24 小时。过期后重新生成链接。

FAQ-B：资料下载次数有限制吗？
回答：同一链接最多下载 3 次。次数用完后重新生成链接。

FAQ-C：怎样反馈资料中的错误？
回答：发送邮件至资料站帮助页面列出的邮箱，注明资料编号和错误位置。

先用这种小材料排除环境问题，再导入大量文档。不要加入互相矛盾的规则，也不要把退款、会员权限等没有提供的事实交给模型补齐。

创建文本知识库，等解析完成

1. 登录自己的 Studio，在工作空间进入资源库，创建知识库，选择文本和本地文档，上传 faq_demo.txt。菜单表述会随版本变化，目标是文本知识库的本地文件导入入口。
2. 按页面引导处理文档，检查解析预览中是否完整出现 FAQ-A、FAQ-B、FAQ-C 与各自答案，再完成导入。
3. 等待文档处理成功。若状态仍在处理中或显示失败，先看具体错误；此时不要把下游空结果归因于提示词。
4. 进入文档内容或片段预览，核对“24 小时”和“3 次”分别归属正确问题。小 FAQ 可以先使用界面提供的默认处理方式，是否需要调整由实际召回结果决定。

文本、本地导入和解析流程可对照官方知识库创建说明。该文档还包含商业版功能；本例只用开源版提供的文本知识库，不要求云端存储套餐或商业版专属资源。

若上传后一直无法解析，检查 Studio 管理后台中知识库依赖的组件、模型配置和服务错误。聊天模型能回答一句话，不等于知识库需要的向量化、索引和检索组件全部可用。把报错留在文档处理环节解决。

先只测检索，再接生成回答

创建普通工作流，先连成开始 → 知识库检索 → 结束。开始节点增加 String 类型参数 question；检索节点选择刚创建的知识库，把 Query 设为对开始.question 的变量引用。先不要加入联网搜索或其他资料库。

结束节点增加名为 hits 的输出，引用检索节点的 outputList，并按它的实际数组结构设置输出类型。第一次试运行输入“资料链接有效多久？”，打开检索节点输出，检查 outputList 中是否有 FAQ-A 和“24 小时”。

官方检索节点说明给出了 Query 和 outputList 的含义。Query 是检索问题，outputList 是召回片段数组，包含片段内容与文档标识。空数组表示本次没有召回，并不等于程序已经知道正确答案。

只有检索成功后才插入大模型节点，连成开始 → 检索 → 大模型 → 结束。大模型普通输入增加 question 与 evidence：分别引用开始.question、检索.outputList；如果当前界面不接受数组作为该输入，引用片段文本或先将数组转换为文本，别手动把变量名当作内容填写。

你是资料站帮助助手。只根据给定 evidence 回答 question。
回答必须指出依据中的 FAQ 编号。
如果片段没有回答这个问题，回复“资料中没有明确说明”，不要用常识补齐规则。
question：{{question}}
evidence：{{evidence}}

结束节点改为输出大模型的文本结果。{{question}} 和 {{evidence}} 是本例设置的输入名，在编辑器中用变量选择器绑定实际字段；绑定后查看试运行的节点输入，确认它收到的是问题与片段内容。

用三类提问判断是否跑通

每个问题分别运行，记录召回片段和最终答案。不要只检查最后一句：召回错了但模型碰巧答对，仍不算检索链路通过。第二类问题若未召回，先核对 Query、文档处理状态与检索方式；调整一个参数后用同样的问题重测。

结果不对，按所在环节修复

• 列表有文件、检索为空：检查文档是否已处理成功、节点是否选中正确知识库、Query 是否收到非空问题，再查看检索服务报错。
• 召回了下载次数，没召回有效期：检查材料标题与问答是否在预览中错位，查看实际片段；不要先盲目增加返回数量。
• 片段正确，回答仍编规则：打开大模型输入，确认 evidence 绑定成功；保留“无依据拒答”的指令，重测资料外问题。
• 工作流通过，智能体仍不调用：发布工作流后，在智能体技能中添加它，在回复逻辑中明确“询问资料站规则时调用此工作流，传入用户原问题”，再检查实际调用记录。

这组测试验证的是小 FAQ 的导入、召回和回答约束，不能证明大库准确率、员工权限隔离或所有业务问题已覆盖。通过后，再以真实资料建立同样的核对题，并检查最终答案中每条规则是否能追溯到文档。