Dify AI应用开发平台

Dify是开源的LLM应用开发平台，支持快速构建AI应用、工作流和Agent。

核心概念

应用类型

• - Chat App - 对话型应用，支持会话持久化，适合聊天机器人、客服AI
• Workflow App - 工作流应用，无状态执行，适合翻译、写作、摘要
• Agent - 智能体应用，支持工具调用和自主规划
• Completion App - 文本补全应用，单次请求响应

核心组件

• - Studio - 应用构建工作台
• Knowledge Base - 知识库，支持RAG检索增强
• Model Providers - 模型提供商配置
• Tools - 工具集成

工作流节点

输入输出

• - User Input - 用户输入，定义输入变量
• Output - 输出结果

逻辑控制

• - IF/ELSE - 条件分支
• Iteration - 迭代循环
• Parallel - 并行执行

数据处理

• - Parameter Extractor - 参数提取，用LLM从自然语言提取结构化数据
• List Operator - 列表操作，过滤和转换数组
• Variable Aggregator - 变量聚合
• Template - 模板渲染

LLM节点

• - LLM - 大语言模型调用
• Question Classifier - 问题分类
• Knowledge Retrieval - 知识检索

工具节点

• - HTTP Request - HTTP请求
• Code - 代码执行(Python/JavaScript)
• Tool - 工具调用

快速开始

部署Dify (Docker)

bash

克隆最新版本

git clone --branch $(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name) https://github.com/langgenius/dify.git

启动

cd dify/docker cp .env.example .env docker compose up -d

访问 http://localhost/install 初始化管理员账户。

系统要求

• - CPU >= 2 Core
• RAM >= 4 GiB
• Docker 19.03+
• Docker Compose 1.28+

API调用

认证

所有API请求需要在Header中携带API Key:

Authorization: Bearer {api_key}

执行工作流

bash POST /v1/workflows/run Content-Type: application/json

{
inputs: {
query: 翻译这段文字...
},
response_mode: blocking, # 或 streaming
user: user-123
}

发送聊天消息

bash POST /v1/chat-messages Content-Type: application/json

{
query: 你好,
response_mode: streaming,
user: user-123,
conversationid: # 首次为空，后续传入返回的conversationid
}

响应模式

• - blocking - 同步等待完整响应
• streaming - SSE流式响应

知识库

创建知识库

1. 1. Studio → Knowledge → Create Knowledge
2. 上传文档 (支持txt, markdown, pdf, docx, html等)
3. 选择索引模式:

- High Quality - 高质量索引，需要Embedding模型 - Economy - 经济模式，关键词检索

检索设置

• - Vector Search - 向量检索
• Full Text Search - 全文检索
• Hybrid Search - 混合检索

在应用中使用

工作流中添加 Knowledge Retrieval 节点，选择知识库。

详细参考

• - API文档 - 完整API接口说明
• 工作流节点 - 所有节点详细配置
• 知识库配置 - 知识库高级设置
• 模型配置 - 支持的模型提供商

资源链接

• - 官方文档: https://docs.dify.ai
• GitHub: https://github.com/langgenius/dify
• 社区: https://github.com/langgenius/dify/discussions