跳到主要内容

流程管理

当数据量大、处理流程重复时，手动操作既耗时又容易出错。

典型场景:

  • 新上传的 MCAP 文件需要自动预处理
  • 特定项目的数据需要自动创建标注任务
  • 已完成标注的数据需要自动进行质量检查
  • 需要将 HDF5 格式自动转换为 MCAP 格式

流程管理功能就是为了解决这些问题而设计的。通过配置匹配规则和动作规则，可以自动执行数据处理、标注分配、质量检查等操作，提高效率，减少人工干预。

核心概念​

匹配规则​

定义数据匹配条件，用于识别需要处理的数据集。

规则类型:

  • 按项目匹配:匹配特定项目的数据
  • 按标签匹配:匹配带有特定标签的数据
  • 按机器人类型匹配:匹配特定机器人采集的数据
  • 按数据格式匹配:匹配特定格式的数据(如 MCAP、HDF5)
  • 按状态匹配:匹配特定状态的数据(如未标注、已标注)

规则配置:

  • 规则名称和描述
  • 匹配条件(AND/OR 逻辑)
  • 规则优先级
  • 规则启用状态

动作规则​

定义对匹配数据执行的操作。

操作类型:

  • 数据预处理:自动重命名、格式转换等
  • 自动标注分配:自动创建标注任务并分配
  • 质量检查:自动执行质量检查
  • 标签添加:自动添加标签
  • 项目分配:自动分配到项目
  • 格式转换:HDF5 → MCAP、LeRobot → MCAP 等

规则配置:

  • 规则名称和描述
  • 执行动作
  • 动作参数
  • 规则优先级

工作流​

将匹配规则和动作规则组合成完整的工作流。

工作流结构:

  • 工作流名称和描述
  • 关联的匹配规则
  • 关联的动作规则
  • 工作流优先级
  • 工作流启用状态

执行流程:

  1. 数据进入系统或状态变更
  2. 工作流引擎检查匹配规则
  3. 如果匹配，执行关联的动作规则
  4. 记录执行日志

快速上手:创建第一个工作流​

第 1 步:创建匹配规则​

  1. 进入流程管理页面，切换到"匹配规则"标签页
  2. 点击"新建匹配规则"
  3. 填写规则信息:
    • 规则名称:清晰描述匹配条件(如"新上传的 MCAP 文件")
    • 规则描述:补充说明(可选)
  4. 配置匹配条件:
    • 选择匹配字段(项目、标签、格式等)
    • 设置匹配值
    • 可以添加多个条件，使用 AND/OR 逻辑组合
  5. 设置优先级和启用状态
  6. 保存规则

第 2 步:创建动作规则​

  1. 切换到"动作规则"标签页
  2. 点击"新建动作规则"
  3. 填写规则信息:
    • 规则名称:清晰描述执行的操作(如"自动预处理")
    • 规则描述:补充说明(可选)
  4. 配置执行动作:
    • 选择动作类型(数据预处理、格式转换等)
    • 配置动作参数
    • 可以添加多个动作步骤
  5. 设置优先级和启用状态
  6. 保存规则

第 3 步:创建工作流​

  1. 切换到"工作流"标签页
  2. 点击"新建工作流"
  3. 填写工作流信息:
    • 工作流名称:清晰描述工作流用途(如"MCAP 文件自动预处理")
    • 工作流描述:补充说明(可选)
    • 项目范围:选择全局或特定项目
  4. 选择规则:
    • 选择匹配规则
    • 选择动作规则
  5. 设置优先级和启用状态
  6. 保存工作流

工作流创建后，系统会自动监控数据状态，当数据匹配规则时自动执行工作流。

进阶使用​

如何配置复杂的匹配条件?​

多条件组合:

匹配规则支持多个条件的组合:

  • AND 逻辑:所有条件都必须满足

    • 例如:项目 = "项目A" AND 格式 = "MCAP" AND 状态 = "未标注"

  • OR 逻辑:任一条件满足即可

    • 例如:标签 = "高质量" OR 标签 = "测试数据"

条件类型:

  • 项目匹配:匹配特定项目的数据
  • 标签匹配:匹配带有特定标签的数据
  • 机器人类型匹配:匹配特定机器人采集的数据
  • 数据格式匹配:匹配特定格式的数据
  • 状态匹配:匹配特定状态的数据

如何配置多个动作步骤?​

动作步骤:

动作规则可以包含多个步骤，按顺序执行:

  1. 自动重命名:根据规则重命名数据集
  2. 格式转换:将数据转换为标准格式
  3. 自动导入项目:将数据导入到指定项目
  4. 运行自定义算法:执行自定义处理算法

步骤配置:

每个步骤可以配置独立的参数:

  • 重命名规则:设置命名模式和目标格式
  • 转换参数:设置转换选项和参数
  • 项目选择:选择目标项目

