Dify 智能体搭建教程：6 步搭出会问答、能生图、连地图的个人助手

Dify 智能体搭建教程：6 步搭出会问答、能生图、连地图的个人助手

【免费下载链接】hello-agents📚 《从零开始构建智能体》——从零开始的智能体原理与实践教程项目地址: https://gitcode.com/GitHub_Trending/he/hello-agents

本教程以 Dify 为例，演示一个 Dify 智能体的完整搭建过程。跟着 6 个步骤操作，你可以得到一条 Chatflow 工作流，让助手同时具备 5 项能力：日常问答、文案润色、图片与视频生成、高德地图位置与饮食推荐、数据库查询与可视化。全程在 Dify 界面里点选配置，不需要写后端代码。

搭好的 Dify 智能体长什么样：能力清单与路线图

先明确最终产物。这个 Dify 智能体是一个 Chatflow 应用：用户的所有输入先经过同一个问题分类器，再被分发到 5 条处理分支。

搭建路线图共 6 步：

1. 在插件市场装齐 5 个核心插件
2. 创建 Chatflow 空白应用，搭好问题分类器骨架
3. 接通"日常问答"分支
4. 接通"文案润色"分支
5. 接通"图片 / 视频生成"分支
6. 完成高德地图 MCP 配置，接通"位置与饮食推荐"分支

数据查询作为扩展玩法放在最后，随时可以补上。

第 1 步：Dify 插件市场要装哪几个插件

这一步的目的是把后面 5 个场景要用到的"零件"一次备齐，否则搭到对应分支时会发现节点里选不到模型或工具。

操作分 3 下：

1. 点击 Dify 界面右上角的"插件"按钮，进入插件市场
2. 在搜索框里按名字逐个搜索并点击安装
3. 回到插件列表，确认每一项都显示为已安装

本教程需要安装的插件如下，缺一个都会卡住对应场景：

完成后，插件列表左侧会显示已安装条目和版本号，工作流里新建 LLM 或工具节点时就能直接选到它们。

第 2 步：创建 Chatflow 应用与问题分类器

这一步的目的是搭出整个 Dify 智能体的"骨架"：一个统一入口加一个分流器。

具体操作：

1. 顶部导航进入"工作区"，点击"创建空白应用"，类型选 Chatflow
2. 在画布上"开始"节点之后添加"问题分类器"节点
3. 为分类器定义与后续分支一一对应的类别，例如：日常问题、文案优化、图片生成、视频生成、位置与饮食推荐

问题分类器的作用是让模型先读懂用户这句话属于哪类任务，再走对应分支，省去手写一堆 if-else 路由规则。每加一个类别，就要接一条分支，后面 4 个场景就是逐条接分支的过程。

场景一：日常问答——给 LLM 分支写"咨询专家"提示词

这是兜底分支，处理所有没有命中其他类别的普通问题。分支节点依次是：开始 → 问题分类器（日常问题）→ LLM → 直接回复。

LLM 节点的两处配置决定回答质量：

• 工具：加上"获取时间戳"。为什么？很多生活类问题（节假日、季节、天气应对）依赖当前日期，没有时间信息模型只能泛泛而谈。
• 系统提示词：按三层结构组织，比一长段话更好维护——
  • Role：把角色定为"日常问题咨询专家"，覆盖日常生活、健康养生、家庭管理、人际关系等领域
  • Profile：语言用中文，性格设为亲切友好、耐心细致、务实可靠
  • Skills：分问题分析、解答提供、沟通表达三组能力，要求回答具体可行、语言通俗

保存后发送一句"你好"，你会看到助手以咨询专家的身份自我介绍，并列出它能帮忙解答的问题类别。这条分支通了，说明骨架和第一个分支都配置成功。

场景二：文案润色——给分类器加第二条分支

文案优化是最高频的使用场景之一（润色、扩写、缩写）。分支结构和场景一完全一样：开始 → 问题分类器（文案优化）→ LLM → 直接回复，差别只在 LLM 节点的提示词。

这条分支的提示词围绕四点写：

