Task Management
The Tasks module in the console is used to manage and execute workflow tasks. This article covers how to use the task list page and the task editor (TaskStudio).
Access
Click Tasks in the console sidebar to navigate to the task management page (/tasks).
Task List
The task list page provides three tabs:
| Tab | Description |
|---|---|
| All Tasks | Displays all tasks within the team |
| My Tasks | Displays only tasks created by or assigned to the current user |
| Execution History | Displays execution records for all tasks |
Search and Filtering
A search box is available at the top of the task list. Enter keywords and press Enter to search.
Expand the filter panel to filter by the following criteria:
| Filter | Options |
|---|---|
| Type | All Types / Scheduled Task / Event-Triggered / Manual Task |
| Status | All Statuses / Active / Inactive |
| Priority | All Priorities / High / Medium / Low |
| Tags | Search by tag name |
| Start Date | Date picker |
| End Date | Date picker |
Sorting and Views
Sort by Name or Creation Time, with ascending/descending toggle support.
View modes support List View and Grid View, with preferences saved automatically.
Task Information
Each task in list view displays the following information:
- Task name (with description and tags)
- Type (Scheduled Task / Event-Triggered / Manual Task)
- Status (Active / Inactive)
- Assignee
- Creation time
- Last run time
- Next run time
Actions
Each task provides the following actions:
| Action | Description |
|---|---|
| Run Now | Run the task (opens the run page in a new window) |
| View Details | Open the task details drawer on the right |
| Configure | Navigate to the task editor |
Creating a Task
Click the "Create Task" button in the upper-right corner of the page to open the creation dialog. You can also open it directly via the URL parameter ?create=true.
Basic Information
- Task Name (required)
- Task Description
- Task Type — Select one of the following:
- Scheduled Task — Executes on a schedule defined by a Cron expression
- Event-Triggered — Executes via Webhook triggers
- Manual Task — Executes via manual trigger
- Priority — High / Medium / Low
- Status — Active / Inactive
- Tags — Comma-separated
Schedule Configuration (Scheduled Tasks only)
- Cron Expression — Supports a visual builder for assisted configuration
- Start Date (required)
- End Date (optional)
Webhook Configuration (Event-Triggered only)
- Webhook URL — Automatically generated by the system, read-only
- Secret Token — Optional security verification token
Advanced Configuration
- Execution Configuration — Timeout (seconds), CPU limit, memory limit
- Error Handling — Max retries, retry interval, retry strategy (fixed / exponential backoff), failure action (retry / notify only), enable failure notifications
- Monitoring Configuration — Enable detailed logging
Task Editor (TaskStudio)
Click "Configure" in the task list, or enter the task editor after creating a task (/tasks/edit/:taskId).
The task editor is a visual workflow design tool that uses a flowchart approach to design task execution flows.
Interface Layout
Top Toolbar
The following features are available from left to right:
| Button | Description |
|---|---|
| Back | Return to the task list |
| Task Name | Displays the current task name |
| Delete | Delete the current task |
| Select Workflow | Load a saved workflow |
| Export | Export the workflow as a JSON file |
| Import | Import a workflow from a JSON file |
| Environment Variables | Manage task environment variables and ConfigMap bindings |
| Configure | Edit task properties (opens the create/edit dialog) |
| Run Now | Run the current task (must be saved first) |
| Save Changes | Save the current design |
Canvas Area
The canvas is the core area for flow design:
- Grid Background — Provides alignment reference lines
- Zoom and Pan — Supports zooming and drag-to-pan on the canvas
- Drag and Drop — Drag components from the left node library onto the canvas
- Connections — Drag from node ports to create connection lines, with type compatibility validation
- Empty Canvas Prompt — Displays an "Add your first step..." guide button when blank
Left Node Library
Click the left panel or use the shortcut Ctrl + K to open the node library, organized by the following categories:
| Category | Description |
|---|---|
| Agents | Task-type agents |
| Components | Active tool components |
| Datasets | Dataset operations |
| Data Sources | Active data sources |
| Control Flow | Conditional, loop, and other control nodes |
The node library supports search (by name, description, category). Use the / key to quickly focus the search box.
Right Configuration Panel
Click a node on the canvas, or use the shortcut Ctrl + I to open the configuration panel. Configure node input/output ports, default input values, data path mappings, and merge strategies here.
Bottom Debug Panel
The bottom toolbar displays statistics for nodes and connections, as well as connection line style toggles.
Expand the debug panel to view:
- Real-time output of run logs (via SSE connection)
- Task execution replay
Node Types
| Node Type | Description |
|---|---|
| Agent Node | Invokes a task-type agent |
| Tool Node | Invokes a tool component |
| Control Flow Node | Conditional, loop, and other flow control |
| Dataset Node | Operates on datasets |
| Data Source Node | Queries data sources |
Connection Line Styles
The canvas supports four connection line styles, switchable from the bottom toolbar:
- Default (Bezier curve)
- Straight
- Step
- Smooth step
Connection line colors change based on state: gray for normal connections, blue for selected/hovered, yellow dashed for control flow connections, and red for type mismatches.
Running a Task
Running from the Editor
- Click "Run Now" in the top toolbar
- If there are unsaved changes, the system will prompt you to save first
- A parameter input dialog appears — fill in the required input parameters
- Click "Submit Task" to start execution
- The currently executing node is highlighted on the canvas
- The bottom debug panel displays real-time execution logs
Running from the List
Click the "Run" button on a task in the task list to open the run page in a new window.
Execution History
View execution records for all tasks in the "Execution History" tab of the task list.
Filter Criteria
- Task name (dropdown selection)
- Status (Pending / Running / Completed / Failed / Cancelled)
- Start time range
- End time range
Execution Statuses
| Status | Description |
|---|---|
| Pending | Task has been submitted and is awaiting execution |
| Running | Task is currently running |
| Completed | Task completed successfully |
| Failed | Task execution failed |
| Cancelled | Task was cancelled |
| Retrying | Task is being retried after a failure |
Actions
Different actions are available depending on the execution status:
| Execution Status | Available Actions |
|---|---|
| Pending | Cancel execution, Re-execute |
| Running | Terminate execution |
| Completed / Failed / Cancelled | Re-execute |
For all statuses, you can click "View Details" to see basic execution information, log file contents, and error messages.
Related Documentation
- Workflow Overview — Workflow engine concepts and design
- Workflow Builder — Detailed workflow node documentation
- Trigger Configuration — Scheduled, event, and manual triggers
- Environment Variables — Environment variable management