一套面向零基础小白的 Dify 实战教程：通过 5 个可复用的真实项目（包含可导入的 DSL、脚本、数据与配图），手把手带你掌握 从需求 → 提示词 → 知识库/工具调用 → 工作流编排 → 输出交付 的完整链路。
- 如何在 Dify 中选择 Chatflow vs Workflow 并正确拆解节点
- 如何用 知识库检索（RAG） 约束大模型输出
- 如何把自然语言问题 稳定转换为 SQL 并在代码节点执行
- 如何接入 外部搜索工具，把网页内容汇总成结构化文档
- 如何做 文件解析 → 结构化数据 → 代码生成可视化
- 如何接入本地 Ollama，搭建离线翻译 Agent
| 序号 | 项目 | 类型 | 你会做出什么 | 关键素材 |
|---|---|---|---|---|
| 1 | 数据查询智能助手 | Chatflow | 自然语言问数 → 生成 SQL → 查询 MySQL → 返回解释 | DSL/数据查询智能助手.yml, 知识库/tbl_info.txt, 资料/sql.py, 资料/mydb.sql |
| 2 | 技术手册生成助手 | Chatflow | 输入技术点 → Tavily 搜索 → 抓取网页 → 汇总成手册 | DSL/技术手册生成助手.yml |
| 3 | 爆款标题生成助手 | Workflow | 输入主题/平台/受众 → 生成 10 个爆款标题 | DSL/爆款标题生成助手.yml |
| 4 | 数据可视化助手 | Workflow | 上传 Excel → 提取数据 → 生成 CSV → 代码节点输出柱状图 | DSL/数据可视化助手.yml, 资料/generate_echarts.py, 资料/产品月度销量数据.xlsx, 资料/城市月度降水量数据.xlsx |
| 5 | 翻译助手（Ollama） | Chatflow | 中文 → 英文（本地模型） | DSL/翻译助手.yml |
.
├── README.md
├── DSL/
│ ├── 数据查询智能助手.yml
│ ├── 技术手册生成助手.yml
│ ├── 爆款标题生成助手.yml
│ ├── 数据可视化助手.yml
│ └── 翻译助手.yml
├── assets/ # 项目配图
├── 知识库/
│ └── tbl_info.txt # 项目一：表结构知识库
└── 资料/
├── mydb.sql # 项目一：建表+数据
├── sql.py # 项目一：Python 执行 SQL 示例
├── generate_echarts.py # 项目四：ECharts 代码示例
├── 产品月度销量数据.xlsx
└── 城市月度降水量数据.xlsx
- 一个可用的 Dify（云端或自部署均可）
- 一个大模型供应商配置（OpenAI / 通义 / 智谱 / DeepSeek / 其它均可）
按项目不同，还会用到：
- 项目一：MySQL+ 可访问的数据库账号
- 项目二：Tavily Search API Key（在 Dify 工具里配置）
- 项目四：需要 Dify 支持文件上传 + 文档提取器节点
- 项目五：本地 Ollama（用于离线翻译）
在 Dify 控制台中新建应用后，选择 Import DSL，导入本仓库 DSL 目录下对应的 .yml 文件即可。
提示：如果导入后节点提示缺少变量/工具，只需要在 Dify 中按提示补齐配置（例如数据库连接信息、Tavily Key、模型供应商等）。
目标：用自然语言对话查询数据库。
核心流程：
用户输入 → 知识库检索（表结构）→ LLM 生成 SQL → 参数提取 SQL → 代码节点执行 SQL 查询 → LLM 解释结果 → 输出
配图：
- 流程图：
- 样例：
关键步骤：
- 在 MySQL 中准备数据库及表（见 资料/mydb.sql）
- 在 Dify 中导入知识库文件（见 知识库/tbl_info.txt）
- 按教程提示词约束 SQL 生成（只允许
SELECT，字段必须来自知识库） - 参考 资料/sql.py 完成 SQL 执行与结果返回
目标：输入技术点，自动检索并生成“可读的技术手册”。
核心流程：
用户输入 → Tavily 搜索 → 提取 URL 列表 → 迭代抓取网页内容 → 汇总整合 → 输出技术文档
配图：
- 流程图：
- 样例：
必备配置：
- Tavily Search 工具 Key（在 Dify 工具/凭证中配置）
目标：用标准化提示词与结构化输入，稳定批量生成爆款标题。
配图：
- 流程图：
- 样例：
你会重点练到：
- 变量设计（主题/平台/受众）
- 输出格式约束（列表、类型标注）
目标：上传 Excel，一键生成柱状图可视化。
核心流程：
上传文件 → 文档提取器解析 → LLM 转 CSV → 代码执行节点生成 ECharts option/HTML → 输出图表
配图：
- 流程图：
- 样例：
数据与代码：
目标：接入本地 Ollama，实现离线翻译 Agent。
配图：
- 流程图：
- 配置截图：
- 样例：
你会重点掌握：
- 在 Dify 的模型供应商中配置本地模型（Ollama）
- 用最少节点实现稳定可控的翻译链路
1）DSL 导入后节点报错怎么办？
- 通常是缺少模型、工具凭证或变量。
- 按 Dify 的错误提示逐项补齐配置即可（数据库连接、Tavily Key、Ollama 等）。
2）项目一生成的 SQL 不稳定怎么办？
- 确保知识库中只包含“真实的表结构信息”（见 知识库/tbl_info.txt）。
- 提示词里要强约束：只允许
SELECT、字段必须来自知识库、无法生成时返回兜底 SQL。
3）项目四图表显示异常怎么办？
- 优先检查文档提取器是否正确抽取了 Excel 表格内容。
- 再检查 LLM 转 CSV 是否包含表头、分隔符是否一致。