⚠️ 本文档由 AI 自动翻译。如有任何不准确之处，请参考英文原版。
简介
用户输入节点是一种开始节点，你可以在其中定义应用程序运行时从最终用户收集的信息。 使用此节点启动的应用程序按需运行，通过直接用户交互或 API 调用启动。你还可以将这些应用程序发布为独立的 Web 应用程序或 MCP 服务器，通过后端服务 API 公开它们，或在其他 Dify 应用程序中作为工具使用。每个应用程序画布只能包含一个用户输入节点。
输入变量
预设
预设输入变量由系统定义，默认可用。-
userinput.files：最终用户运行应用程序时上传的文件。对于工作流应用程序，此预设变量已被视为遗留变量，仅为向后兼容而保留。我们建议使用自定义文件输入字段来收集用户文件。 -
userinput.query（仅限对话流）：从用户最新对话轮次自动捕获的文本消息。
自定义
你可以在用户输入节点中配置自定义输入字段，以从最终用户收集信息。每个字段都会成为下游节点可以引用的变量。例如，如果你添加一个变量名为user_name 的输入字段，你可以在整个工作流中将其引用为 {{user_name}}。
你可以选择七种类型的输入字段来处理不同类型的用户输入。
标签名称会显示给你的最终用户。
文本输入
- 短文本
- 段落
短文本字段接受最多 256 个字符。用于姓名、电子邮件地址、标题或任何单行的简短文本输入。
结构化输入
- 选择
- 数字
- 复选框
选择字段显示带有预定义选项的下拉菜单。用户只能从列出的选项中选择，确保数据一致性并防止无效输入。
文件输入
- 单个文件
- 文件列表
单文件字段允许用户上传任何支持类型的一个文件，可以从设备上传或通过文件 URL。上传的文件作为包含文件元数据（名称、大小、类型等）的变量可用。
- 文档文件可以路由到文档提取器节点以进行文本提取，以便 LLM 能够理解其内容。
- 图像可以发送到具有视觉能力的 LLM 节点或专门的图像处理工具节点。
- CSV 或 JSON 等结构化数据文件可以使用代码节点进行解析和转换。
下一步
设置用户输入节点后，你可以将其连接到其他节点以处理收集的数据。常见模式包括：- 将输入发送到 LLM 节点进行处理。
- 使用知识检索节点根据输入查找相关信息。
- 根据输入使用条件逻辑将执行路径路由到不同的分支。