结束节点
什么是结束节点?
结束节点是工作流的最终节点,用于返回工作流程运行后的结果信息。每个工作流至少需要一个结束节点,但也可以有多个结束节点对应不同的结束路径。
图片说明:
结束节点界面主要包含"输出"配置区域,您可以在此处定义工作流结束时需要返回的参数。界面支持添加多个输出参数,每个参数需要设置参数名、显示名称和参数值。参数值可以是表达式或固定值,支持引用工作流中其他节点产生的数据。
为什么需要结束节点?
在构建工作流时,结束节点解决了以下关键问题:
- 明确工作流终点:结束节点清晰地标记了工作流执行的终止点,让整个流程逻辑更加清晰。
- 定义输出结果:结束节点可以配置输出参数,决定工作流最终对外展示哪些结果数据。
- 规范数据返回:结束节点对输出数据进行格式化和组织,确保返回结果的一致性和可用性。
- 支持复杂流程:在有多个可能结束点的复杂工作流中,不同的结束节点可以返回不同的结果数据。
适用场景
1. 智能问答流程
在问答型 AI 助理中,结束节点可以输出经过处理的最终回答内容,以及可能的相关推荐或引用资料。
2. 数据处理工作流
在数据分析或处理流程中,结束节点返回处理完成的数据结果,如统计报表、分析结论等。
3. 子流程调用
当作为子流程被主流程调用时,结束节点定义了子流程需要返回给主流程的数据,类似函数的返回值。
节点参数说明
输出参数
结束节点的核心配置是输出参数,您可以定义工作流结束时需要返回的数据:
配置项 | 描述 | 是否必填 |
---|---|---|
参数名 | 输出参数的标识符,用于在系统中引用此参数 | 是 |
显示名称 | 参数的友好显示名称,用于界面展示 | 是 |
参数类型 | 支持设置不同的参数类型,如:字符串,数组等 | 是 |
参数值 | 参数的实际值,可以是固定值、表达式或变量引用 | 是 |
使用说明
基本配置步骤
- 添加结束节点:
- 从节点面板中拖拽"结束节点"到画布上
- 将前一个节点的输出连接到结束节点
- 配置输出参数:
- 点击"添加参数"按钮添加需要输出的参数
- 设置参数名(如"result")和显示名称(如"处理结果")
- 选择参数值类型(表达式或固定值)
- 如果选择表达式,可使用
${变量名}
引用工作流中的变量
- 保存配置:
- 确认所有必要的输出参数都已配置完成
- 保存节点配置,完成结束节点的设置
进阶技巧
多参数组织
当需要返回多个相关参数时,可以采用以下组织方式:
- 相关参数分组:按照功能或数据类型组织参数,使结构更清晰
- 使用嵌套结构:利用 JSON 格式组织复杂数据,如
{"data": ${result}, "meta": ${metadata}}
- 参数命名规范:使用统一的命名规则,如
result_main
、result_details
等
动态输出处理
根据流程不同路径返回不同结果:
- 条件判断前置:在结束节点前使用条件分支节点,根据不同条件连接到不同的结束节点
- 变量包装:使用代码执行节点将多种可能的结果预先包装到一个变量中,然后在结束节点引用
注意事项
参数命名规范
- 避免特殊字符:参数名应使用字母、数字和下划线,避免空格和特殊字符
- 语义化命名:参数名应反映其内容和用途,如
search_result
而非简单的data
- 保持一致性:同一工作流中的多个结束节点应遵循统一的命名规范
数据类型处理
- 类型一致性:确保输出参数的数据类型符合调用方的预期
- 格式转换:必要时使用代码执行节点进行数据格式转换
- 空值处理:考虑参数可能为空的情况,提供合理的默认值
多结束节点管理
- 清晰标识:给不同的结束节点添加明确的标签或注释
- 路径规划:确保每个可能的执行路径都有对应的结束节点
- 结果一致性:即使是不同的结束节点,也应保持关键参数结构的一致性
常见问题
为什么我设置的输出参数没有显示在结果中?
- 检查参数名称:确认参数名没有拼写错误
- 检查表达式:如果使用表达式,确认语法正确且引用的变量存在
- 检查流程执行:确认工作流确实执行到了这个结束节点
- 检查变量作用域:确认引用的变量在结束节点的作用域内可访问
如何返回复杂的数据结构?
- 使用 JSON 格式:在表达式中使用 JSON 格式组织复杂数据,如
{"items": ${list}, "count": ${count}}
- 预处理数据:在结束节点之前使用代码执行节点构建复杂数据结构
- 结构化命名:使用有层次的参数命名方式,如
result_header
、result_body
、result_footer
如何确保工作流中有多个路径时,每个路径都有合适的结束?
- 路径分析:梳理工作流所有可能的执行路径
- 对应结束节点:为每个主要路径设置独立的结束节点
- 统一返回结构:保持所有结束节点的核心参数结构一致
- 状态标识:在输出中包含状态标识(如
status
、code
),便于识别不同路径的结果
常见搭配节点
节点类型 | 搭配原因 |
---|---|
条件分支节点 | 根据不同条件连接到不同的结束节点,返回不同结果 |
代码执行节点 | 在结束前整理和格式化最终输出数据 |
大模型调用节点 | 生成结构化的回答内容,然后由结束节点返回 |
消息回复节点 | 在结束前向用户发送消息,结束节点则记录操作结果 |