Dify 快速上手教程

是什么

Dify 是一个开源的 LLM 应用开发平台，GitHub 地址：langgenius/dify。它帮助开发者快速构建、部署和管理基于大语言模型（如 GPT、Claude 等）的 AI 应用。Dify 提供了可视化的编排界面、内置的 RAG 引擎、Agent 能力以及模型监控等功能，让 AI 应用开发像搭积木一样简单。

能干什么

• 可视化 Prompt 编排：通过拖拽式界面设计对话流程，无需写代码即可构建复杂的 AI 工作流。
• 内置 RAG 引擎：支持上传文档（PDF、TXT、Markdown 等），自动进行向量化存储和检索，让 AI 回答基于你的私有知识库。
• Agent 能力：支持调用外部工具（如搜索引擎、计算器、API 等），让 AI 能自主执行任务。
• 模型管理：统一管理多个 LLM 提供商（OpenAI、Anthropic、Azure 等），一键切换模型。
• 日志与监控：记录每次对话的输入输出、Token 消耗、延迟等，方便调试和优化。
• API 发布：将构建好的应用通过 RESTful API 暴露给外部系统集成。

怎么装

Dify 支持 Docker 一键部署，推荐使用 Docker Compose 方式。

前提条件

• 安装 Docker 和 Docker Compose（v2.x 以上）
• 至少 2GB 可用内存

安装步骤

1. 克隆仓库：

git clone https://github.com/langgenius/dify.git
cd dify/docker

2. 复制环境变量文件：

cp .env.example .env

3. 启动服务：

docker compose up -d

4. 等待启动完成（约 1-2 分钟），访问 http://localhost:3000 即可看到 Dify 界面。

5. 首次访问需要注册管理员账号，按提示填写即可。

怎么用第一个例子

下面演示创建一个简单的「知识库问答机器人」：

步骤 1：创建知识库

1. 登录 Dify 后，点击左侧「知识库」→「创建知识库」。
2. 上传一个文本文件（例如公司产品手册 PDF）。
3. 选择嵌入模型（默认使用 text-embedding-ada-002，需要配置 OpenAI API Key）。
4. 点击「开始处理」，等待向量化完成。

步骤 2：创建应用

1. 点击左侧「工作室」→「创建应用」→ 选择「对话型应用」。
2. 在 Prompt 编辑器中输入系统提示词，例如：

你是一个客服助手，请基于知识库回答用户问题。如果知识库中没有相关信息，请如实告知。

3. 在右侧「上下文」中勾选刚才创建的知识库。
4. 点击「发布」，应用就上线了。

步骤 3：测试

在预览窗口输入问题，例如「产品保修期多久？」，Dify 会从知识库中检索相关内容并生成回答。

社区资源

• 官方文档：https://docs.dify.ai（含中文版）
• Discord 社区：https://discord.gg/FngNHpbcY7
• Reddit：r/difyai
• GitHub 讨论区：https://github.com/langgenius/dify/discussions
• Docker 镜像：hub.docker.com/u/langgenius

注意：使用 OpenAI 等海外模型服务时，国内访问可能受限，推荐使用国产大模型（如通义千问、文心一言等）作为替代方案。

翻译整理自 GitHub README，原文：https://github.com/langgenius/dify