开始节点
开始节点
【开始】 节点是每个对话流智能体或工作流的预设起点节点。
它为后续节点的执行提供必要的初始信息,例如应用使用者输入的内容或上传的文件。
没有开始节点,整个流程无法正常运行。
配置节点
在开始节点的配置页中,主要包含两部分内容:
- 输入字段:由开发者自定义,用于引导使用者在启动流程前输入必要信息。
- 系统变量:AI Center 预设的全局参数,可在后续节点中引用。

输入字段
输入字段由应用开发者定义,通常用于在运行前让用户补充关键信息。
例如,在“周报生成助手”中,可要求用户填写姓名、工作时间、任务内容等背景数据,这些前置信息有助于提升生成结果的准确性与完整度。
支持以下八种输入字段类型,所有字段均可设置为必填项:
| 类型 | 说明 |
|---|---|
| 文本 | 短文本输入,最大长度 256 字符。 |
| 段落 | 长文本输入,适用于较多内容的填写。 |
| 下拉选项 | 由开发者定义固定选项,用户仅能选择,不可自行输入。 |
| 数字 | 仅允许输入数值。 |
| 复选框 | 布尔值输入(真 / 假)。 |
| 对象 | 结构化 JSON 输入,适用于复杂数据结构(仅工作流和对话流可用)。 |
| 单文件 | 允许上传一个文件,支持文档、图片、音频、视频等格式,可本地上传或输入文件 URL。 |
| 文件列表 | 支持批量上传文件,支持多种类型与上传方式。 |
配置完成后,用户在使用智能体前需按提示填写或上传内容,确保 LLM 获取足够的上下文信息,以生成更精准的回复。

系统变量
系统变量是对话流智能体与工作流中的全局参数,可供所有节点读取。
常用于高级场景,如记录用户行为、多轮会话控制或日志追踪等。
工作流系统变量
| 变量名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
sys.user_id | String | 用户 ID,系统为每个用户自动分配唯一标识符 | - |
sys.app_id | String | 应用 ID,区分不同工作流应用 | 可用于开发调试与追踪 |
sys.workflow_id | String | 工作流 ID,记录当前工作流包含的所有节点信息 | 可用于节点结构追踪 |
sys.workflow_run_id | String | 工作流运行 ID,记录每次运行实例 | 可用于运行历史追踪 |

对话流智能体系统变量
| 变量名称 | 数据类型 | 说明 | 备注 |
|---|---|---|---|
sys.query | String | 用户在对话框中首次输入的内容 | - |
sys.files | Array[File] | 用户上传的文件(图片、文档等) | 需在编排页右上角开启“图片上传”功能 |
sys.dialogue_count | Number | 当前对话轮数,每轮自动加 1,可配合条件节点使用 | 可用于多轮逻辑控制 |
sys.conversation_id | String | 当前会话的唯一标识符,确保上下文持续一致 | - |
sys.user_id | String | 分配给每个用户的唯一标识符,用于区分用户 | - |
sys.app_id | String | 应用 ID,用于标识当前智能体应用 | - |
sys.workflow_id | String | 工作流 ID,记录当前对话流结构 | - |
sys.workflow_run_id | String | 工作流运行 ID,记录每次运行实例 | - |

小结
- 【开始】节点是流程的入口,必须存在且不可删除;
- 可配置多种输入字段,供用户在运行前提供必要信息;
- 预设系统变量可在整个流程中被引用,为多轮会话与进阶逻辑提供支持。
