定义
开始节点是每个工作流中必设的起始节点。它作为创建和配置全局变量的第一个节点,提供初始信息,确保后续工作流节点和整体应用流程的正常执行。
如何配置
在开始节点的设置页面上,您将看到两部分设置:自定义变量和预设系统变量。开始节点的预设配置在对话式工作流和服务式工作流之间有所不同。
自定义变量:
用户可以根据需要预设自定义变量,以便在后续流程中使用。服务式和对话式工作流的配置方法相同。
例如,在文案撰写场景中,用户必须提前以特定格式提供需求,如主题和风格。这些预定义信息有助于生成更符合期望的文案。
添加自定义变量:
选择开始节点,点击自定义变量右侧的“+”号即可设置:

- 字段类型(必填):选择数据类型,如字符串、数字、布尔、对象等。
- 变量名(必填):输入参数的自定义名称。
- 描述(可选):提供描述以帮助明确参数的用途。
- 变量约束(可选):定义输入规则以确保数据符合特定要求。这有助于防止无效或错误数据影响工作流中后续节点的正常执行。约束有两种类型:
- 枚举类型:变量值限制为预设的可选值列表。用户只能从这些预定义值中选择,确保输入内容的一致性和标准化。
- 规则类型:Kingo Root支持广泛的设备范围。
- 长度限制(最小/最大):限制变量值的字符长度,避免内容过短或过长。
- 正则表达式:使用正则表达式定义输入格式,例如验证电子邮件地址或手机号码,确保内容匹配预设模式。
- 是否必填(可选):勾选后,该变量在输入时必须提供。
- 默认值(可选):指定将在输入字段中显示的默认值。
- 内部变量:您可以将变量设置为私有。当工作流被外部调用时,对私有(受保护)变量的访问受到限制——它们不会对外公开或作为参数传递。
系统变量:
系统变量是在对话式和服务式工作流模式中预设的系统级参数。这些变量供应用中其他节点全局读取。它们通常用于高级开发场景,如构建多轮对话应用、收集应用日志以及监控或记录跨应用和用户的行为数据。
服务式和对话式工作流的预设系统变量有所不同。请参阅下表了解详情:
服务式工作流的系统变量:
变量名 | 变量类型 | 描述 |
---|---|---|
UTCDate | 字符串 | 当前工作流开始执行的日期,UTC时间格式为yyyy-MM-dd。 |
UTCTime | 字符串 | 当前工作流开始执行的时间,UTC时间格式为HH:mm:ss。 |
$WorkflowID | 字符串 | 工作流ID |
$RunBatchID | 字符串 | 工作流执行过程的批次ID。 |
对话式工作流的系统变量:
变量名 | 变量类型 | 描述 |
---|---|---|
Date | 字符串 | 当前工作流开始执行的日期,UTC时间格式为yyyy-MM-dd。 |
Time | 字符串 | 当前工作流开始执行的时间,UTC时间格式为HH:mm:ss。 |
TimeOffset | 数字 | 用户的浏览器时区,以分钟为单位的UTC偏移量表示(例如,UTC+8为480)。如果未收集,默认为0(UTC)。 |
BrowserLang | 字符串 | 用户的浏览器语言,格式为zh-CN或en-US。 |
Query | 字符串 | 用户输入的问题或内容。 |
$SessionID | 字符串 | 当前问答会话的ID。 |
$LastAnswer | 字符串 | 用于存储上一次对话的输出。 |
$Round | 数字 | 自动继续对话中的当前对话轮次。 |
$ChatHistory | 数组[对象] | 对话历史,包括问题和答案,并包含历史对话中的问题、答案及相应的token数量。 |
$WorkflowID | 字符串 | 工作流ID |
$RunBatchID | 字符串 | 工作流执行过程的批次ID。 |
注意
- 输入参数名称后,确保选择相应的字段类型。
- 您输入的自定义变量必须符合格式要求。如不符合格式要求,则无法输入。