開始

Copy page

定義“開始”?節點是每個工作流應用（Chatflow / Workflow）必備的預設節點，為后續工作流節點以及應用的正常流轉提供必要的初始信息，例如應用使用者所輸入的內容、以及上傳的文件等。

配置節點在開始節點的設置頁，你可以看到兩部分設置，分別是?“輸入字段”?和預設的系統變量。

輸入字段輸入字段功能由應用開發者設置，通常用于讓應用使用者主動補全更多信息。例如在周報應用中要求使用者按照格式預先提供更多背景信息，如姓名、工作日期區間、工作詳情等。這些前置信息將有助于 LLM 生成質量更高的答復。支持以下六種類型輸入變量，所有變量均可設置為必填項：

• 文本：短文本，由應用使用者自行填寫內容，最大長度 256 字符。
• 段落：長文本，允許應用使用者輸入較長字符。
• 下拉選項：由應用開發者固定選項，應用使用者僅能選擇預設選項，無法自行填寫內容。
• 數字：僅允許用戶輸入數字。
• 單文件：允許應用使用者單獨上傳文件，支持文檔類型文件、圖片、音頻、視頻和其它文件類型。支持通過本地上傳文件或粘貼文件 URL。詳細用法請參考文件上傳。
• 文件列表：允許應用使用者批量上傳文件，支持文檔類型文件、圖片、音頻、視頻和其它文件類型。支持通過本地上傳文件或粘貼文件 URL。詳細用法請參考文件上傳。

Dify 內置的文檔提取器節點只能夠處理部分格式的文檔文件。如需處理圖片、音頻或視頻類型文件，請參考外部數據工具搭建對應文件的處理節點。

配置完成后，用戶在使用應用前將按照輸入項指引，向 LLM 提供必要信息。更多的信息將有助于 LLM 提升問答效率。

?

系統變量系統變量指的是在 Chatflow / Workflow 應用內預設的系統級參數，可以被應用內的其它節點全局讀取。通常用于進階開發場景，例如搭建多輪次對話應用、收集應用日志與監控、記錄不同應用和用戶的使用行為等。WorkflowWorkflow 類型應用提供以下系統變量：

變量名稱	數據類型	說明	備注
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 應用中的運行情況	面向具備開發能力的用戶，可以通過此參數追蹤應用的歷次運行情況

ChatflowChatflow 類型應用提供以下系統變量：

變量名稱	數據類型	說明	備注
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 應用中的運行情況	面向具備開發能力的用戶，可以通過此參數追蹤應用的歷次運行情況