> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 开始

> 收集用户输入以启动 Workflow 和 Chatflow 应用程序

开始节点允许你定义从终端用户收集哪些内容作为应用程序的输入。

应用程序 **按需** 运行，可通过用户直接交互或 API 调用启动。

你还可以将这些应用程序发布为独立的 Web 应用程序，通过后端服务 API 公开它们，或在其他 Dify 应用程序中作为工具使用。

<Info>
  每个应用程序画布只能包含一个开始节点。
</Info>

## 输入变量

### 预设

预设输入变量由系统定义，默认可用。

* `sys.files`：终端用户运行应用程序时上传的文件。

  <Note>
    对于 Workflow 应用程序，此预设变量已被视为 **遗留** 变量，仅为向后兼容而保留。

    我们建议使用 [自定义文件输入字段](#文件输入) 来收集用户文件。
  </Note>

* `sys.query`（仅限 Chatflow）：从用户最新对话轮次自动捕获的文本消息。

### 自定义

你可以在开始节点中配置自定义输入字段，以收集不同类型的用户输入。每个字段都会成为下游节点可以引用的变量。

<Info>
  **标签名称** 会显示给你的终端用户。
</Info>

#### 文本输入

<Tabs>
  <Tab title="短文本">
    接受最多 256 个字符。用于姓名、电子邮件地址、标题或任何单行的简短文本输入。
  </Tab>

  <Tab title="段落">
    允许无长度限制的长文本。它为用户提供多行文本区域，用于详细响应或描述。
  </Tab>
</Tabs>

#### 结构化输入

<Tabs>
  <Tab title="选择">
    显示带有预定义选项的下拉菜单。用户只能从列出的选项中选择，确保数据一致性并防止无效输入。
  </Tab>

  <Tab title="数字">
    仅限数值输入，适用于数量、评分、ID 或任何需要数学处理的数据。
  </Tab>
</Tabs>

#### 文件输入

<Tabs>
  <Tab title="单个文件">
    允许用户上传任何支持类型的一个文件，可以从设备上传或通过文件 URL。上传的文件作为包含文件元数据（名称、大小、类型等）的变量可用。
  </Tab>

  <Tab title="文件列表">
    支持一次上传多个文件。它适用于批量处理文档、图像或其他文件。

    <Tip>
      使用列表操作节点来过滤、排序或提取上传文件列表中的特定文件以进行进一步处理。
    </Tip>
  </Tab>
</Tabs>

**文件处理**

由于开始节点仅收集文件，不读取或解析其内容，上传的文件必须由后续节点适当处理。例如：

* 文档文件可以路由到文档提取器节点以进行文本提取，以便 LLM 能够理解其内容。

* 图像可以发送到具有视觉能力的 LLM 节点或专门的图像处理工具节点。

* CSV 或 JSON 等结构化数据文件可以使用代码执行节点进行解析和转换。

<Tip>
  当用户上传混合类型的多个文件（例如，图像和文档）时，你可以使用列表操作节点按文件类型分离它们，然后将它们路由到不同的处理分支。
</Tip>