Node Description
Start
Definition
The “Start” node is a critical preset node in the Chatflow / Workflow application. It provides essential initial information, such as user input and uploaded files, to support the normal flow of the application and subsequent workflow nodes.Configuring the Node
On the Start node’s settings page, you’ll find two sections: “Input Fields” and preset System Variables.
Input Field
Input field is configured by application developers to prompt users for additional information. For example, in a weekly report application, users might be required to provide background information such as name, work date range, and work details in a specific format. This preliminary information helps the LLM generate higher quality responses. Six types of input variables are supported, all of which can be set as required:- Text: Short text, filled in by the user, with a maximum length of 256 characters.
- Paragraph: Long text, allowing users to input longer content.
- Select: Fixed options set by the developer; users can only select from preset options and cannot input custom content.
- Number: Only allows numerical input.
- Single File: Allows users to upload a single file. Supports document types, images, audio, video, and other file types. Users can upload locally or paste a file URL. For detailed usage, refer to File Upload.
- File List: Allows users to batch upload files. Supports document types, images, audio, video, and other file types. Users can upload locally or paste file URLs. For detailed usage, refer to File Upload.
Dify’s built-in document extractor node can only process certain document formats. For processing images, audio, or video files, refer to External Data Tools to set up corresponding file processing nodes.
System Variables
System variables are preset system-level parameters in Chatflow / Workflow applications that can be globally accessed by other nodes in the application. They are typically used in advanced development scenarios, such as building multi-turn dialogue applications, collecting application logs and monitoring data, or recording usage behavior across different applications and users. Workflow Workflow application provides the following system variables:| Variable Name | Data Type | Description | Notes |
|---|---|---|---|
sys.files[LEGACY] | Array[File] | File parameter, stores images uploaded by users when initially using the application | Image upload feature needs to be enabled in the “Features” section at the top right of the application orchestration page |
sys.user_id | String | User ID, a unique identifier automatically assigned to each user when using the workflow application, used to distinguish different conversation users | |
sys.app_id | String | Application ID, a unique identifier assigned to each Workflow application by the system, used to distinguish different applications and record basic information of the current application | For users with development capabilities, this parameter can be used to differentiate and locate different Workflow applications |
sys.workflow_id | String | Workflow ID, used to record all node information contained in the current Workflow application | For users with development capabilities, this parameter can be used to track and record node information within the Workflow |
sys.workflow_run_id | String | Workflow application run ID, used to record the running status of the Workflow application | For users with development capabilities, this parameter can be used to track the application’s run history |
| Variable Name | Data Type | Description | Notes |
|---|---|---|---|
sys.query | String | The initial content input by the user in the dialogue box | |
sys.files | Array[File] | Images uploaded by the user in the dialogue box | Image upload feature needs to be enabled in the “Features” section at the top right of the application orchestration page |
sys.dialogue_count | Number | The number of dialogue turns during user interaction with the Chatflow application. Automatically increments by 1 after each turn. Can be used with if-else nodes to create rich branching logic. For example, at the Xth turn of dialogue, review the conversation history and provide analysis | |
sys.conversation_id | String | Unique identifier for the dialogue interaction session, grouping all related messages into the same conversation, ensuring the LLM continues the dialogue on the same topic and context | |
sys.user_id | String | Unique identifier assigned to each application user, used to distinguish different conversation users | |
sys.app_id | String | Application ID, a unique identifier assigned to each Workflow application by the system, used to distinguish different applications and record basic information of the current application | For users with development capabilities, this parameter can be used to differentiate and locate different Workflow applications |
sys.workflow_id | String | Workflow ID, used to record all node information contained in the current Workflow application | For users with development capabilities, this parameter can be used to track and record node information within the Workflow |
sys.workflow_run_id | String | Workflow application run ID, used to record the running status of the Workflow application | For users with development capabilities, this parameter can be used to track the application’s run history |
Edit this page | Report an issue