illegalCreed

中文

English

中文

English

Appearance

参考 ​

基于 Dify 官方文档（docs.dify.ai）+ GitHub Release Notes 编写，对照 v1.16.0 稳定版（2026-07-17 发布）

速查 ​

  • 应用类型：Workflow（一次性 / Trigger / Output）/ Chatflow（每轮 / Answer / Memory）/ Agent（v1.16.0 Beta，沙箱）/ legacy Chatbot · Text Generator
  • Start 节点：User Input（可发布 webapp / MCP / API / Tool）vs Trigger（Schedule / Webhook / Integration）
  • RAG 索引：High Quality（向量化）vs Economical（倒排）——创建后不可互换
  • RAG 检索：Vector / Full-Text / Hybrid / Inverted；Top K 默认 3、Score Threshold 默认 0.5（仅 Rerank 生效）
  • Hybrid：Weight Settings 与 Rerank 二选一
  • LLM 节点：Temperature 0-1、Prompt 支持 + Jinja2、Context 关联 RAG、Structured Output、Memory 仅 Chatflow
  • 变量 4 种：Inputs / Outputs / Environment Variables（存密钥、与 DSL 解耦）/ Conversation Variables（仅 Chatflow）
  • DSL：所有应用导出 YAML，跨实例迁移 / 版本控制
  • REST API：云端 https://api.dify.ai/v1、Bearer Token；App Key 单应用、Knowledge Base Key 全知识库；用 user 标识终端用户
  • 模型 5 类：System Reasoning / Embedding / Rerank / Speech-to-Text / Text-to-Speech；AI Credits + 自带 Key 双轨
  • Agent 策略：Function Calling（须模型原生 FC）vs ReAct（提示工程）
  • 部署：Docker Compose（≥2C / ≥4G、Compose 2.24.0+）
  • 当前稳定版：v1.16.0（2026-07-17）

应用类型与差异 ​

类型触发结束节点Memory对话变量
Workflow一次性 / TriggerOutput无无
Chatflow每轮对话Answer（必需）节点级有
Agent（Beta v1.16.0）Workflow Agent 节点 / 独立 chattext/files/json无（每条消息从零）Capability 配
Chatbot（legacy）chat 模式—有—
Text Generator（legacy）completion 模式—无—

节点速查表 ​

节点作用关键配置
Start入口User Input / Trigger
LLM调模型Temperature / Prompt / Context / Structured Output
Knowledge RetrievalRAG 检索关联知识库 + 查询变量
Agent工具编排FC / ReAct + Maximum Iterations
Code沙箱执行Python / JS
Template模板渲染Jinja2
IF/ELSE条件路由—
Iteration数组遍历Parallel Mode（并行度 ≤10）
Loop循环—
Parameter Extractor抽结构化参数—
Question Classifier问题分类—
Variable Aggregator变量合并—
Variable Assigner变量赋值—
HTTP Request外部 API环境变量凭据
Tool调工具内置 / 自定义
Doc Extractor文档解析—
List Operator列表操作—
Answer对话回复（Chatflow 必需）—
Output输出结果（Workflow 必需）—
Human InputHITL（v1.13.0+）暂停 / 恢复 / 审批
Trigger自动触发Schedule / Webhook / Integration

RAG 检索参数默认值 ​

参数默认说明
Top K3召回片段数
Score Threshold0.5仅 Rerank 阶段生效
Rerank Model禁用启用后阈值才生效
Hybrid Weight Settings—与 Rerank 二选一
Semantic 权重—1 = 退化为纯向量
Keyword 权重—1 = 退化为纯关键词

索引与检索组合 ​

索引支持检索模式
High QualityVector / Full-Text / Hybrid
EconomicalInverted Index

High Quality ↔ Economical 创建后不可互换。

变量系统 ​

类型范围DSL 解耦用途
InputsStart 节点否用户输入
Outputs节点产出否节点间传递
Environment Variables应用级常量是密钥 / API Key
Conversation Variables仅 Chatflow否跨轮持久化

系统变量：

变量WorkflowChatflow
sys.user_id✓✓
sys.app_id✓✓
sys.workflow_id✓✓
sys.workflow_run_id✓✓
sys.timestamp✓✓
sys.conversation_id—✓
sys.dialogue_count—✓