如何设置工作流优先级?​

优先级说明:

  • 数字越小，优先级越高
  • 多个工作流匹配时，按优先级顺序执行
  • 高优先级工作流先执行

设置建议:

  • 重要的工作流设置较高优先级(如 1-10)
  • 一般工作流设置中等优先级(如 11-50)
  • 可选工作流设置较低优先级(如 51-100)

如何测试工作流?​

规则测试:

创建规则后，可以测试规则是否正确:

  1. 在规则列表中点击"测试"
  2. 系统会显示匹配的数据集列表
  3. 确认匹配结果是否符合预期

工作流测试:

  1. 创建工作流后，可以先禁用
  2. 手动触发测试，查看执行结果
  3. 确认无误后启用工作流

使用场景​

场景一:自动数据预处理​

需求:新上传的 MCAP 文件需要自动预处理。

配置步骤:

  1. 创建匹配规则:匹配新上传的 MCAP 文件
    • 条件:格式 = "MCAP" AND 状态 = "新上传"
  2. 创建动作规则:执行数据预处理操作
    • 动作:数据预处理
  3. 创建工作流:将匹配规则和动作规则关联
  4. 启用工作流:新上传的 MCAP 文件自动触发预处理

场景二:自动标注分配​

需求:特定项目且未标注的数据需要自动创建标注任务。

配置步骤:

  1. 创建匹配规则:匹配特定项目且未标注的数据
    • 条件:项目 = "项目A" AND 状态 = "未标注"
  2. 创建动作规则:自动创建标注任务并分配给标注员
    • 动作:自动标注分配
    • 参数:指定标注员和审核员
  3. 创建工作流:将匹配规则和动作规则关联
  4. 启用工作流:符合条件的数据自动创建标注任务

场景三:自动格式转换​

需求:HDF5 格式的数据需要自动转换为 MCAP 格式。

配置步骤:

  1. 创建匹配规则:匹配 HDF5 格式的数据
    • 条件:格式 = "HDF5"
  2. 创建动作规则:执行格式转换
    • 动作:HDF5 → MCAP 转换
    • 参数:选择机器人类型(Agilex、Realman 等)
  3. 创建工作流:将匹配规则和动作规则关联
  4. 启用工作流:HDF5 数据自动转换为 MCAP

工作流管理​

如何查看工作流执行情况?​

执行日志:

在流程管理页面可以查看:

  • 执行时间
  • 工作流名称
  • 匹配的数据集
  • 执行的动作
  • 执行结果(成功/失败)
  • 错误信息(如失败)

查询功能:

  • 按工作流筛选
  • 按时间范围筛选
  • 按执行状态筛选
  • 查看执行详情

如何管理工作流?​

工作流操作:

  • 启用/禁用:控制工作流是否执行
  • 编辑:修改工作流配置
  • 删除:删除不需要的工作流
  • 复制:基于现有工作流创建新工作流

工作流列表:

  • 显示所有工作流的列表
  • 显示工作流范围(项目或全局)
  • 显示启用状态和优先级
  • 显示创建和更新时间

常见问题​

工作流不执行怎么办?​

可能原因:

  1. 工作流未启用:检查工作流是否已启用
  2. 匹配规则不匹配:检查匹配规则是否正确
  3. 优先级过低:其他高优先级工作流先执行
  4. 动作规则错误:检查动作规则配置是否正确

解决方法:

  1. 检查工作流启用状态
  2. 测试匹配规则，确认能正确匹配数据
  3. 查看执行日志，了解失败原因
  4. 调整工作流优先级

如何避免工作流冲突?​

冲突场景:

  • 多个工作流匹配同一数据
  • 工作流执行顺序不确定
  • 动作规则相互影响

解决方法:

  1. 设置优先级:为工作流设置明确的优先级
  2. 细化匹配条件:使用更精确的匹配条件，避免重叠
  3. 测试验证:创建后先测试，确认无冲突

工作流执行失败怎么办?​

处理步骤:

  1. 查看执行日志，了解失败原因
  2. 检查动作规则配置是否正确
  3. 检查数据是否符合要求
  4. 修复问题后重新执行

常见错误:

  • 数据格式不符合要求
  • 动作参数配置错误
  • 系统资源不足
  • 网络或存储问题

适用角色​

管理员​

你可以:

  • 创建和管理所有工作流
  • 配置匹配规则和动作规则
  • 监控工作流执行情况
  • 优化工作流性能
  • 处理工作流异常

项目经理​

你可以:

  • 为项目创建专用工作流
  • 配置项目特定的自动化规则
  • 监控项目工作流执行情况
  • 优化项目数据处理流程

相关功能​

完成流程管理后，你可能还需要: