节点配置与变量引用

功能概述

流程由节点、连线和变量组成。节点库提供 26 类节点，按基础、AI生成、智能体、知识库、逻辑、数据、交互与生态集成分组；开始节点在新流程中自动创建。

1. 添加节点与引用变量

点击画布 节点 打开节点库，选择节点加入画布。拖动端点连接执行顺序；在已有连线的“＋”位置插入节点时，系统同步调整连线。

节点库按能力分组；开始节点每个流程只有一个。

通过 {x} 选择当前节点的上游变量。变量引用取决于连线关系，节点名称用于展示，节点标识用于取值。

选择器显示上游开始输入及系统变量。

使用位置	填写方式
模板、提示词、请求文本	用选择器插入变量，形成可读的引用标签
条件比较、变量赋值	选择变量本身，保持类型与比较方式一致
代码	先声明节点入参，在 main(params) 中读取
子流程	将本流程取值映射到子流程开始节点的参数名
结束节点	选择流式来源，或将变量映射为最终结果字段

节点标识

正文中的 start.message 表示开始节点的 message。节点改名只改变显示名称，引用仍按节点标识取值；复制节点或改名后，用选择器确认当前标识。

2. 基础与文本生成节点

节点	主要配置	产出与连接方式
开始 start	入参名称、类型、必填、描述及默认值	生成流程入参；聊天形式应声明 message
结束 end	流式来源，或结果字段名称与取值	流式转发所选节点，或返回结构化结果
大模型 llm	模型、参数、系统/用户等消息序列，可选技能	content、reasoning_content、tokens；可作为流式来源
模板 template	带变量引用的文本模板	content，为完整渲染文本
内容改写 rewrite	模型、原文、改写要点	content、tokens；可作为流式来源
信息提取 extract	模型、待提取文本、要求及字段清单	提取字段、原始 content 与 tokens
意图分类 classifier	模型、输入、类别标识/名称/说明	category、label、branch；按类别出口连接
图片生成 image	图片模型、提示词、负面提示、尺寸、质量与风格	图片地址或 Base64、修订提示词及尺寸

消息序列先写规则，再引用当前输入。信息提取的字段名称应与下游引用一致；意图分类的每个类别都应连接预期处理节点，末项用于承接未匹配的分类结果。

3. 知识与智能体节点

节点	主要配置	产出与连接方式
知识检索 retrieval	知识库、查询文本、召回条数、最低分数；重排开关默认开启，按知识库配置的重排模型排序，关闭后只按向量相似度排序	content、sources、query；sources 保留文件与评分
智能体 agent	提供方、外部智能体、用户问题及系统提示	content、reasoning_content、model、tokens
技能 skill	模型、技能列表、系统要求、问题与工具调用上限	content、activatedSkills、模型与用量
专家团 team	专家团应用与问题	content、memberTrace、tokens

知识检索本身返回资料，下游大模型负责依据资料回答。智能体、技能与专家团的资源配置在对应管理页维护，节点负责选择资源和传入本次任务。

4. 逻辑控制节点

节点	主要配置	产出与使用要点
条件分支 condition	条件或表达式；分支内 AND/OR、变量、比较方式与比较值	branch；表达式方式还保留求值结果，各出口分别连线
循环 loop	列表来源、最大轮数、提前退出表达式、循环体	results、count、total、tokens；循环体最后节点产出为本轮结果
子流程 subflow	流程资源、开始入参映射	result 与声明出参；已发布时执行发布版本，尚未发布时读取草稿
变量赋值 assign	目标变量、引用或直写、值	更新指定上游变量，下游读取更新后的值
代码 code	JavaScript 脚本、节点输入及输出定义	main(params) 返回对象的键作为输出；普通值写入 result

循环体使用线性节点链，不单独添加开始与结束；循环内使用 item、index、results 等循环上下文，提前退出表达式使用面板说明的 vars.loop 路径。人工确认不放入循环体。

人工确认的作答值与 confirmed 比较，分别连接“资料齐备”和“否则”。

5. 数据与外部能力节点

节点	主要配置	产出与使用要点
HTTP请求 http	地址、方法、内容类型、请求头、查询参数、表单或请求体	按声明输出使用 HTTP 响应字段；表单编码与 JSON 请求体分别填写
数据库 database	数据源与 SQL	rows、count、sql；先在控制台核对查询
MCP mcp	服务列表、模型、任务提示词	content；由模型选择并调用工具
插件 plugin	已登记插件与动态入参	API 返回状态/头/正文，数据库返回 rows/count，代码返回 result 等声明字段
三方平台 platform	平台资源、对话/工作流模式、问题及平台所需标识和输入	平台正文、会话及声明字段，按提供方协议配置

外部地址、工具参数和密钥由管理配置提供。MCP 节点的提示词是交给模型的任务描述，由模型选择工具并生成调用参数。

6. 交互与内容处理节点

节点	主要配置	产出与使用要点
人工确认 human	提问内容、自由文本或单选、显示名与选项值	挂起等待作答；返回 answer、answerText、answerIndex、content
消息通知 notify	消息模板编码及模板变量	sent；渠道与模板在能力扩展中维护
延迟 delay	等待秒数	seconds；按流程安排继续执行
内容审核 moderation	待检测文本、类别、拦截/替换/通知及提示	branch、hit、level、words、content、tip，按 pass/block 出口连线

节点面板可按任务需要设置超时、重试次数和失败处理方式；无特殊要求时保留默认值。

7. 完整示例：人工确认与条件分支

创建并连线

新建 DOCS_人工确认流程，组成 开始 → 人工确认 → 条件分支 → 结束。条件的两个出口都接到结束节点，返回当前作答文本。

配置确认选项

提问填写“本次咨询资料是否已准备完整？”，作答方式选择单选：

显示	值
资料已齐备	confirmed
补充资料	supplement

确认问题、选项与输出变量。

配置条件和输出

条件选择 人工确认 → 作答值，比较方式为等于，比较值填写 confirmed，分支名称为“资料齐备”。否则走默认出口。

结束选择变量输出，新增 confirmation，取值选择 人工确认 → 作答文本。检查通过后保存草稿。

运行并恢复

点击 调试，填写开始入参后运行。到人工确认节点时流程挂起，选择“资料已齐备”，点击 提交并继续。

流程挂起，等待确认后继续。

完成后，人工确认输出 answer=confirmed，条件命中 b1，最终 confirmation 为“资料已齐备”。

恢复后四节点完成，最终输出与人工选择一致。

选择“补充资料”时，条件走否则分支，最终返回“补充资料”。

选择“补充资料”后，流程经否则分支返回作答文本。

发布并运行

发布当前版本后，点击发布左侧 运行。在打开的表单页重复提交入参、完成确认并核对最终结果。

发布版本等待人工作答。

确认后返回最终结果。

查看人工确认、分支和恢复执行演示

节点配置、暂停、作答与分支结果的关键步骤

8. 运行检查

先确认图结构通过检查，再核对每个节点的输入和输出。节点图标旁的状态用于定位执行位置；调试面板的时间线查看单节点，输出页查看最终结果与各节点产出。

代码、赋值、循环、子流程与 HTTP 的完整配置及输入输出见 节点编排实战。模型、知识和专家团见对应教程；图片生成、外部智能体与消息通知节点需先接入对应服务。