LLM 节点配置 ​

配置取值 / 说明
Temperature0-1（0 最确定）
Top P核采样
Frequency Penalty / Presence Penalty抑制重复
PresetsPrecise / Balanced / Creative
Prompt + Jinja2
Context关联 Knowledge Retrieval（RAG）
VISIONHigh / Low detail
Structured Output可视化 / JSON Schema / AI 生成
Memory仅 Chatflow，节点级
reasoning tag<think> → reasoning_content

Agent 节点输出字段 ​

字段含义
Final Answer最终答案
Tool Outputs各工具输出
Reasoning Trace推理链（ReAct 尤为明显）
Iteration Count迭代次数
Success Status成功 / 失败状态
Agent Logs完整日志

REST API 端点 ​

端点方法用途
/infoGET应用元信息
/chat-messagesPOSTChatflow 对话
/workflows/runPOSTWorkflow 执行
/completion-messagesPOSTText Generator 补全
/agents/chatPOSTAgent 对话（新版 Beta）
/messages/{message_id}/feedbacksPOST消息反馈
/messages/{message_id}/suggestedGET推荐问题
/conversationsGET会话列表
/conversations/{conversation_id}DELETE删除会话
/conversations/{conversation_id}/namePOST重命名会话
/audio-to-textPOST语音转文字
/text-to-audioPOST文字转语音
/metadataGET元数据
/workflow-runsGETWorkflow 执行历史
/workflow-runs/{run_id}GET单次执行详情
knowledgebases—知识库管理（Knowledge Base Key）
knowledge/documents—文档管理
knowledge/chunks—分片管理
knowledge/metadata—元数据

认证与 Key 范围 ​

Key范围
App Key单应用
Knowledge Base Key账户下所有知识库
  • 认证：Authorization: Bearer {api_key}
  • 用 user 字段标识终端用户
  • Key 仅后端使用，不要嵌入前端

模型类型 ​

类型用途
System Reasoning Model（LLM）主推理
Embedding Model向量化
Rerank Model重排序
Speech-to-Text语音转文字
Text-to-Speech文字转语音

接入：Integrations > Model Provider 或 Marketplace；AI Credits + 自带 Key 双轨；Professional / Team 多 Key 负载均衡。

发布渠道 ​

渠道说明
Web Appchatflow-webapp / workflow-webapp
REST APIBearer Token
MCP Serverv1.16.0 升级到 MCP 2025-06-18
Marketplace应用市场
difyctl CLIv1.15.0 推出

部署要求 ​

项要求
CPU≥ 2 核
内存≥ 4 GiB
Docker Compose≥ 2.24.0
服务7 核心 + 7 依赖

版本演进里程碑 ​

版本发布关键特性
v1.13.0—Human Input 节点（HITL）
v1.14.x2026-05安全加固（租户隔离 / SECRET_KEY / LiteLLM CVE / 工具凭证）
v1.15.02026-06-25difyctl CLI / Chain-of-Thought 可视化 / HITL 表单增强 / 慢模型轮询
v1.16.02026-07-17Dify Agent Beta（Linux 沙箱、Capability/Task 分离）/ MCP 协议升级 2025-06-18 / 安全修复（SQL 注入 / SSRF / 开放重定向）

反模式速查 ​

  • Economical 索引上线后想要语义检索精度（不可互换）
  • Hybrid Search 同时配 Weight Settings 与 Rerank（二选一）
  • Hybrid 把 Semantic 或 Keyword 设为 1（退化为单路）
  • 盲目缩小 chunk 求基准测试高分（生产上下文拼不上）
  • Chatflow 中期待新版 Agent Beta 自动保留记忆（每条消息从零）
  • Function Calling 配在不支持原生 FC 的模型上（必须切 ReAct）
  • Agent 不设 Maximum Iterations（死循环）
  • API Key 嵌入前端（Knowledge Base Key 泄露后果严重）
  • 自托管升级直接覆盖 .env（必须对比 .env.example）
  • 把「文档摘要未提及某特性」当「已废弃」

官方资源 ​