跳到主内容

Dify 搭建智能体教程:零代码跑通第一个 AI 应用

100%
Dify 搭建智能体教程:零代码跑通第一个 AI 应用

Dify 搭建智能体这件事,本质上不需要写一行代码:它是一个开源的 LLM 应用开发平台,通过可视化编排把模型、知识库、工具和工作流拼装起来,新手大约 15~20 分钟就能跑通第一个能查自己文档的 AI 聊天助手。名字取自「 Do It For You 」的首字母,定位介于纯 SaaS 套壳产品和从零写代码之间——想要快速验证想法,它比写后端快得多;想要私有化部署,它的 Community 版也能用 Docker Compose 在自己服务器上几分钟跑起来。

Dify 是什么:开源 LLM 应用开发平台

根据 Dify 官方文档(docs.dify.ai)的定位,它是一个用于构建 AI 应用的开源平台,支持创建智能体(Agent)、代理工作流(Agentic Workflow)和聊天机器人,应用可以接入你自己的数据,之后发布为 Web 应用或通过 REST API 集成到自有产品。核心能力可以概括为四块:

  • 可视化编排:在画布上拖拽节点(开始、知识检索、 LLM 、条件分支、直接回复)并用连线定义数据流向,逻辑一目了然;
  • 知识库与 RAG:上传 PDF 、 Word 、 Markdown 等文档(单个最大 15MB),平台自动分块、向量化,检索结果作为上下文注入 LLM——这正是典型的 RAG 检索增强生成架构,原理可参见RAG 检索增强生成一文;
  • 模型与工具接入:通过插件市场接入 OpenAI 等模型供应商,也可挂载自定义 API 工具,让智能体具备查数据、发请求的能力;
  • 发布与集成:一键发布为独立 WebApp 、生成嵌入网页的 iframe 代码,或开放 API 给后端调用。

我的体验是,Dify 最有价值的地方不是某个单项功能,而是把「改提示词—测对话—看日志」的迭代闭环压缩到了同一个界面里,试错成本极低。

Dify 搭建智能体实战:创建第一个聊天助手

下面用官方教程中「智能客服机器人」的最简路径,演示从注册到发布的完整流程。第一步是在云端或本地跑起 Dify:


  1. 选择运行方式:直接用 Dify Cloud(dify.ai,含免费 Sandbox 计划,开箱即用),或用 Docker Compose 自托管 Community 版到自己的服务器,两者界面一致。

  2. 创建应用:登录后点击「创建应用」,选择「聊天助手」或「 Chatflow 」类型,填写名称如「产品 FAQ 助手」。聊天助手适合纯对话,Chatflow 适合带检索和分支的流程。

  3. 配置模型:进入编排页面,在右上角选择模型供应商并填入 API Key(如 OpenAI 或其他兼容模型),建议选中文理解能力强的模型。

  4. 搭建知识库:进入左侧「知识库」菜单,选择「导入文件」上传产品文档,分段设置保持默认 General,索引方式选 High Quality(需配置一个 embedding 模型,如 text-embedding-3-small),检索用默认向量检索,点击保存并处理。注意 High Quality 索引建成后无法降级回 Economical 模式。

  5. 接入检索:回到编排画布,添加「知识检索」节点并勾选刚才的知识库,再把其输出连接到 LLM 节点的上下文(context)变量,同时确保系统提示词中引用了 {context}——这两处缺一不可,漏掉任何一处 LLM 都拿不到文档内容。

  6. 打磨提示词:在系统提示词中约束模型「只根据提供的文档内容回答,没有相关信息就明确告知」,可参考 Anthropic 提示词工程最佳实践(Anthropic 提示词工程最佳实践)中的结构与边界设定方法。

  7. 测试与发布:点击右上角「预览」用真实问题验证回答准确性,确认后点击「发布」;在「访问点」标签页可获取 WebApp 链接、网站嵌入代码或 API 密钥。

部署方式怎么选:云端 vs 自托管

维度Dify Cloud自托管 Community
上手速度注册即用,零运维需服务器 + Docker 环境
数据合规文档上传至第三方平台数据完全留在内网
费用免费 Sandbox,按用量升级软件免费,承担服务器成本
适用对象个人验证、快速原型企业内部知识库、敏感数据

简单结论:先在云端验证想法,跑通后再用 Docker Compose 迁到自己的服务器,两边配置可以复用。如果后续要让智能体连接更多外部系统,可以基于 Dify 的工具机制扩展,例如通过自建 MCP Server 接入私有接口,教程见MCP Server 自己搭建教程;需要跨会话记住用户偏好的场景,则要额外设计记忆层,思路可参考AI Agent 记忆怎么实现。

知识检索节点配好后回答仍是空话,九成是 context 变量没接对:检查两处——LLM 节点的「上下文」字段要选中知识检索的 result 变量,且系统提示词里确实插入了 context 占位变量。 Dify 官方模板的提示里专门强调过这个坑。

Dify 是免费的吗?
Dify 是开源项目,Community 版自托管完全免费;云端版提供免费 Sandbox 计划,超过配额后按订阅付费。个人学习和原型验证基本零成本即可起步。

不会编程能用 Dify 搭智能体吗?
可以。创建应用、上传知识库、编排节点、发布链接全流程都是图形界面操作,唯一需要填写的是模型供应商的 API Key 。想接入自己的业务接口时才涉及少量配置工作。

Dify 的知识库支持哪些文件格式?
支持 PDF 、 DOCX 、 PPTX 、 XLSX 、 CSV 、 TXT 、 Markdown 、 HTML 、 EPUB 等常见格式,单个文件上限 15MB(不同套餐可能不同),还支持从 Notion 和网页同步内容。

自托管 Dify 对服务器有什么要求?
官方推荐至少 2 核 CPU 、 4GB 内存的 Linux 服务器并安装 Docker 与 Docker Compose,启用向量索引和更多并发时建议 8GB 以上内存。

这篇有帮助吗?
云上的幻象
云上的幻象查看主页

七彩云博客,分享 WordPress 建站实战与 AI 工具测评,覆盖服务器运维、站长工具、软件资源与电商运营干货,专注原创实用的主题插件、网站加速与安全优化教程。

752文章4评论

相关文章

评论 (0)

欢迎你,新朋友,感谢参与互动!文明发言,理性交流 · 首次评论将在审核后展示