操作使用-工作流编排
大约 9 分钟applicationappflow
操作说明
本文档详细介绍工作流编排应用的具体操作步骤，包括应用创建、流程设计、节点配置和调试运行等核心功能。工作流编排是用于构建复杂业务流程自动化的AI应用，通过可视化拖拽实现多步骤的AI任务处理。
一、工作流编排应用总览
- 登录AI平台，选择【应用工具】>【机器人应用】，进入应用管理页面。
- 在页面顶部的标签栏中，点击【工作流编排】标签，查看工作流编排类型的应用。
- 页面显示已创建的工作流编排应用列表，每个应用卡片显示应用图标、名称和描述信息。
- 页面顶部提供【创建空白应用】和【导入DSL】两种创建方式。
二、创建工作流编排应用
1. 创建空白应用
- 在工作流编排页面，点击左上角的【创建空白应用】按钮。
- 在弹出的创建表单中填写应用信息：
- 应用图标：上传应用的标识图标（可选）
- 应用名称：输入工作流编排的名称
- 描述：输入应用的功能描述，不超过200个字符
- 点击【确定】保存应用，系统会自动跳转到应用配置页面。
2. 导入DSL文件
- 点击【导入DSL】按钮，打开导入对话框。
- 拖拽或点击上传JSON格式的DSL配置文件。
- 系统会自动解析DSL文件并创建对应的工作流编排应用。
三、应用列表管理
1. 查看应用信息
- 创建成功后，应用会显示在工作流编排列表中。
- 每个应用卡片显示应用图标、名称和描述信息。
- 鼠标悬停在应用卡片上会显示操作菜单。
2. 应用操作菜单
当鼠标悬停在应用卡片上时，会显示以下操作选项：
- 复制应用：快速复制现有应用创建副本
- 导出DSL：将应用配置导出为JSON文件
- 运行：在新窗口中打开应用运行页面
- 编辑：修改应用基础信息
- 配置：进入应用的详细配置页面
- 删除：删除应用
四、编辑应用信息
- 在应用卡片的操作菜单中，点击【编辑】按钮（铅笔图标）。
- 在弹出的编辑表单中修改应用信息：
- 更新应用图标
- 修改应用名称
- 更新应用描述
- 点击【确定】保存修改。
编辑提示
- 应用名称建议使用有意义的命名，便于管理和识别
- 描述信息有助于团队成员理解应用的用途
- 应用图标可以提高应用的识别度
五、进入工作流配置
- 在应用卡片的操作菜单中，点击【配置】按钮（设置图标）。
- 系统会跳转到工作流编排的详细配置页面。
- 配置页面提供可视化的流程设计界面，用于搭建复杂的业务流程。
六、工作流配置界面详情
1. 配置界面布局
配置页面分为以下几个主要区域：
- 工具栏：包含保存、运行、导出等操作按钮
- 组件面板：左侧的可用节点和组件库
- 设计画布：中央的可视化流程设计区域
- 属性面板：右侧的节点属性配置区域
2. 基础节点类型
工作流编排支持多种节点类型：
- 开始节点：流程的起始点，用于定义输入变量
- LLM大模型节点：AI文本生成和处理节点
- 条件判断节点：基于条件的流程分支控制
- 结束节点：流程的结束点，用于定义输出结果
七、添加和配置节点
1. 添加新节点
- 在设计画布中右键点击空白区域，或点击工具栏的【+】按钮。
- 在弹出的节点菜单中选择需要添加的节点类型。
- 节点会自动添加到画布中，可通过拖拽调整位置。
2. 连接节点
- 将鼠标悬停在节点上，会显示连接点。
- 从源节点的输出点拖拽到目标节点的输入点。
- 连接线建立后，数据可以在节点间传递。
节点连接提示
- 连接方向从上到下，从左到右
- 确保逻辑流程的合理性
- 避免创建循环依赖
八、配置开始节点
1. 添加输入变量
- 选中开始节点，在右侧属性面板中配置输入变量。
- 点击【添加变量】按钮，为工作流定义输入参数。
- 为每个变量设置：
- 变量名：用于在后续节点中引用
- 显示名称：用户界面显示的友好名称
- 变量类型：文本、数字、选项等
- 是否必填：控制变量的必填属性
- 默认值：变量的默认取值
2. 变量说明和描述
- 为每个变量添加详细的说明信息。
- 说明信息会在用户使用时作为提示显示。
- 合理的变量说明有助于提高用户体验。
变量配置提示
- 变量名称要有意义且唯一
- 必填变量要确保业务逻辑必需
- 默认值有助于提升用户体验
九、配置LLM大模型节点
1. 添加LLM节点
- 在节点菜单中选择【LLM大模型】节点并添加到画布。
- 将开始节点连接到LLM节点，实现数据传递。
- LLM节点会自动继承前面节点的输出变量。
2. 配置模型和消息
在属性面板中选择合适的AI模型。
配置系统消息（System Message）：
- 定义AI的角色和行为规范
- 设置生成内容的格式要求
- 可以使用变量动态替换内容
配置用户消息（User Message）：
- 编写具体的任务指令
- 使用
{{变量名}}引用前面节点的输出 - 确保指令清晰明确
配置要点
- 系统消息用于设定AI角色，不要包含具体任务
- 用户消息包含具体指令和变量引用
- 变量引用格式必须正确：
- 选择合适的模型以获得最佳效果
十、配置结束节点
1. 设置输出结果
- 将LLM节点连接到结束节点。
- 在结束节点的属性面板中配置输出结果。
- 可以绑定前面任何节点的输出变量作为最终结果。
2. 变量绑定
- 选择要作为输出的变量。
- 可以绑定多个变量作为不同的输出字段。
- 为输出结果设置清晰的字段名称。
输出配置建议
- 输出字段名称要有意义
- 确保绑定的变量确实存在
- 考虑输出结果的使用场景
十一、保存和调试工作流
1. 保存配置
- 流程设计完成后，点击工具栏的【保存】按钮。
- 系统会验证流程的完整性和正确性。
- 保存成功后配置会持久化存储。
2. 运行调试
- 点击【运行】或【调试】按钮开始测试。
- 在弹出的测试界面中输入变量值。
- 观察流程执行过程和各节点的输出结果。
3. 调试操作演示
以下动图展示了完整的调试过程，包括输入变量、流程执行和结果查看：
调试技巧
- 先用简单的流程测试基础功能
- 逐步增加节点验证复杂逻辑
- 检查每个节点的输入输出是否正确
- 注意错误提示和异常处理
十二、高级功能
1. 条件分支
- 使用条件判断节点实现流程分支。
- 基于变量值或表达式进行条件判断。
- 支持多分支和嵌套条件逻辑。
2. 循环处理
- 通过节点连接实现循环处理逻辑。
- 设置循环条件和退出机制。
- 适用于批量数据处理场景。
3. 并行执行
- 多个分支可以并行执行。
- 使用聚合节点合并并行结果。
- 提高复杂流程的执行效率。
十三、应用发布与使用
1. 应用运行
- 配置完成后，点击【运行】按钮在新窗口中打开应用。
- 最终用户通过Web界面使用工作流功能。
- 应用会根据配置的变量提供相应的输入界面。
2. API集成
- 工作流应用支持API接口调用。
- 可以集成到其他系统或自动化流程中。
- 支持批量处理和定时执行。
3. 应用分享
- 可以将应用URL分享给团队成员使用。
- 支持权限控制和使用统计。
- 可以嵌入到业务系统中使用。
十四、最佳实践建议
1. 流程设计
- 清晰的逻辑：确保流程逻辑清晰易懂
- 模块化设计：将复杂流程拆分为独立模块
- 错误处理：添加适当的错误处理和异常分支
- 性能优化：避免不必要的复杂计算和长时间等待
2. 节点配置
- 变量命名：使用有意义的变量名称
- 参数验证：对输入参数进行合理验证
- 模型选择：根据任务需求选择合适的AI模型
- 提示词优化：编写清晰具体的AI指令
3. 测试验证
- 单元测试：逐个测试每个节点的功能
- 集成测试：验证整个流程的完整性
- 边界测试：测试异常输入和边界情况
- 性能测试：验证流程的执行效率和稳定性
4. 维护管理
- 版本控制：做好流程配置的版本管理
- 文档记录：记录流程设计思路和配置说明
- 监控告警：设置流程执行的监控和告警
- 持续优化：根据使用反馈持续改进流程