Dify 完整入门教程(2026)
本分步教程将带您从零开始构建一个可用的 AI 聊天机器人。无需任何预备知识。完成后,您将拥有一个由您偏好的 LLM 驱动的已发布聊天机器人 — 可随时分享。
什么是 Dify?
Dify 是一个用于构建 LLM 驱动应用程序的开源平台。它提供可视化界面,无需编写代码即可创建聊天机器人、AI 智能体和 RAG 应用。可以将其视为 AI 应用开发的完整工具包:模型管理、知识库、工作流编排和应用发布,全在一处。
Dify 支持所有主流 AI 提供商(OpenAI、Anthropic、Google Gemini、Mistral)以及通过 Ollama 使用本地模型。您可以完全控制提示词、数据和托管位置。
前提条件
开始前请确保您具备以下条件:
您需要准备
Dify 账号或服务器
Dify Cloud(免费)或安装了 Docker 的 VPS
LLM API 密钥
OpenAI、Anthropic 或 Google Gemini — 任选一个即可
网页浏览器
Chrome、Firefox、Safari — 任何现代浏览器均可
基础终端知识
仅在使用自托管时需要。Dify Cloud 不需要。
运行 Dify
您有两种选择,请根据自身情况选择:
方案 A:Dify Cloud
- 前往 cloud.dify.ai
- 点击"Get Started",创建免费账号
- 立即开始 — 无需任何设置
免费套餐:每月 200 条消息积分,适合测试。
方案 B:在 Hetzner 自托管
- 购买 Hetzner CX22 服务器(约 €3.79/月)
- 通过 SSH 登录并运行:
git clone https://github.com/langgenius/dify.git && cd dify/docker && docker compose up -d - 开放 80 端口 — Dify 即刻上线
连接您的 LLM
在构建任何内容之前,需要先将 Dify 连接到 LLM。操作不超过 2 分钟:
点击头像(右上角)→ 设置
在左侧边栏选择"模型供应商"
点击 OpenAI(或您偏好的供应商)
粘贴 API 密钥并点击保存
在 platform.openai.com/api-keys 获取 OpenAI 密钥
点击"测试"验证连接是否正常
创建您的第一个聊天机器人
让我们构建一个简单的客服聊天机器人,大约需要 5 分钟:
打开 Studio
点击顶部导航栏中的"Studio"。
创建应用
点击右上角的"+ 创建应用"按钮。
选择聊天机器人
从应用类型选项中选择"聊天助手",点击下一步。
命名应用
输入名称,如"客服机器人",点击创建。
选择模型
在模型选择器(画布右上角)中选择 GPT-4o 或您偏好的模型。
编写系统提示词
在"指令"文本框中输入:"您是一个乐于助人的客服助手。请简洁、友善、准确。如果不知道答案,请如实说明。"
点击发布
按右上角蓝色的"发布"按钮。您的聊天机器人现在已上线。
测试与分享
现在确认它能正常工作,并与他人分享:
预览面板
Studio 右侧有聊天预览。输入消息并按回车键测试机器人。系统提示词的修改会立即反映在预览模式中。
分享链接
发布后,进入概览 → 点击"运行"打开公共聊天页面。复制 URL 并分享给任何人 — 他们无需登录 Dify 即可与您的机器人对话。
嵌入网站
进入概览 → 嵌入 → 复制 iframe 或 script 标签。粘贴到任何网站即可添加聊天小部件。颜色和位置完全可自定义。
API 访问
每个 Dify 应用都自动获得 REST API。进入 API 参考获取 API 密钥,可从任何应用调用,包括 n8n、Zapier 或自定义代码。
创建知识库(RAG)
RAG(检索增强生成)让您的聊天机器人能够基于您的文档回答问题。这是 Dify 的杀手级功能之一:
点击顶部导航中的"知识库"
点击"+ 创建知识库"
上传您的文档(PDF、Word、TXT、Markdown、网页)
选择分块设置(默认设置适用于大多数情况)
点击"保存并处理"— Dify 会自动分割并向量化您的文档
返回 Studio 中的聊天机器人 → 上下文区域 → 点击"+ 添加"→ 选择您的知识库
重新发布。您的机器人现在可以基于文档回答问题了。
创建工作流
Dify 工作流支持使用基于节点的可视化编辑器构建多步骤 AI 管道。这比简单的聊天机器人更强大 — 您可以串联 LLM 调用、发送 HTTP 请求、执行代码,并根据条件进行分支。
开始
入口点。定义输入变量(如 user_query)。
LLM 节点
用提示词调用 AI 模型。可使用前置节点的变量。
HTTP 请求
向任意外部服务发起 API 调用,用于获取数据。
代码节点
执行 Python 或 JavaScript,在步骤间转换数据。
IF/ELSE
根据条件对工作流进行分支,路由到不同路径。
结束
输出节点。定义返回给用户的内容。
在您自己的服务器上托管 Dify
Dify Cloud 非常适合学习,但真正的优势在于自托管:无限积分、完全数据隐私,无月度 SaaS 费用。在 Hetzner 上仅需 €3.79/月起步。