Coze中“输入” 节点的使用秘诀+举例+疑问（节点 A001）

“输入” 节点的使用场景

• 信息收集场景：当你创建一个问卷调查类的机器人时，需要收集用户的年龄（整数类型）、姓名（字符串类型）、是否已婚（布尔值类型）等信息，就可以使用 “输入” 节点。例如收集年龄时，将变量类型设为 “Integer” ，用户输入的年龄数值会被存储在对应的变量中供后续流程使用。
• 参数设定场景：如果搭建一个计算工具类机器人，让用户输入参与计算的数值（Number 类型）作为计算参数，“输入” 节点就能发挥作用。比如计算商品折扣价，用户输入商品原价，节点接收数值后进入折扣计算流程。
• 条件判断场景：在设计一个引导用户选择服务的机器人流程中，用 “输入” 节点获取用户选择（Boolean 类型，如是否需要加急服务），后续根据这个输入进行不同的服务流程分支处理。

“输入” 节点的特性

• 类型多样化：支持多种数据类型，能满足不同信息收集和处理需求，提升机器人交互的灵活性和适用性。
• 可控性强：可以设置变量是否必填，确保关键信息被获取，避免因缺少必要信息导致流程中断或出错。
• 标识明确：通过 “变量名” 为每个输入信息赋予唯一标识，方便在整个流程中准确引用和处理对应的数据。

功能选项详细说明

• 变量名：它是输入数据在整个机器人流程中的唯一标识，类似于一个 “标签”。比如设置变量名为 “user_age”，就代表这个节点输入的是用户年龄相关的数据。字符限制为 20 ，需简洁且具有描述性，方便后续节点调用和开发者理解。
• 变量类型
  • Integer（整数）：专门用于接收整数值的输入，比如用户的年龄、购买商品的数量等。
  • String（字符串）：用于接收文本形式的输入，像用户的地址、问题描述、留言内容等都可以用这种类型。
  • Number（数字）：除了整数外，还能接收小数数值，适合用于输入价格、比例等数据。
  • Boolean（布尔值）：只有 “真（True）” 和 “假（False）” 两种状态，常用于二选一的选择场景，比如是否订阅服务。
• 必填：勾选该选项后，在机器人与用户交互过程中，这个 “输入” 节点对应的内容必须填写，否则无法进入后续流程，保证了重要信息的获取。

以下为你列举 “变量名” 和 “变量类型” 的多个例子：

变量名

• 描述用户属性：
  • user_name：用于存储用户的姓名，比如 “张三”“Alice”。
  • user_age：记录用户年龄，如 “25”“38”。
  • user_gender：保存用户性别，取值可能是 “男”“女”“其他” 。
  • user_location：存放用户所在位置，像 “北京市朝阳区”“纽约市曼哈顿”。
• 表示业务相关数据：
  • order_number：记录订单编号，例如 “20250301001”“20250302005” 。
  • product_name：存储商品名称，比如 “笔记本电脑”“纯棉 T 恤”“蓝牙耳机”。
  • service_type：代表服务类型，取值如 “维修服务”“咨询服务”“配送服务”。
  • payment_method：表示支付方式，可能是 “微信支付”“支付宝”“银行卡支付”。
• 体现流程状态或参数：
  • process_step：记录流程当前步骤，比如 “步骤 1”“步骤 3”。
  • search_keyword：存放搜索关键词，像 “旅游攻略”“科幻小说”。
  • discount_rate：保存折扣率，例如 “0.8”“0.95” 。
  • page_number：表示页码，如 “1”“5”。

变量类型

• Integer（整数）：
  • 学生的考试分数，如 “95”“88” 。
  • 购物时购买商品的件数，比如 “3”“5” 。
  • 楼层编号，像 “10”“25” 。
  • 公交车的线路号，例如 “12”“56”。
• String（字符串）：
  • 电子邮箱地址，如 “example@163.com”“test@gmail.com”。
  • 书籍的作者，比如 “鲁迅”“J.K. 罗琳”。
  • 电影的名称，像 “《泰坦尼克号》”“《复仇者联盟》” 。
  • 宠物的品种，例如 “金毛犬”“波斯猫”。
