输入

配置输入节点

输入参数：

支持配置一个或多个输入参数，且输入参数可被后置节点引用。

当单击图标时，可新增输入参数。

• 参数名称：变量标识符，下游节点通过此名称引用，只允许输入字母、数字、下划线，且不能以数字开头。建议用业务语义命名：city、order_id、refund_reason。

• 参数类型：可选String、Integer、Number、Boolean、Object、Array、File类型。

  表2 参数类型说明

  类型	说明	用户输入形式	典型用途	示例值
  String	字符串文本	自由文本输入	城市名、姓名、描述、原因	"北京"
  Integer	整数	数字输入	数量、年龄、ID	3
  Number	数值（含小数）	数字输入	金额、比率、坐标	99.5
  Boolean	布尔值	是/否选择	确认操作、开关选项	true
  Object	JSON对象	结构化输入	复合信息（地址、配置）	{"city": "北京", "district": "海淀"}
  Array	数组/列表	多值输入	多选标签、批量ID	["标签A", "标签B"]
  File	文件	文件上传	图片、文档、表格	上传的文件对象

• 描述：向用户展示的提示文字，引导用户理解需要输入什么。参数描述质量直接决定用户是否能正确输入。描述示例如表3所示，输入节点配置如图1所示。需要用户输入时，可查看输入参数描述，如图2所示。

  表3 描述示例

  分类	参数名	描述内容	理由
  好的描述	city	用户询问某个城市或地区的天气情况，包括当前天气、未来天气预报、气温、下雨等	列出具体场景和常见关键词
  	order_id	请输入您的订单号（8位数字，可在"我的订单"页面查看）	说明了格式+告诉用户去哪找
  差的描述	param1	输入参数	用户完全不知道该输入什么
  	city	城市	缺少引导——查天气的城市？发货的城市？用户所在城市？

  图1 配置输入节点
  
  图2 查看输入参数说明
  
• 必填：是否强制用户填写。建议核心参数设为必填，补充信息设为非必填。

相关操作

• 单击图标，可修改判断名称，修改完成后单击名称旁边的进行保存。
• 单击图标，可重命名判断节点名称，复制一个判断节点或删除判断节点；也可以将判断节点连接到结束节点。
• 双击名称下面的节点说明，可修改节点的描述信息。
• 单击图标，可查看文档信息。

示例

以天气查询为例，用户需要查天气，但没提供需要查询的城市，因天气插件需要city参数，因此需要输入节点向用户收集需要查询的城市名。

图3 工作流

工作流核心节点如表4所示。

效果示例如图4所示。

图4 效果示例

常见问题

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

  表5 输入节点和开始节点区别

  维度	开始节点	输入节点
  位置	工作流最前端，仅有一个	工作流任意中间位置，可有多个
  触发时机	用户发起对话时自动触发	工作流执行到该位置时主动暂停并追问
  信息类型	用户的初始输入（如自由文本query）	工作流中途需要的额外信息（如订单号、城市名）
  是否阻断	不阻断（工作流从这里开始）	阻断工作流执行，直到用户输入完毕
  适用场景	收集每次对话都需要的基础信息	收集特定分支/条件下才需要的补充信息

• 其他常见问题

  表6 其他常见问题

  问题现象	可能原因	解决方案
  工作流暂停后用户看不到追问提示	参数的描述字段为空	为每个参数填写清晰的描述文字，这是用户看到的追问内容
  用户输入后工作流未恢复	存在未填写的必填参数	检查是否所有必填参数都已提交。适当减少必填参数数量
  下游节点引用输入参数时值为空	工作流通过条件分支绕过了输入节点	确保输入节点在当前执行路径上。或在下游判断节点中增加空值处理逻辑
  用户输入的格式不符合预期（如Integer参数输入了文字）	参数类型与用户实际输入不匹配	①在描述中明确告知格式要求 ②考虑使用String类型接收，在后续节点中做格式校验
  参数名称报错	名称以数字开头或包含特殊字符	仅允许字母、数字、下划线，必须以字母或下划线开头
  多个输入节点的参数同名，下游引用混乱	不同输入节点使用了相同的参数名（如都叫input）	使用不同的节点名称+参数名称组合，下游通过{{节点名.参数名}}区分
  工作流一直暂停，用户无响应	用户离开了对话或不理解追问	①优化参数描述让追问更清晰 ②考虑在描述中提供默认值建议 ③评估是否可以将该参数改为非必填