Dify 开源平台搭建 AI 聊天助手及 API 集成教程
1. 引言
在当前的软件开发环境中，将大语言模型（LLM）集成到实际项目中往往面临诸多挑战。开发者通常需要处理复杂的 API 对接、上下文管理、额度监控以及多模型扩展等问题。Dify 作为一款开源的大语言模型应用程序开发平台，旨在解决上述痛点。
Dify 提供了直观的图形界面，结合了 AI 工作流编排、检索增强生成（RAG）、智能代理（Agent）功能、统一的模型管理以及可观察性工具。它允许开发者从简单的对话机器人快速扩展到复杂的企业级应用，无需从零编写底层代码。
2. 环境准备与部署
2.1 系统要求
官方建议在 Linux 环境下使用 Docker Compose 进行部署。最低硬件配置建议为 2 核 CPU 和 4GB 内存。确保服务器已安装 Docker 和 Docker Compose。
检查版本：
docker --version
docker-compose --version
2.2 拉取代码
选择一个合适的目录，使用 Git 克隆 Dify 的官方仓库：
git clone https://github.com/langgenius/dify.git
cd dify
2.3 配置文件初始化
进入项目目录后，需要复制环境变量示例文件并修改配置：
cp .env.example .env
打开 .env 文件，可以根据实际需求调整以下关键参数：
SERVICE_API_KEY: 设置服务访问密钥。APP_MAX_ACTIVE_REQUESTS: 限制最大并发请求数。LOG_LEVEL: 日志级别，生产环境建议设为INFO或WARNING。
2.4 启动服务
使用 Docker Compose 启动所有依赖服务（包括后端、前端、数据库、Redis 等）：
docker compose up -d
启动完成后，可以通过以下命令查看服务状态：
docker compose ps
等待所有容器状态变为 Up，通常耗时几分钟。首次访问时，系统会自动初始化数据库结构。
2.5 访问后台
在浏览器中访问 http://your-ip/install。首次进入需要创建管理员账户。设置好用户名和密码后，即可登录 Dify 控制台。
3. 配置大模型供应商
为了让 Dify 能够调用大模型能力，首先需要配置模型供应商。
3.1 选择模型
在控制台的「设置」->「模型供应商」中，添加支持的模型。Dify 支持多种主流模型，包括但不限于：
- Moonshot (Kimi): 提供长文本处理能力，有免费额度。
- OpenAI: GPT-3.5/4 系列。
- Anthropic: Claude 系列。
- 国内厂商: 如百度文心一言、阿里通义千问等（需自行配置 API）。
3.2 配置 API Key
以 Moonshot 为例：