• Number（数字）：
  • 商品的价格，如 “99.99”“128.5” 。
  • 物体的重量，比如 “5.6”“10.25”（单位：千克）。
  • 溶液的浓度，像 “0.25”“0.5”（百分比形式时需转换） 。
  • 地理坐标的经纬度（小数形式），例如 “116.4074”（经度）、“39.9042”（纬度）。
• Boolean（布尔值）：
  • 用户是否已阅读并同意隐私协议，取值 “True”（已同意）或 “False”（未同意）。
  • 商品是否有库存，“True”（有库存）、“False”（无库存） 。
  • 任务是否完成，比如 “True”（完成）、“False”（未完成） 。
  • 会员是否到期，“True”（到期）、“False”（未到期）。

在编程或使用类似 Coze 这类工具搭建流程时，变量名一般由程序员或流程搭建者自行定义 ，但并非可以随便起名，需要遵循一定规则和规范：

• 基本规则：

  • 字符组成限制：通常由字母（大写和小写）、数字和下划线组成。比如在 Python 中，user_age、order123 是符合字符组成规则的变量名，而包含特殊符号如user@age就是不合法的。
  • 首字符要求：第一个字符不能是数字。例如2user是错误的变量名，user2则是正确的。
  • 关键字回避：不能与编程语言或工具内部的关键字相同。比如 Python 中的if、for、while等都是关键字，不能作为变量名。
  • 区分大小写：在大多数编程语言和工具中，变量名是严格区分大小写的。像userName和username会被视为两个不同的变量。
• 命名规范和建议：
  • 见名知义：变量名应能清晰表达其存储的数据或代表的含义。比如存储用户邮箱的变量，命名为user_email就比abc更合适。
  • 遵循惯用风格：不同的编程语言或开发社区有各自推荐的命名风格。例如 Python 遵循 PEP8 规范，建议变量名用小写字母，单词之间用下划线隔开；而在 Java 中，常使用驼峰命名法，如userAge 。
  • 避免无意义或混淆的命名：不要使用过于简单、无明确指向的字符组合（如a、b、tmp ，除非在非常简短的代码段且含义明确的场景），也不要使用易混淆的名称。
  • 避免使用系统保留名：不要使用系统提供的类型名、函数名和模块名作为变量名，以免造成冲突和错误。

变量类型的选项详解：

• String（字符串）：由字符组成的序列，可包含字母、数字、符号等，用于存储文本信息。比如用户的姓名 “张三” 、地址 “XX 路 XX 号”、一句话 “今天天气真好” 等。
• Integer（整数）：表示没有小数部分的数字，用于记录数量、编号等。像年龄 25、班级人数 30、商品数量 5 。
• Number（数字）：不仅包含整数，还涵盖有小数部分的数值，适用于表示价格、比例、测量值等。比如商品价格 99.9 元、折扣率 0.8 、物体重量 5.5 千克。
• Boolean（布尔值）：只有两个取值，即 True（真）和 False（假），常用于逻辑判断。例如是否同意协议（同意为 True，不同意为 False）、任务是否完成（完成是 True，未完成是 False） 。
• Time（时间）：用于存储时间相关的数据，包括时刻、日期或者时间段。像会议开始时间 “2025 - 03 - 05 14:00” 、生日 “1995 - 08 - 12” 。
• Object（对象）：是一种复杂的数据类型，以键值对的形式存储相关联的数据集合，能整合多种不同类型的数据。比如一个用户对象{"name": "李四", "age": 30, "isStudent": false} ，包含了姓名（字符串）、年龄（整数）、是否是学生（布尔值）等信息。
• Array（数组）：可以存放多个数据的有序集合，这些数据的类型可以相同，也可以不同。比如存储一个小组学生的成绩[85, 90, 78] ，或者存储不同类型数据的["苹果", 5, true] 。
• File（文件）：代表计算机中的文件实体，如文本文件、图片文件、视频文件等。比如report.docx（文档文件） 、logo.jpg（图片文件）、presentation.pptx（演示文稿文件） 。

​​​​​​​