1. 角色：专业文案优化专家，站在目标受众和转化目标的角度写
2. 任务：分析并优化原文的结构、语言、风格，让内容更生动、更有说服力
3. 限制：不改变原文的核心信息，不添加虚构内容
4. 输出格式：直接给出优化后的完整文案，例如要求正文超过 500 字

完成后把一段粗糙的推销文案丢进去，你会收到一段结构清晰、明显扩写润色过的版本。

🎨 场景三：图片与视频生成——接上豆包 T2I / T2V 节点

这一步让助手能直接"画"和"拍"。前置条件是第 1 步装好的豆包插件已配置好 API Key，并开通了相应的生成权限。

图片生成分支：

• 节点依次为：开始 → 问题分类器（图片生成）→ 豆包 T2I → 直接回复
• T2I 节点里选择生图模型并填入 API Key
• 发送"帮我生成图片：玫瑰咖啡"，几秒后返回一张主题匹配的图片

视频生成与图片几乎同理：

• 到火山引擎控制台开通文生视频权限
• 分支节点把豆包 T2I 换成豆包 T2V，其余连线不变
• 提示词里可以指定主题和风格，支持多种创作方向

🗺️ 场景四：位置与饮食推荐——完成高德地图 MCP 配置

先解释 MCP：Model Context Protocol，一套让智能体标准化调用外部服务的接口协议。有了它，Dify 智能体不用自己写接口对接，就能使用高德地图这类现成服务。本场景演示的是云端部署的 MCP 服务，通过 ModelScope（魔搭社区）接入。

配置分 4 步，每步做完都有明确的确认信号：

1. 在 ModelScope 社区注册账号并登录
2. 进入高德地图 MCP 服务的配置页面
3. 到高德开放平台新建应用，生成 API Key
4. 把 Key 粘贴回 MCP 配置页的输入框，页面显示配置成功即完成

之后把 MCP 接进工作流：新增一个 Agent 节点，选择 ReAct 模式，添加"获取时间戳"工具，再以 SSE 模式配置 MCP 服务（把服务地址复制过来时去掉 mcp-server 前缀），最后补上该分支的提示词。

保存试运行后，问"附近有什么适合周末去的地方"或"今晚吃什么"，助手会通过 MCP 拿到实时信息再作答，而不是凭训练记忆硬编。

💾 扩展玩法：自然语言查数据库并可视化

数据查询分支用到的就是第 1 步装好的 rookie-text2data 插件。

配置要点只有两处：

• 数据库连接：填入 MySQL 的地址、库名、账号与密码，插件会先做连通性校验
• 提示词：约定好"先整理数据、再输出可视化结果"的回答格式

完成后，用一句"上个月各渠道的销售量对比"这类大白话提问，助手会转成 SQL 执行查询，并按提示词要求整理成表格或图表形式返回。

Dify 智能体配置时容易踩的 4 个坑

前 4 个场景搭完后，如果回答质量不稳定，按下面 4 点逐一排查：

1. 提示词：每条分支都写清"角色是谁 + 任务是什么 + 什么不能做"，只写角色不写限制，输出格式会飘
2. 工作流：分类器的类别定义要互斥，两条分支的描述重叠会导致分发乱跳；一个分支只干一件事
3. 错误处理：给调用外部服务的节点设置超时和重试，地图、生图这类节点偶发失败时不至于整条流程中断
4. 性能：高频的日常问答分支用响应快的模型，把耗时的生图、生视频节点放在分类之后按需触发，避免每次对话都排队等生成

完成后的能力清单与下一步

对照检查，你的 Dify 智能体应能完成：

• 日常生活问答（带时间感知）
• 文案润色、扩写
• 文生图、文生视频
• 高德地图位置查询与饮食推荐
• 自然语言查询数据库并可视化

下一步可以玩的方向：

• 给分类器新增分支，接入更多 MCP 服务（如新闻资讯）
• 尝试插件市场里的可视化图表类插件，增强数据分支的图表样式
• 对照仓库中的完整图文版章节核对每个节点参数：Extra-Chapter 对应章节

【免费下载链接】hello-agents📚 《从零开始构建智能体》——从零开始的智能体原理与实践教程项目地址: https://gitcode.com/GitHub_Trending/he/hello-agents