任务管理
控制台的 任务 模块用于管理和执行工作流任务。本文介绍任务列表页面和任务编辑器(TaskStudio)的使用方法。
访问入口
在控制台侧边栏点击 任务 进入任务管理页面(/tasks)。
任务列表
任务列表页面提供三个标签页:
| 标签页 | 说明 |
|---|---|
| 全部任务 | 显示团队内所有任务 |
| 我的任务 | 仅显示当前用户创建或负责的任务 |
| 执行历史 | 显示所有任务的执行记录 |
搜索与筛选
任务列表顶部提供搜索框,输入关键词按回车搜索。
展开筛选面板可按以下条件过滤:
| 筛选项 | 选项 |
|---|---|
| 类型 | 全部类型 / 计划任务 / 事件触发 / 手动任务 |
| 状态 | 全部状态 / 活跃 / 不活跃 |
| 优先级 | 全部优先级 / 高 / 中 / 低 |
| 标签 | 输入标签名搜索 |
| 开始日期 | 日期选择 |
| 结束日期 | 日期选择 |
排序与视图
支持按 名称 或 创建时间 排序,可切换升序/降序。
视图模式支持 列表视图 和 网格视图,偏好自动保存。
任务信息
列表视图中每个任务显示以下信息:
- 任务名称(含描述和标签)
- 类型(计划任务/事件触发/手动任务)
- 状态(活跃/不活跃)
- 负责人
- 创建时间
- 上次运行时间
- 下次运行时间
操作
每个任务提供以下操作:
| 操作 | 说明 |
|---|---|
| 立即运行 | 运行任务(在新窗口打开运行页面) |
| 查看详情 | 打开右侧任务详情抽屉 |
| 配置 | 跳转到任务编辑器 |
创建任务
点击页面右上角的「创建任务」按钮打开创建弹窗。也可通过 URL 参数 ?create=true 直接打开。
基本信息
- 任务名称(必填)
- 任务描述
- 任务类型 — 选择以下类型之一:
- 计划任务 — 按 Cron 表达式定时执行
- 事件触发 — 通过 Webhook 触发执行
- 手动任务 — 手动触发执行
- 优先级 — 高 / 中 / 低
- 状态 — 活跃 / 不活跃
- 标签 — 以逗号分隔
计划配置(仅计划任务)
- Cron 表达式 — 支持可视化构建器辅助设置
- 开始日期(必填)
- 结束日期(可选)
Webhook 配置(仅事件触发)
- Webhook URL — 系统自动生成,只读
- 密钥令牌 — 可选的安全验证令牌
高级配置
- 执行配置 — 超时时间(秒)、CPU 限制、内存限制
- 错误处理 — 最大重试次数、重试间隔、重试策略(固定/指数退避)、失败动作(重试/仅通知)、启用失败通知
- 监控配置 — 启用详细日志
任务编辑器(TaskStudio)
在任务列表中点击「配置」,或在创建任务后进入任务编辑器(/tasks/edit/:taskId)。
任务编辑器是可视化工作流设计工具,基于流程图方式设计任务的执行流程。
界面布局
顶部工具栏
从左到右提供以下功能:
| 按钮 | 说明 |
|---|---|
| 返回 | 返回任务列表 |
| 任务名称 | 显示当前任务名称 |
| 删除 | 删除当前任务 |
| 选择工作流 | 加载已保存的工作流 |
| 导出 | 导出工作流为 JSON 文件 |
| 导入 | 从 JSON 文件导入工作流 |
| 环境变量 | 管理任务的环境变量和配置映射绑定 |
| 配置 | 编辑任务属性(打开创建/编辑弹窗) |
| 立即运行 | 运行当前任务(需先保存) |
| 保存修改 | 保存当前设计 |
画布区域
画布是流程设计的核心区域:
- 网格背景 — 提供对齐参考线
- 缩放与平移 — 支持缩放和拖拽平移画布
- 拖拽放置 — 从左侧节点库拖拽组件到画布
- 连线 — 从节点端口拖拽创建连接线,支持类型兼容性验证
- 空画布提示 — 空白时显示「添加第一步...」引导按钮
左侧节点库
点击左侧面板或使用快捷键 Ctrl + K 打开节点库,按以下分类组织:
| 分类 | 说明 |
|---|---|
| 智能体 | 任务型智能体 |
| 组件 | 活跃状态的工具组件 |
| 数据集 | 数据集操作 |
| 数据源 | 活跃状态的数据源 |
| 控制流 | 条件判断、循环等控制节点 |
节点库支持搜索(按名称、描述、分类),使用 / 键快速聚焦搜索框。
右侧配置面板
点击画布中的节点,或使用快捷键 Ctrl + I 打开配置面板。在此配置节点的输入/输出端口、默认输入值、数据路径映射和合并策略等参数。
底部调试面板
底部工具栏显示节点和连接的统计信息,以及连线样式切换。
展开调试面板可查看:
- 运行日志的实时输出(通过 SSE 连接)
- 任务执行回放
节点类型
| 节点类型 | 说明 |
|---|---|
| 智能体节点 | 调用任务型智能体 |
| 工具节点 | 调用工具组件 |
| 控制流节点 | 条件判断、循环等流程控制 |
| 数据集节点 | 操作数据集 |
| 数据源节点 | 查询数据源 |
连线样式
画布支持四种连线样式,可在底部工具栏切换:
- 默认(贝塞尔曲线)
- 直线
- 阶梯线
- 平滑阶梯线
连线颜色根据状态变化:灰色为正常连接,蓝色为选中/悬停,黄色虚线为控制流连接,红色表示类型不匹配。
运行任务
从编辑器运行
- 点击顶部工具栏的「立即运行」
- 若有未保存更改,系统会提示先保存
- 弹出参数输入弹窗,填写任务所需的输入参数
- 点击「提交任务」开始执行
- 画布上高亮显示当前正在执行的节点
- 底部调试面板显示实时执行日志
从列表运行
在任务列表中点击任务的「运行」按钮,在新窗口打开运行页面。
执行历史
在任务列表的「执行历史」标签页中查看所有任务的执行记录。
筛选条件
- 任务名称(下拉选择)
- 状态(等待中/执行中/已完成/失败/已取消)
- 开始时间范围
- 结束时间范围
执行状态
| 状态 | 说明 |
|---|---|
| 等待中 | 任务已提交,等待执行 |
| 执行中 | 任务正在运行 |
| 已完成 | 任务成功完成 |
| 失败 | 任务执行失败 |
| 已取消 | 任务被取消 |
| 重试中 | 任务失败后正在重试 |
操作
根据执行状态,可执行不同操作:
| 执行状态 | 可用操作 |
|---|---|
| 等待中 | 取消执行、重新执行 |
| 执行中 | 终止执行 |
| 已完成/失败/已取消 | 重新执行 |
所有状态均可点击「查看详情」,查看执行的基本信息、日志文件内容和错误信息。