开始

定义

"开始" 节点是每个工作流应用(Chatflow / Workflow)必备的预设节点,为后续工作流节点以及应用的正常流转提供必要的初始信息,例如应用使用者所输入的内容、以及上传的文件等。

配置节点

在开始节点的设置页,你可以看到两部分设置,分别是 “输入字段” 和预设的系统变量

Chatflow 和 Workflow

输入字段

输入字段功能由应用开发者设置,通常用于让应用使用者主动补全更多信息。例如在周报应用中要求使用者按照格式预先提供更多背景信息,如姓名、工作日期区间、工作详情等。这些前置信息将有助于 LLM 生成质量更高的答复。

支持以下六种类型输入变量,所有变量均可设置为必填项:

  • 文本

    短文本,由应用使用者自行填写内容,最大长度 256 字符。

  • 段落

    长文本,允许应用使用者输入较长字符。

  • 下拉选项

    由应用开发者固定选项,应用使用者仅能选择预设选项,无法自行填写内容。

  • 数字

    仅允许用户输入数字。

  • 单文件

    允许应用使用者单独上传文件,支持文档类型文件、图片、音频、视频和其它文件类型。支持通过本地上传文件或粘贴文件 URL。详细用法请参考文件上传

  • 文件列表

    允许应用使用者批量上传文件,支持文档类型文件、图片、音频、视频和其它文件类型。支持通过本地上传文件或粘贴文件 URL。详细用法请参考文件上传

Dify 内置的文档提取器节点只能够处理部分格式的文档文件。如需处理图片、音频或视频类型文件,请参考外部数据工具搭建对应文件的处理节点。

配置完成后,用户在使用应用前将按照输入项指引,向 LLM 提供必要信息。更多的信息将有助于 LLM 提升问答效率。

系统变量

系统变量指的是在 Chatflow / Workflow 应用内预设的系统级参数,可以被应用内的其它节点全局读取。通常用于进阶开发场景,例如搭建多轮次对话应用、收集应用日志与监控、记录不同应用和用户的使用行为等。

Workflow

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

变量名称
数据类型
说明
备注

sys.files

[LEGACY]

Array[File]

文件参数,存储用户初始使用应用时上传的图片

图片上传功能需在应用编排页右上角的 “功能” 处开启

sys.user_id

String

用户 ID,每个用户在使用工作流应用时,系统会自动向用户分配唯一标识符,用以区分不同的对话用户

sys.app_id

String

应用 ID,系统会向每个 Workflow 应用分配一个唯一的标识符,用以区分不同的应用,并通过此参数记录当前应用的基本信息

面向具备开发能力的用户,通过此参数区分并定位不同的 Workflow 应用

sys.workflow_id

String

Workflow ID,用于记录当前 Workflow 应用内所包含的所有节点信息

面向具备开发能力的用户,可以通过此参数追踪并记录 Workflow 内的包含节点信息

sys.workflow_run_id

String

Workflow 应用运行 ID,用于记录 Workflow 应用中的运行情况

面向具备开发能力的用户,可以通过此参数追踪应用的历次运行情况

Workflow 类型应用系统变量

Chatflow

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

变量名称
数据类型
说明
备注

sys.query

String

用户在对话框中初始输入的内容

sys.files

Array[File]

用户在对话框内上传的图片

图片上传功能需在应用编排页右上角的 “功能” 处开启

sys.dialogue_count

Number

用户在与 Chatflow 类型应用交互时的对话轮数。每轮对话后自动计数增加 1,可以和 if-else 节点搭配出丰富的分支逻辑。

例如到第 X 轮对话时,回顾历史对话并给出分析

sys.conversation_id

String

对话框交互会话的唯一标识符,将所有相关的消息分组到同一个对话中,确保 LLM 针对同一个主题和上下文持续对话

sys.user_id

String

分配给每个应用用户的唯一标识符,用以区分不同的对话用户

sys.app_id

String

应用 ID,系统会向每个 Workflow 应用分配一个唯一的标识符,用以区分不同的应用,并通过此参数记录当前应用的基本信息

面向具备开发能力的用户,通过此参数区分并定位不同的 Workflow 应用

sys.workflow_id

String

Workflow ID,用于记录当前 Workflow 应用内所包含的所有节点信息

面向具备开发能力的用户,可以通过此参数追踪并记录 Workflow 内的包含节点信息

sys.workflow_run_id

String

Workflow 应用运行 ID,用于记录 Workflow 应用中的运行情况

面向具备开发能力的用户,可以通过此参数追踪应用的历次运行情况

Chatflow 类型应用系统变量

Last updated