在AI应用开发日益平民化的今天，Dify作为一款开源的大语言模型应用开发平台，凭借其直观的可视化工作流和丰富的模型接入能力，已成为全球开发者构建AI应用的首选工具之一。截至2026年5月，Dify在GitHub上已获得超过8万星标，被超过50万开发者用于生产环境。

本教程将带你从零开始，在30分钟内构建一个智能客服助手——它能理解用户意图、查询知识库、并在必要时调用外部API获取实时信息。

📋 准备工作

• Dify账号：访问 dify.ai 注册免费账号（云版），或使用 docker compose up -d 自托管部署
• LLM API Key：至少一个模型提供商的API密钥（推荐DeepSeek、OpenAI或Claude）
• 基础知识：无需编程经验，但了解Prompt工程基础会更有帮助

🚀 第一步：创建应用并配置模型

登录Dify后，点击"创建应用"→ 选择"聊天助手 → 工作流编排"。这是Dify最强大的模式，允许你像搭积木一样组合各种节点。

进入工作流编辑器后，首先需要配置LLM节点。在左侧面板拖入一个LLM节点，点击配置：

1. 在"模型"下拉中选择你的模型提供商（如DeepSeek）
2. 填入API Key或选择已配置的凭据
3. 选择模型版本（推荐 DeepSeek-V3 或 GPT-5.5 Instant，平衡性能与成本）
4. 设置温度参数为 0.7（客服场景需要一定的灵活性但不过于发散）

🔀 第二步：设计意图分类路由

这是工作流的核心——让助手根据用户意图走不同的处理路径。拖入一个"问题分类器"节点，连接到LLM节点之后。配置三个分类标签：

• general_question：一般性问题（问候、闲聊）
• product_query：产品相关问题（需要查知识库）
• realtime_info：需要实时数据（天气、股价等）

分类提示词示例：

根据用户输入判断意图类别：
- general_question: 打招呼、闲聊、非业务咨询
- product_query: 询问产品功能、价格、使用方法、故障排查
- realtime_info: 要求获取实时信息（天气、新闻、股票等）

仅输出类别名称，不要输出其他内容。

📚 第三步：构建知识库检索

在Dify中，知识库是提升回答准确性的关键组件。点击左侧菜单进入"知识库"，创建一个新知识库：

1. 上传你的产品文档、FAQ、技术手册（支持PDF、Word、Markdown、网页URL）
2. 选择分段策略：自动分段与清洗（推荐入门使用）
3. 选择嵌入模型：默认的 text-embedding-3-small 性价比最高
4. 等待索引完成（通常几秒到几分钟，取决于文档量）

回到工作流，拖入"知识检索"节点，连接到 product_query 分支。配置检索参数：

• Top K = 3（返回最相关的3个片段）
• 分数阈值 = 0.65（低于此分数的结果将被过滤）
• 启用"引用与归属"（让用户知道信息来源）

🌐 第四步：集成HTTP请求获取实时数据

对于 realtime_info 分支，拖入一个"HTTP请求"节点。这里以获取天气为例：

方法：GET
URL：https://api.openweathermap.org/data/2.5/weather
参数：q=城市名&appid=YOUR_API_KEY&lang=zh_cn

将此节点的输出连接到后续LLM节点，让模型将API返回的JSON数据转化为自然语言回复。

✅ 第五步：测试与发布

点击右上角"运行"进入预览模式，测试三条路径：

• 输入"你好"→ 应走 general_question 分支，返回友好问候
• 输入"如何退换货？"→ 应走 product_query 分支，检索知识库后给出准确答案
• 输入"北京今天天气怎么样？"→ 应走 realtime_info 分支，调用天气API返回实时数据

测试通过后，点击"发布"。Dify会生成一个API端点和可嵌入的聊天窗口代码。你可以将助手嵌入网站、接入微信/钉钉/飞书等平台，或通过API集成到现有系统中。

💡 进阶技巧

• 条件分支：使用IF/ELSE节点根据置信度分数动态调整后续流程
• 变量管理：通过变量节点存储对话上下文，实现多轮对话记忆
• 模板转换：使用模板节点将结构化数据格式化为特定输出格式（如JSON、Markdown表格）
• 迭代处理：对列表数据逐项调用LLM，适合批量处理场景
• 监控日志：开启日志记录，观察每条工作流的token消耗、延迟和成功率

通过以上步骤，你已经在30分钟内完成了一个具备意图识别、知识检索和实时数据获取能力的智能助手。Dify的强大之处在于它将复杂的AI工程抽象为直观的可视化模块，让非技术人员也能参与到AI应用的构建中。

📝 本教程基于Dify v0.15+版本编写，功能以实际界面为准。建议定期查阅官方文档获取最新更新。