# 输入
输入节点用于在工作流**执行过程中暂停流程**，向用户收集额外信息。当下游节点需要某些参数，而这些参数在之前的流程中尚未获取时，您可以插入一个输入节点来主动追问用户。
**输入节点使用场景：**
表1输入节点使用场景 
| 场景      | 示例                           | 为什么不在开始节点收集              |
|:---|:---|:---|
| 缺失信息追问  | 用户说"帮我查天气"但没说城市，插件节点需要city参数 | 用户的初始输入中不一定包含所有必要信息      |
| 条件性信息收集 | 仅当用户选择"退款"时才需要收集订单号和退款原因     | 该信息仅在特定分支才需要，不应在开始节点强制收集 |
| 多步表单    | 贷款申请需依次收集：身份信息→收入信息→贷款金额     | 一次性收集太多信息会增加用户放弃率        |
| 二次确认    | 执行敏感操作前（如删除数据、提交订单），要求用户确认   | 确认动作必须发生在操作之前的特定位置       |
| 人工补充    | 大模型分析后发现信息不足，需要用户补充更多细节      | 信息缺口是在工作流执行过程中才发现的       |
   
#### 配置输入节点
支持配置一个或多个输入参数，且输入参数可被后置节点引用。
当单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950452.png)图标时，可新增输入参数。
- 参数名称：变量标识符，下游节点通过此名称引用，只允许输入字母、数字、下划线，且不能以数字开头。建议用业务语义命名：city、order_id、refund_reason。

- 参数类型：可选String、Integer、Number、Boolean、Object、Array、File类型。
  表2参数类型说明 
  | 类型      | 说明                                                                                         | 用户输入形式 | 典型用途         | 示例值                              |
  |:---|:---|:---|:---|:---|
  | String  | 字符串文本                                                                                      | 自由文本输入 | 城市名、姓名、描述、原因 | "北京"                             |
  | Integer | 整数                                                                                         | 数字输入   | 数量、年龄、ID     | 3                                |
  | Number  | 数值（含小数）                                                                                    | 数字输入   | 金额、比率、坐标     | 99.5                             |
  | Boolean | 布尔值 取值逻辑：空输入=false，非空输入=true；描述须明确true、false对应的具体业务场景。 | 是/否选择  | 确认操作、开关选项    | true                             |
  | Object  | JSON对象                                                                                     | 结构化输入  | 复合信息（地址、配置）  | {"city": "北京", "district": "海淀"} |
  | Array   | 数组/列表                                                                                      | 多值输入   | 多选标签、批量ID    | \["标签A", "标签B"\]                 |
  | File    | 文件                                                                                         | 文件上传   | 图片、文档、表格     | 上传的文件对象                          |
     
  
- 描述：向用户展示的提示文字，引导用户理解需要输入什么。参数描述质量直接决定用户是否能正确输入。描述示例如[表3]所示，输入节点配置如[图1]所示。需要用户输入时，可查看输入参数描述，如[图2]所示。
   表3描述示例 
  | 分类                                               | 参数名      | 描述内容                                  | 理由                             |
  |:---|:---|:---|:---|
  | 好的描述    | city     | 用户询问某个城市或地区的天气情况，包括当前天气、未来天气预报、气温、下雨等 | 列出具体场景和常见关键词                   |
  | 好的描述    | order_id | 请输入您的订单号（8位数字，可在"我的订单"页面查看）           | 说明了格式+告诉用户去哪找                  |
  | 差的描述  | param1   | 输入参数                                  | 用户完全不知道该输入什么                   |
  | 差的描述  | city     | 城市                                    | 缺少引导------查天气的城市？发货的城市？用户所在城市？ |
     
  图1配置输入节点   
  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717550077.png "点击放大")
  图2查看输入参数说明   
  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950438.png) 
- 必填：是否强制用户填写。建议核心参数设为必填，补充信息设为非必填。
 
#### 相关操作
- 单击节点名称，可修改节点名称。
- 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549909.png)图标，可对节点进行重命名、复制、删除或更换节点；也可以将节点连接到结束节点。
- 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790412.png)图标，可对节点进行测试。
- 单击名称下面的节点说明，可修改节点的描述信息。
- 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549911.png)图标，可查看文档信息。
 
