在 Dify 工作流(Workflow 和 Chatflow)的实现中,“变量”做为最基础、最核心的组件发挥着不可或缺的作用,因为它承载了不同节点间数据传递的作用

也就是说,我们在实现 Workflow 和 Chatflow 时,需要一种动态数据容器,能够存储和传递不固定的内容,在不同的节点内被相互引用,实现信息在节点间的灵活通信,这个就是“变量”了

变量作用:用于不同节点的信息传递。

例如以下场景,我们需要将第一个节点用户输入的内容,传递给第二个节点大模型,就需要使用变量进行传递。

1.变量分类

Dify 中总共有以下 4 种变量类型:

  1. 用户(输入)变量
  2. 系统变量
  3. 环境变量
  4. 会话变量

分别来看这四种变量类型的详细介绍。

2.用户变量

用户变量是用户在与 Dify 应用交互过程中直接输入的信息,这些信息可以是文本、段落(多行文本)、下拉选项、数字、单文件、文件列表(多文件)等,如下图所示:

例如,在对话框中,用户输入“我想查询明天的天气”,这个输入内容就会作为用户变量,应用可以根据这个变量调用天气查询接口等。

注意:变量名称只能为英文、数字和下划线

3.系统变量

系统变量是由 Dify 预设的系统级参数,可以被其它节点全局读取,用于记录和管理应用运行过程中的关键信息,以 sys. 前缀开头。

其中 WorkFlow 和 ChatFlow 的系统变量还有所不同。

Workflow

Workflow 类型应用提供以下系统变量:

Chatflow

Chatflow 类型应用提供以下系统变量:

4.环境变量

环境变量用于保护工作流内所涉及的敏感信息,例如运行工作流时所涉及的 API 密钥、数据库密码等。它们被存储在工作流程中,而不是代码中,以便在不同环境中共享。

环境变量支持以下三种数据类型:

  • String 字符串
  • Number 数字
  • Secret 密钥

其中,Secret 密钥用于定义敏感信息或数据,导出 DSL 时设置了防泄露机制。

环境变量拥有以下特性:

  • 环境变量可在大部分节点内全局引用;
  • 环境变量命名不可重复;
  • 环境变量为只读变量,不可写入。

5.会话变量

会话变量只存在 ChatFlow 场景中,因为它是面向多轮对话场景,而 Workflow 类型应用的交互是线性而独立的,不存在多次对话交互的情况,因此会话变量仅适用于 Chatflow 类型(聊天助手 → 工作流编排)应用。

会话变量允许应用开发者在同一个 Chatflow 会话内,指定需要被临时存储的特定信息,并确保在当前工作流内的多轮对话内都能够引用该信息,如上下文、上传至对话框的文件(即将上线)、 用户在对话过程中所输入的偏好信息等。好比为 LLM 提供一个可以被随时查看的”备忘录”,避免因 LLM 记忆出错而导致的信息偏差。

例如,你可以将用户在首轮对话时输入的语言偏好存储至会话变量中,LLM 在回答时将参考会话变量中的信息,并在后续的对话中使用指定的语言回复用户。

会话变量支持以下六种数据类型:

  • String 字符串
  • Number 数值
  • Object 对象
  • Array[string] 字符串数组
  • Array[number] 数值数组
  • Array[object] 对象数组

会话变量具有以下特性:

  • 会话变量可在大部分节点内全局引用;
  • 会话变量的写入需要使用变量赋值open in new window节点;
  • 会话变量为可读写变量

使用“变量赋值”组件修改会话变量的值:

小结

在 Dify 工作流(Workflow 和 Chatflow)的实现中,“变量”做为最基础、最核心的组件发挥着不可或缺的作用,因为它承载了不同节点间数据传递的作用。变量总共分为 4 种类型:用户变量、系统变量、环境变量和会话变量,我们需要根据不同的业务场景选择合适的变量类型进行使用。

特殊说明

以上内容来自我的《大模型应用开发》 课程,这门课程为视频+图文版,深入浅出学习了大模型应用开发的各种技术,例如系统学习了 LangChain4j、Spring AI、Dify、Agent 等技术,其中包含:MCP、Function Call、RAG(简单、原生、高级应用)、向量数据库(Milvus、RedisStack)、Prompt工程、多模态、向量数据库、嵌入模型、N种主流LLM对接、N种DeepSeek对接、同时调用多种大模型、连续对话保存到数据库、上万种 MCP 通用服务对接、大模型直接操作数据库等,还有很多 AI 案例,如:数据库 AI 助手、快递 AI 助手等都是手把手带你实现。手把手教你快速、系统掌握大模型应用开发的核心技术。

如果对此课程感兴趣,请加我微信:vipStone【备注:LLM】