输入节点

输入节点用于在工作流运行到指定位置时收集额外的外部输入。上游无法提前得到所需信息时，可以通过该节点补充参数；工作流会等待必填参数收集完成，再继续执行后续节点。

输入节点适合“执行到这里才知道还缺什么”的交互场景。若参数在工作流启动前就已经确定，应优先配置在开始节点，避免不必要的执行中断。

添加与配置

在节点面板的 输入&输出 分类中添加 输入 节点。通过 新增输入 逐项定义参数；已有参数可直接修改名称、类型、必填状态和说明。

配置	说明
变量名	作为该节点输出变量的名称；不能为空、不能与同级变量重复，必须以字母或下划线开头，后续可包含字母、数字、下划线或 $
变量类型	决定运行时应提交的数据结构，以及下游引用该变量时的类型
必填	开启后，未收集到该参数时工作流不会继续执行后续节点
描述	说明参数含义，帮助调用方或用户提供正确内容

一个输入节点最多配置 20 个顶层参数。变量名不能使用 true、false、and、or、not、null、nil、If、Switch 等保留字。

支持的数据类型

类型选择器包括：

• 基础类型：String、Integer、Number、Boolean、Time、Object、List；
• 文件类型：File、Image、Svg、Audio、Video、Voice、Doc、PPT、Excel、Txt、Code、Zip；
• 数组类型：上述常用类型对应的 Array<...> 类型，包括对象数组（界面显示为 Array＜Object＞）。

选择 Object 或对象数组时，应同时维护清晰的子字段结构，使下游能够按确定路径引用。文件类参数是否能直接上传，取决于实际运行入口和调用渠道；接入前应在目标入口完成一次真实试运行。

通过 新增输入 可以逐项维护参数；对象和对象数组还应同步维护清晰的子字段结构。

输出与下游引用

输入节点中配置的每个参数都会形成一个同名、同类型的节点输出。例如配置必填的 String 参数 city 后，下游节点可以引用 输入.city。

参数名称或类型一旦被下游引用，不建议随意修改。确需调整时，应同步检查所有下游引用和发布入口的数据契约。

示例：补充城市名称

需要根据城市生成景点推荐时，可按以下方式编排：

1. 在输入节点中添加必填的 String 参数 city，描述为“用户想查询热门景点的城市名称”；
2. 在大模型节点的输入或用户提示词中引用 输入.city；
3. 工作流执行到输入节点后等待城市名称，获得输入后继续生成结果。

使用建议

• 只把确实需要执行中途收集的信息放进输入节点；
• 参数名应稳定、语义明确，例如 city、document_id，避免 data1 之类含义不清的名称；
• 必填参数应写清楚描述，文件参数还应说明格式、大小和数量要求；
• 无人值守任务、批量执行或作为技能调用前，应先确认调用方支持输入节点的等待与恢复过程；
• 修改参数后至少进行一次真实试运行，验证运行入口、必填校验和下游引用。

常见问题

为什么工作流执行到输入节点后没有继续？

先检查所有必填参数是否已经提供，再确认当前运行入口是否支持输入节点的交互与恢复。输入节点会等待必填信息，不等同于执行失败。

为什么变量名提示错误？

检查是否为空、是否重复、是否使用保留字，以及是否包含空格、中文或连字符。建议使用英文小写字母、数字和下划线，并以字母或下划线开头。

为什么下游找不到刚配置的参数？

先确认变量名已通过校验并完成自动保存，再重新打开下游变量选择器。若刚修改过名称或类型，还需重新绑定原有引用。

文件参数应该传 URL 还是文件对象？

以实际运行入口的上传结果和接口契约为准。编辑器提供多种文件类型，但不同调用渠道的上传和序列化方式可能不同，应在目标入口完成真实试运行。

输入节点和开始节点有什么区别？

开始节点定义工作流启动时的输入契约；输入节点在流程执行过程中再次收集信息，并可能让流程进入等待状态。