#### 配置示例
以天气查询为例，用户需要查天气，但没提供需要查询的城市，因天气插件需要city参数，因此需要输入节点向用户收集需要查询的城市名。
图3工作流   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950434.png "点击放大")
工作流核心节点如[表4]所示。
 表4节点配置说明 
| 节点类型      | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 示例                                                                                                    |
|:---|:---|:---|
| 开始节点      | 使用系统默认配置query参数，表示用户输入的内容。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790586.png "点击放大") |
| 输入节点      | 此节点用于向用户收集需要查询的城市名。 **输入参数：** 单击![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717550071.png)图标，新增输入参数。 - 参数名称：city  - 参数类型：String  - 描述：用户询问某个城市的天气情况，包括当前天气、气温等  - 必填：勾选   |  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717390205.png "点击放大") |
| 插件节点-高德天气 | 此节点根据用户输入的城市名，查询当前天气情况。 **输入参数：** city：引用输入节点的"city"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790594.png "点击放大") |
| 结束节点      | 此节点根据"高德天气"插件节点查询的结果，生成一段包含城市天气和气温的信息给用户。 **输入参数：** - city：引用"高德天气"插件节点的city。  - weather：引用"高德天气"插件节点的weather。  - temperature：引用"高德天气"插件节点的temperature。   **指定回复：** {{city}}当前天气为{{weather}}，温度为{{temperature}}°C                                                                                        |  ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790596.png "点击放大") |
   
效果示例如[图4]所示。
图4效果示例   
![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717550075.png)
#### 常见问题
- **输入节点和开始节点** **有什么区别？**
  表5输入节点和开始节点区别 
  | 维度       | 开始节点                    | 输入节点                       |
  |:---|:---|:---|
  | **位置**   | 工作流**最前端**，仅有一个         | 工作流**任意中间位置**，可有多个         |
  | **触发时机** | 用户发起对话时**自动触发**         | 工作流执行到该位置时**主动暂停并追问**      |
  | **信息类型** | 用户的**初始输入**（如自由文本query） | 工作流**中途需要**的额外信息（如订单号、城市名） |
  | **是否阻断** | 不阻断（工作流从这里开始）           | **阻断**工作流执行，直到用户输入完毕       |
  | **适用场景** | 收集每次对话都需要的基础信息          | 收集特定分支/条件下才需要的补充信息         |
     
  
- **其他常见问题**
  表6其他常见问题 
  | 问题现象                          | 可能原因                      | 解决方案                                                                                                                                                              |
  |:---|:---|:---|
  | 工作流暂停后用户看不到追问提示               | 参数的描述字段为空                 | 为每个参数填写清晰的描述文字，这是用户看到的追问内容                                                                                                                                        |
  | 用户输入后工作流未恢复                   | 存在未填写的**必填**参数            | 检查是否所有必填参数都已提交。适当减少必填参数数量                                                                                                                                         |
  | 下游节点引用输入参数时值为空                | 工作流通过条件分支**绕过**了输入节点      | 确保输入节点在当前执行路径上。或在下游判断节点中增加空值处理逻辑                                                                                                                                  |
  | 用户输入的格式不符合预期（如Integer参数输入了文字） | 参数类型与用户实际输入不匹配            | ①在描述中明确告知格式要求 ②考虑使用String类型接收，在后续节点中做格式校验                                                                                     |
  | 参数名称报错                        | 名称以数字开头或包含特殊字符            | 仅允许字母、数字、下划线，必须以字母或下划线开头                                                                                                                                          |
  | 多个输入节点的参数同名，下游引用混乱            | 不同输入节点使用了相同的参数名（如都叫input） | 使用不同的节点名称+参数名称组合，下游通过{{节点名.参数名}}区分                                                                                                                                |
  | 工作流一直暂停，用户无响应                 | 用户离开了对话或不理解追问             | ①优化参数描述让追问更清晰 ②考虑在描述中提供默认值建议 ③评估是否可以将该参数改为非必填   |