Admin Dashboard: Tasks
Tasks are durable units of work. The current record carries interactive or background mode, priority, acceptance criteria, dependencies, subtasks, result, error, and lifecycle timestamps.
States and sources
Section titled “States and sources”Tasks use draft, approved, pending, in_progress, needs_input, completed, failed, and cancelled. Terminal states are completed, failed, and cancelled. You may also see an escalated filter for imported or historical records, but current task actions cannot move a task into that state.
The page shows source and agent filters, including agent, cron, webhook, api, and dashboard. Current tasks do not retain assignment or source, so those two filters do not narrow the results and the corresponding detail fields are empty. Use the session, audit, and tool-call views when you need attribution.
Create and run a task
Section titled “Create and run a task”- Open Tasks and choose New Task.
- Set title, agent, description, acceptance criteria, mode, and priority.
- Approve a draft, or start an approved/pending task.
- Add subtasks or adjust priority while the task is active.
- Complete with an optional result, fail with a reason, or cancel.
The expected result is a persisted task whose state, result, timestamps, and subtasks remain inspectable. The list and open detail refresh every five seconds while the browser tab is visible.
Human input and cancellation
Section titled “Human input and cancellation”An agent can move an in-progress task to needs_input through manage_tasks. If the work has an interactive session and a pending interrupt, answer it through that session’s interrupt workflow; the agent can then return the task to in_progress. A background task cannot wait for a person and fails if it reaches needs_input.
Cancelling a parent also cancels its non-terminal subtasks. Review the displayed cascade count before confirming.
Troubleshooting
Section titled “Troubleshooting”Filter by state, open the detail panel, and inspect Error, Blocked by, and Subtasks. Use Tool Call Log for execution failures and the schema chat stream for a corresponding interrupt event. The visible agent and source filters do not currently narrow the list.