30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度1. 先搞清楚 Dify 到底能帮你做什么以及它和“写代码”的区别如果你正在找一种方法能快速把 AI 大模型比如 GPT、Claude、通义千问的能力变成可用的应用而不是自己从头写 API 调用、处理上下文、管理知识库那 Dify 就是为你准备的。它不是一个需要你一行行写业务逻辑代码的框架而是一个可视化编排 AI 工作流的平台。简单说Dify 的核心价值是让你用“搭积木”的方式把大模型、工具、数据、逻辑判断组合成一个完整的 AI 应用。比如你想做一个“智能客服机器人”传统方式你需要写后端 API 对接 OpenAI。自己处理对话历史管理。如果要接入知识库RAG还得写文档切分、向量化、检索的代码。如果要调用外部工具查天气、查数据库还得写函数调用逻辑。在 Dify 里这些步骤变成了拖拽节点、连线、配置参数。你关注的是“业务逻辑怎么走”而不是“代码怎么写”。所以这个教程的目标不是教你 Python 或 JavaScript而是教你如何在 Dify 这个平台上像产品经理或架构师一样设计和实现一个能跑起来的 AI 应用。这非常适合产品经理/业务人员想快速验证 AI 想法做出可交互的 Demo。全栈/后端开发者想快速搭建 AI 应用后端避免重复造轮子。AI 应用创业者/团队需要快速迭代和部署 AI 产品原型。2. 部署前想清楚云服务、本地 Docker 还是源码安装Dify 提供了多种部署方式选哪种取决于你的使用场景和资源。2.1 云服务最快上手适合个人学习和原型验证这是最省事的方式。直接访问 Dify 官方云服务注册账号就能用。优势是零运维功能最新自带算力通常按 token 或调用次数付费。适合快速体验所有功能。个人项目或小团队原型验证。不想操心服务器、网络、依赖问题。注意如果你处理的是敏感数据或者有严格的合规要求请谨慎使用公有云服务务必阅读其数据隐私政策。2.2 Docker 部署推荐给大多数开发者和企业这是平衡了便捷性和控制权的选择。Dify 官方提供了完整的 Docker Compose 配置能在你自己的服务器上几分钟内启动全套服务包括前端、后端、数据库等。环境准备以 Linux 为例一台服务器最低配置 2核 CPU4GB 内存20GB 磁盘。推荐 4核8G 以上以获得更好体验。系统可以是 Ubuntu 20.04/22.04 LTS CentOS 7/8 等。安装 Docker 和 Docker Compose这是必须的。可以通过官方脚本一键安装。网络服务器需要能正常访问互联网以下载 Docker 镜像和可能的模型。部署步骤# 1. 克隆部署仓库国内用户如果慢可以找找镜像源 git clone https://github.com/langgenius/dify.git cd dify/docker # 2. 复制环境变量配置文件 cp .env.example .env # 3. 重要编辑 .env 文件至少配置以下关键项 # 修改数据库密码设置一个强密码 # POSTGRES_PASSWORDyour_strong_password_here # 设置一个安全的加密密钥 # SECRET_KEYyour_secret_key_here # 如果需要外部访问修改监听地址 # APP_WEB_URLhttp://你的服务器IP:3000 # 4. 启动所有服务 docker-compose up -d启动后访问http://你的服务器IP:3000就能看到登录界面。首次登录需要创建管理员账号。为什么推荐 Docker环境隔离所有依赖Python、Node.js、PostgreSQL、Redis都打包在容器里不会污染宿主机环境。一键更新升级版本通常只需要拉取新镜像重新运行docker-compose up -d。易于迁移整个应用状态配置、数据都通过 Volume 挂在本地备份和迁移相对简单。2.3 源码部署适合深度定制和二次开发如果你需要修改 Dify 的源代码或者有特殊的部署环境要求比如 Kubernetes可以选择源码部署。这需要你具备 Python、Node.js 等环境的维护能力。步骤更复杂涉及前后端分别安装依赖、构建、配置数据库等。对于绝大多数“使用”而非“开发” Dify 的用户来说不推荐首选这种方式。我的建议是新手和绝大多数应用场景直接从 Docker 部署开始。这是踩坑最少、社区支持最全的路径。3. 核心概念打通应用、工作流、知识库与模型配置登录 Dify 后你会看到几个核心概念理解它们是你玩转 Dify 的基础。3.1 应用Application这是你最终交付给用户的东西。一个应用可以是一个聊天机器人、一个文本生成工具、一个自动处理流程等。在 Dify 中你创建应用然后在里面选择实现方式对话型应用或工作流。3.2 工作流Workflow这是 Dify 的灵魂。一个工作流由多个节点通过边连接而成形成一个有向无环图。每个节点代表一个处理步骤比如开始节点接收用户输入。LLM 节点调用大语言模型。知识库检索节点从你上传的文档中查找相关信息。代码执行节点运行 Python 代码。HTTP 请求节点调用外部 API。条件判断节点根据上一步结果决定流程走向。结束节点输出最终结果。你通过拖拽这些节点并连接它们就定义了一个完整的 AI 处理流水线。可视化编排大大降低了复杂逻辑的实现门槛。3.3 知识库Knowledge Base这是实现 RAG检索增强生成的关键。你可以上传 TXT、PDF、Word、PPT、Excel、网页链接等文件。Dify 会帮你自动完成文本提取与分割把文档切成适合检索的片段。向量化将文本片段转换为向量Embedding存入向量数据库如 QdrantDify 默认集成。检索当用户提问时从向量库中找出最相关的文本片段作为上下文喂给 LLM。这意味着你的 AI 应用可以“记住”你给它的文档内容回答更精准。3.4 模型配置Model ProvidersDify 本身不提供模型它是一个“连接器”。你需要在“设置”-“模型供应商”中配置你要使用的 AI 模型。云服务商如 OpenAI (GPT)、Anthropic (Claude)、百度千帆、智谱AI、月之暗面等。你需要提供对应的 API Key。本地模型通过配置 OpenAI 兼容的 API 端点可以连接本地部署的模型比如通过Ollama、LocalAI、vLLM等工具启动的模型。这是很多企业关注的点可以实现数据不出域。开源模型托管平台如 Together AI、Replicate 等。配置好后在工作流中就可以像选择工具一样选择不同的模型。4. 手把手实战从零构建一个“企业级”智能问答机器人理论讲完我们直接动手。目标构建一个能回答特定领域比如“公司内部规章制度”问题的机器人。它需要结合知识库RAG和逻辑判断。4.1 第一步准备知识库创建知识库在 Dify 侧边栏进入“知识库”点击“创建”。上传文档将你的规章制度 PDF、员工手册 Word 等文件上传。建议先整理成结构清晰的文档避免过多扫描件图片OCR 效果可能不稳定。配置处理方式选择文本分割方式按段落、按字符数以及 Embedding 模型通常用默认的就行。点击“处理”Dify 会在后台进行向量化。检查状态处理完成后知识库状态会变为“可用”。你可以点击“测试”按钮输入一个问题看它能否检索到相关片段。这一步很重要是验证知识库质量的关键。4.2 第二步创建工作流创建应用点击“创建应用”选择“工作流”给它起个名字比如“规章制度问答助手”。设计流程我们将设计一个包含以下节点的简单工作流开始-知识库检索-LLM-结束。但这样太简单了。我们加一点逻辑如果用户问的是“今天天气如何”这类与知识库无关的问题我们直接让 LLM 回答如果是关于规章制度的问题才去检索知识库。拖拽节点从左侧面板拖入一个开始节点。拖入一个条件判断节点If/Else。拖入一个知识库检索节点。拖入一个LLM节点可以拖两个一个用于通用回答一个用于基于知识库的回答。拖入一个结束节点。连接节点将开始节点的输出连接到条件判断节点的输入。从条件判断节点的“是”分支连接到知识库检索节点再连接到LLM基于知识库最后到结束。从条件判断节点的“否”分支直接连接到LLM通用再到结束。配置节点条件判断节点这是核心。我们需要设置一个规则来判断用户问题是否与规章制度相关。一个简单的方法是使用关键词匹配。在条件里可以写一段判断逻辑例如检查用户输入是否包含“制度”、“规定”、“流程”、“请假”、“报销”等关键词。Dify 的条件节点支持变量和简单表达式。知识库检索节点选择你刚才创建的“规章制度”知识库。配置检索参数比如“最大召回数量”设为 3“相似度阈值”设为 0.7低于这个值的结果不返回。将开始节点传来的用户问题{{query}}作为检索查询。LLM 节点基于知识库选择你配置好的模型如 GPT-4。在系统提示词中写清楚角色和任务“你是一个公司规章制度助手请严格根据提供的参考资料回答问题。如果参考资料中没有相关信息请如实告知‘根据现有规定未找到相关信息’。”在用户提示词中这样组织用户问题{{query}}\n\n参考资料{{knowledge_retrieval_node.output}}。这里knowledge_retrieval_node.output就是上一个知识库检索节点的输出。LLM 节点通用选择同一个或另一个模型。系统提示词可以是“你是一个友好的助手”。用户提示词直接传入{{query}}。4.3 第三步测试与调试点击运行在工作流画布右上角有一个“运行”按钮。在右侧的调试面板输入问题比如“请假流程是什么”点击运行。查看执行轨迹Dify 会高亮显示流程经过的节点并在每个节点下方显示输入输出。这是排查问题的神器。看看条件判断节点走的是哪个分支对不对看看知识库检索节点返回了哪些文本片段相关吗看看LLM节点收到的完整提示词是什么它的回答是否基于了参考资料迭代优化条件不准调整关键词或使用更复杂的判断逻辑比如可以用一个简单的 LLM 调用先做意图分类但这属于进阶用法。检索不准回到知识库检查文档分割是否合理或者调整检索的“相似度阈值”。回答不好优化 LLM 的系统提示词和上下文组织方式。4.4 第四步发布与集成发布应用测试无误后点击“发布”。Dify 会为该工作流生成一个唯一的版本。获取访问方式Web 界面可以直接获得一个可分享的 URL用户通过网页访问。APIDify 为每个已发布的应用提供标准的 OpenAI 格式的 API。你可以在“应用概览”-“访问方式”中找到 API 地址和密钥。这意味着你可以用任何编程语言像调用 ChatGPT API 一样调用你的这个定制机器人。嵌入到网站/产品Dify 提供了嵌入代码片段可以快速将聊天窗口嵌入到你的网站中。5. 深入进阶构建复杂工作流与集成外部能力单一问答机器人只是开始。Dify 工作流的强大在于可以串联复杂逻辑。5.1 多步骤决策与工具调用假设我们要做一个“智能周报生成器”工作流开始用户输入“生成本周周报”。HTTP 请求节点调用公司内部任务管理系统 API获取用户本周创建和完成的任务列表。HTTP 请求节点调用代码仓库如 GitLabAPI获取用户本周的代码提交记录。变量分配节点将以上两个 API 的返回结果整理成结构化的数据变量。LLM 节点将任务列表、代码记录作为上下文让 LLM 生成一份格式优美的周报草稿。条件判断节点判断周报草稿是否超过 500 字。是分支超过500字连接另一个LLM 节点让它生成一个摘要。结束节点输出周报全文和摘要。这个流程涉及了多次外部 API 调用、数据整合、条件分支和多个 LLM 协作如果用代码写会非常繁琐但在 Dify 里就是拖拽和配置。5.2 利用“工具”节点扩展能力Dify 支持自定义“工具”。你可以将一段 Python 代码实现特定功能如数据处理、计算封装成一个工具节点在工作流中反复使用。这相当于为你自己的工作流创建了可复用的函数库。5.3 与 MCPModel Context Protocol集成这是 Dify 一个非常前瞻性的功能。MCP 是一种让 AI 应用安全、标准化地访问外部数据和服务的协议。通过 MCP你的 Dify 工作流可以轻松连接到数据库、内部系统 API、云服务等而无需编写复杂的适配代码。这为构建企业级、能处理真实业务数据的 Agentic AI 应用打开了大门。6. 企业级实战项目思路与避坑指南标题里提到“50个企业级实战项目”其核心思路是将不同的业务场景抽象成可编排的工作流。这里提供几个方向客户服务自动工单分类、基于知识库的精准回答、情绪分析与升级。内容运营多渠道素材一键生成文章、社交媒体文案、邮件、热点监控与报告生成。内部效率会议纪要自动生成与任务提取、代码审查助手、数据查询与分析助手连接数据库。研发辅助API 文档问答机器人、错误日志分析与解决方案推荐、代码生成与审查流水线。避坑经验知识库质量决定上限RAG 效果不好八成是知识库的问题。文档要干净、格式规范。上传前最好做预处理去掉无关页眉页脚、广告。分割 chunk 的大小和重叠度需要根据文档类型微调。提示词工程仍在关键路径上Dify 降低了工程复杂度但如何给 LLM 下指令提示词依然需要精心设计。系统提示词要清晰定义角色、约束和输出格式。多利用工作流中的“变量”来动态构建提示词。理清“对话型应用”和“工作流”的界限简单的多轮对话用“对话型应用”配置系统提示词和知识库就够了。涉及到复杂逻辑、多步骤、条件分支、外部调用果断用工作流。监控与迭代Dify 提供了对话日志、标注和效果评估功能。要定期查看用户的真实提问和机器人的回答发现 bad cases反过来优化知识库、提示词或工作流逻辑。成本控制如果使用按 token 付费的云模型注意工作流中不必要的 LLM 调用。例如在调用知识库前可以先用一个更便宜的模型或规则判断问题是否在知识库范围内。本地部署的模型选择如果选择本地模型7B、13B 参数量的模型在通用对话上已可用但在复杂逻辑、中文、知识问答上可能仍需 70B 级别或专门的微调模型才能达到商用要求。需要平衡效果、速度和硬件成本。7. 从项目到生产稳定性、安全与团队协作当你的 Dify 应用要从 demo 走向真实用户时需要考虑更多。高可用部署生产环境不建议用单机 Docker Compose。可以考虑将 Dify 的组件API 服务器、Worker、前端部署在 Kubernetes 上并配置好数据库、Redis 的高可用方案。权限与审计Dify 支持团队协作、角色权限管理管理员、编辑者、普通用户。确保知识库、应用的修改权限得到控制。所有 API 调用和关键操作应有日志记录。数据安全如果使用云端模型 API确保传输加密并了解供应商的数据隐私政策。对于敏感数据优先考虑本地模型部署方案。性能优化对于高频访问的应用可以启用对话缓存。优化知识库的索引结构。监控工作流中各节点的耗时对慢节点进行优化如优化检索参数、使用更快的模型。最后也是最重要的建议不要试图用 Dify 一次性构建一个完美无缺的复杂系统。它的优势在于快速原型和迭代。从一个最小的、可用的核心工作流开始跑通数据流获得用户反馈然后像搭积木一样一步步添加新的节点和分支。这种可视化、可即时调试的方式能让你和你的团队以前所未有的速度将 AI 的想法落地为真实可用的产品。 30款热门AI模型一站整合DeepSeek/GLM/Qwen 随心用限时 5 折。 点击领海量免费额度