Dify 知识库搭建教程 新手从文档上传到智能问答

很多人第一次看 Dify，最容易想得太大。又想做客服，又想做内部助理，又想接工作流，最后打开后台反而不知道先点哪里。

新手先从一个最小版本开始就够了。准备一份文档，建一个聊天助手，把文档导成知识库，再让助手按这份资料回答问题。这个流程走通以后，后面再加更多资料，心里就有数了。

下面这篇按真实操作截图来讲。你照着做，先别急着追求复杂效果。

一 先配置模型供应商

Dify 自己负责应用页面，知识库和流程编排，真正回答问题还要靠模型。所以第一步要先去设置里看模型供应商。

如果你本地已经用 Ollama 跑了模型，可以在模型供应商里搜索 Ollama，然后安装对应插件。

安装后还要把模型名称和访问地址填进去。截图里用的是本地 Ollama，模型名填的是 deepseek-r1:1.5b，基础 URL 填的是本地部署环境对应的地址。

这一步别随便跳过。后面创建应用时，右上角能选到模型，才说明这里配置成功了。

二 创建一个聊天助手应用

模型接好以后，回到应用页面，新建一个空白应用。新手做知识库问答，先选聊天助手。

聊天助手比较适合这种场景。用户直接提问，应用从知识库里找相关内容，再组织成一段能读懂的回答。客服问答，课程资料，公司制度，产品说明，都可以先用这个入口试。

应用名称不用太复杂，先写清用途。比如课程资料助手，产品说明助手，售后问答助手。名称越贴近资料，后面自己找起来越省事。

三 先在编辑页测试一下模型

应用创建完成以后，会进入编辑页。左边是提示词，变量和知识库设置，右边是调试预览。

这时可以先问一句普通问题，看看模型能不能正常回复。能回复，说明模型这边已经能用。不能回复，就先回去查模型供应商配置，别急着上传文档。

提示词一开始不用写得太花。你可以先让它做一件简单的事，按资料回答用户问题，资料里没有就说明没有找到相关内容。这样后面测试知识库时，问题更容易定位。

四 从应用里添加知识库

编辑页往下看，会看到知识库区域。这里点击添加，就能把应用和知识库接起来。

如果当前还没有知识库，Dify 会提示创建。这个地方很多新手会卡一下，以为必须先去别的页面建好。其实从应用里加也可以，流程能顺着走下去。

知识库适合放整理好的资料。比如 PDF 课件，Markdown 文档，Word 文档，产品说明书，常见问题表。资料越乱，回答越容易跑偏。先拿一份干净文档试，比一次塞几十个文件更稳。

五 上传文档

创建知识库时，先选择数据来源。最常用的是导入已有文本，然后上传文件。

截图里上传的是一个 PDF 课件。Dify 支持多种常见文档格式，新手不用先研究所有格式，先拿手上最完整的一份资料测试。

上传文件以后，不要马上想着发布。先看下一步的文本处理和索引方式。

六 看一下分段和索引

知识库能不能答准，很大程度取决于文档怎么切分。

分段太短，模型拿到的上下文会碎。分段太长，检索时又可能带进太多没用内容。新手可以先用默认设置，跑几轮问题以后再改。

截图里能看到分段设置，索引方式，还有知识库创建完成后的状态。只要文档显示可用，应用那边才有资料可以引用。

这里有个小经验。第一份文档不要选太大，最好是十几页以内，问题也先围绕文档里明确写过的内容来问。这样你能判断是资料没导好，还是提示词没写清。

七 把知识库接回应用并测试

知识库创建好以后，回到应用编辑页，在知识库区域选中刚才那份资料。

接上以后，右侧调试区再问一个和文档有关的问题。截图里能看到，应用已经带着 PDF 资料回答。这个状态才算最小版本跑通。

测试时建议问三类问题。

第一类，文档里能直接找到答案的问题。它应该答得比较稳。

第二类，文档里只有部分信息的问题。它应该把能找到的内容说出来，并提醒缺少哪些材料。

第三类，文档里完全没有的问题。它最好别硬编。能做到这一点，才适合给别人用。

八 Dify 知识库适合哪些场景

客服常见问题适合。问题重复，答案范围固定，资料也容易整理。

产品说明适合。安装步骤，参数解释，售后流程，版本差异，都可以放进文档里。

公司制度适合。请假，报销，审批，入职流程，这些问题本来就需要按资料回答。

课程资料适合。课件，讲义，学习笔记，考试说明，都能先做成小知识库。

个人资料整理也适合。比如把自己写过的教程，项目记录，常用命令放进去，后面查起来会方便很多。

Dify 知识库不太适合资料经常变来变去的场景，也不适合答案必须百分百准确的严肃业务。至少在新手阶段，先把它当成资料问答工具，别一上来就让它替人做决定。

把这条线跑通以后，你对 Dify 的理解会清楚很多。到最后要看的就是三件事。资料能不能整理清楚，问题能不能落回资料，回答能不能经得起测试。