企业官网建设流程全解析

如何用 Dify 从零搭建智能体：30 分钟跑通个人助手的零基础完整教程

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

这个周末你想去郊游：规划自驾路线、润色朋友圈文案、生成一张封面图，甚至查一下这个月的预算数据——你希望这些事都由一个 AI 助手包办。本文跟着 hello-agents 开源教程里的 Dify 智能体实战章节带你做：不写一行代码，30 分钟搭出一个能直接对话的个人助手，做完手里会有一个跑通的"出游助手"。

🧰 开工前，一次性备齐

下面清单里是需要提前弄好的所有东西，按顺序核对一遍即可。

1. 注册并登录 Dify 账号，它就是你搭建智能体的平台
2. 在 Dify 插件市场安装 5 个插件：Gemini、OpenAI、豆包生图、豆包生成视频、rookie-text2data
3. 注册一个魔搭（ModelScope）社区账号，用来接入 MCP 工具服务
4. 在高德开放平台新建一个应用，记下它生成的 api_key
5. 准备一个可调用的模型密钥（Gemini 或 OpenAI 任选其一）
6. 可选：准备一个 MySQL 数据库，用于体验数据查询功能

完整教程配图和提示词在仓库 Extra-Chapter 目录，想存到本地可以 clone：

git clone https://gitcode.com/GitHub_Trending/he/hello-agents

🧭 主线实操：用"周末出游"任务串起核心功能

我们要搭的是一个 Chatflow 应用：用户输入任何请求，由"问题分类器"分发给对应分支——问答、文案润色、生图、路线规划、数据查询。

第 1 步 创建空白应用。点击右上角"创建空白应用"，选择"Chatflow"，命名为"周末出游助手"，进入拖拽画布。

第 2 步 加问题分类器。从左侧组件面板拖出分类器节点，建 5 个分支：日常问答、文案优化、图片生成、路线规划、数据查询，每个分支写一句说明和一句示例问法。

第 3 步 接通问答分支。按"开始 → 问题分类器 → LLM → 直接回复"的顺序连线，在 LLM 节点填入系统提示词（写法见下一节），点右上角"运行预览"，输入"郊游要带什么"，能正常作答即通过。

第 4 步 加文案润色分支。结构与第 3 步相同，只换一份提示词。输入一段朋友圈草稿，它会返回一段 500 字以上、有结构和节奏感的润色版本。

第 5 步 加图片生成分支。在分类器后接一个豆包文生图节点，提示词填"水彩风格，朋友们郊游"，节点会直接返回图片；文生视频节点同理添加。

第 6 步 加路线规划分支（高德 MCP）。添加 Agent 节点，选择 ReAct 模式，在工具配置里添加高德 MCP 服务：选 SSE 模式，删掉地址里的 mcp-server 前缀后整体粘贴，再填入备齐阶段的 api_key。输入"自驾去郊外度假村怎么走"，即可得到驾车路线。

第 7 步 加数据查询分支。rookie-text2data 插件已装好，填入数据库地址、账号、密码，并在提示词里附上数据表的 DDL。输入"这个月郊游预算花了多少"，它会查询数据库并总结作答。

📝 关键配置拆解：系统提示词怎么写

提示词最决定智能体效果。以问答分支为例，下面这版可以直接抄：

# 角色：日常问题咨询专家 - 语言：中文；性格：亲切、耐心、务实 - 任务：先弄清用户问题的核心，再给出能直接照做的建议 - 表达：用大白话，分步骤，把关键点加粗 - 边界：不编造事实，不给医疗或法律建议

为什么这么写：先钉死角色和语气，模型多轮回答的风格才不会飘；"做什么、怎么说、不做什么"都写成具体动作，避免"专业、严谨"这类形容词。分类器的分支说明同理——分支描述越有区分度，分错路线的次数就越少。

⚠️ 踩过的坑

• "帮我润色文案"被分到问答分支→ 分支描述互相重叠 → 重写描述去掉重复词，每个分支补一句示例问法。
• 高德 MCP 连不上、工具列表为空→ api_key 没填或 SSE 地址带了前缀 → 重新填密钥，粘贴前删掉 mcp-server 前缀。
• 豆包生图节点直接报错→ 火山引擎侧没开文生图权限 → 到控制台开通对应权限，保存后重试。
• 数据查询返回空结果或乱 SQL→ 模型不知道表结构 → 把表的 DDL 语句或字段清单附在提示词里，让它先"看懂"字段再生成 SQL。
• 直接回复节点输出空白→ 没接上 LLM 节点的输出变量 → 打开直接回复节点，重新选择上游的输出变量。

搭完这个出游助手，你手里已经有了：

✅ 能接日常问答的私人助手 ✅ 能润色朋友圈和公众号文案 ✅ 能文生图、文生视频 ✅ 能用高德 MCP 规划路线 ✅ 能查数据库并总结结果

下一步可以换成自己的数据表，或再加一条"每日新闻简报"分支，把它养成真正贴合你工作的助手。

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