Dify 核心概念与基础使用适用版本Dify Community Editionv1.16.0面向读者零基础已装好 Dify、认识界面阅读时长约 25 分钟前置02-安装与部署.md、03-界面介绍.md目标学完你能接入国内模型并做出第一个能对话的 Chatbot。1. 先理清几个核心概念概念大白话在 Dify 哪设置模型Model真正「动脑子」的大语言模型设置 → 模型供应商提示词Prompt你给 AI 的指令 / 人设Studio → 提示词变量Variable对话里可动态填入的占位符提示词里用{{变量名}}记忆MemoryAI 记住你们前面的对话默认开启可设轮数上下文 / 知识库让 AI 参考你自己的资料Studio → 上下文工具Tool给 AI 加外部能力搜索/代码Studio → 工具Agent能自己调用工具完成任务的 AI创建应用选「智能体」 本篇聚焦「聊天助手Chatbot」这一最简单也最常用的形态把上面的概念串起来。2. 接入模型国内可访问三选一⚠️关键点Dify 不自带模型必须先在这里添加至少一个模型否则对话会报错。三步通用流程设置 → 模型供应商 → 安装插件 → 填 API Key → 选默认模型。2.1 通义千问Qwen阿里云百炼⭐ 推荐新手打开 https://dashscope.console.aliyun.com 用阿里云账号登录。左上角「API Key 管理」→ 创建 Key复制保存形如sk-xxxx。在百炼控制台「模型广场」确认已开通你要的模型如qwen-plus、qwen-max、qwen2.5-7b-instruct等。回到 Dify设置 → 模型供应商 → 搜索「通义千问」→ 安装插件。点「设置」把 API Key 粘贴进去保存。在「模型列表」里会看到qwen-plus等设为默认或备用。 经济实惠组合日常测试用qwen-plus便宜够用要求高时用qwen-max。2.2 DeepSeek方式一官方打开 https://platform.deepseek.com → API Keys → 创建 Key。Dify模型供应商 → 搜索「DeepSeek」→ 安装 → 填 Key。模型选deepseek-chat对话或deepseek-reasoner推理。方式二硅基流动 SiliconFlow国内访问更稳还能用很多开源模型打开 https://siliconflow.cn → 注册 → API 密钥。Dify 里 DeepSeek 也兼容 OpenAI 协议也可直接装 SiliconFlow 插件填 Key模型选deepseek-ai/DeepSeek-V3等。 想体验「会思考」的模型用deepseek-reasoner日常对话用deepseek-chat更省。2.3 Ollama本地模型隐私最好免 API Key适合不想花钱、且电脑配置够建议 16G 内存以上的同学。本机安装 Ollama# macOS / Linux官网 https://ollama.com 下载安装或curl-fsSLhttps://ollama.com/install.sh|sh# 拉取一个中文友好的模型ollama pull qwen2.5:7b# 启动服务默认端口 11434ollama serve在 Dify 里接入 OllamaDify模型供应商 → 搜索「Ollama」→ 安装插件。填Base URL如果你 Dify 是Docker 部署且 Ollama 在宿主机填http://host.docker.internal:11434Windows/Mac。如果 Dify 和 Ollama 都在同一台 Linux 裸机填http://localhost:11434。Linux Docker 容器内访问宿主机 Ollama填宿主机内网 IP如http://192.168.1.10:11434。点「管理模型」填入qwen2.5:7b保存。⚠️ 连不上的最常见原因Docker 网络隔离。记住口诀——Docker 里访问宿主机用host.docker.internalLinux 用真实 IP。2.4 验证模型是否接好在设置 → 模型供应商看到模型状态为「已启用 / 可用」且创建应用时能选到它就说明成功了。3. 动手做第一个 Chatbot5 步目标做一个「公司制度问答小助手」先不接知识库纯靠提示词。第 1 步创建应用「 创建应用」→ 选聊天助手→ 名称「制度问答小助手」→ 创建。第 2 步写提示词人设在 Studio 左侧「提示词」框输入你是一个严谨、友好的公司制度问答助手。 - 只回答与公司制度、人事、考勤相关的问题。 - 如果问题超出制度范围礼貌说明无法回答。 - 回答要简洁使用中文。第 3 步选模型「模型」下拉选你刚接入的qwen-plus或deepseek-chat。第 4 步设开场白可选但推荐你好我是制度问答小助手关于考勤、请假、报销的问题都可以问我 再填两个「问题建议」请假怎么申请加班有补贴吗第 5 步预览测试在右侧预览框输入年假怎么算看 AI 是否正常回答。✅ 能正常对话说明你的第一个 Chatbot 已经跑通发布后就能分享给别人。4. 提示词怎么写才有效新手技巧技巧说明示例给角色明确「你是谁」「你是一名资深 Java 面试官」定边界说清「能/不能答什么」「只回答 Python 相关问题」给格式规定输出样式「用 Markdown 列表回答」给示例放 1–2 个样例Few-shot先给一问一答示范防跑偏限制行为「不要编造政策条文」 提示词不用一次写完美边预览边改像「调音量」一样微调。5. 变量让同一段提示词适配不同场景在提示词里用{{ }}包住变量对话开始时用户填值请帮我用{{语气}}的语气写一段关于{{主题}}的朋友圈文案。用户开始对话时会先被要求填「语气」「主题」两个空再生成内容。适合做模板化生成类应用。6. 记忆让 AI 记住上下文Dify 默认开启对话记忆AI 会参考最近的几轮对话。在应用设置里可调整「记忆窗口」保留多少轮轮数越多越「记仇」但也越费 Token。需要「每次都重新开始」的场景如一次性生成任务可关掉记忆。7. 工具给 AI 加「手脚」聊天助手里点「工具」可添加工具作用联网搜索让 AI 查最新信息不再只靠训练数据代码执行让 AI 跑一小段 Python 算数 / 处理数据HTTP 请求调用你自己的接口如查订单计算器 / 天气 等市场里的现成工具配置具体工具的方法和案例见 07-使用案例集.md 第 4 个案例带工具的 Agent。8. Agent智能体快速预览「创建应用」选智能体你会多一个「工具 / 能力」配置区给 Agent 配好工具后它接到任务会自己决定先搜还是先算。相比 Chatbot 的「一问一答」Agent 更适合多步骤、目标导向的任务如「帮我把这个网站的内容总结成一份报告并保存到笔记」。想深入玩 Agent配合 05-工作流编排.md 的「Agent 节点」一起看。9. 名词速查本篇词意思API Key调用模型服务的「密码」别外泄Embedding把文字变成向量的模型知识库用LLM大语言模型Qwen / DeepSeek 等提示词工程把指令写清楚让 AI 更好用的技巧10. 动手练习按第 2 节接入至少一个国内模型通义千问 / DeepSeek / Ollama 三选一。按第 3 节做出「制度问答小助手」并预览对话成功。挑战给提示词加一个{{岗位}}变量让回答按不同岗位定制。完成后进入 05-工作流编排.md学习用「拖拽节点」做更复杂的应用。下一步05-工作流编排.md —— 把多个步骤像搭积木一样连起来。