Task Lifecycle
Every piece of work agents do flows through the task system. Understand the task states you'll see in your dashboard.
What is a Task
A task is a discrete unit of work performed by an agent. Examples include:
- "Optimize meta description for /products page"
- "Create Google Ads search campaign for spring sale"
- "Run A/B test on homepage CTA button color"
- "Write blog post about industry trends"
- "Fix broken internal links found in audit"
Each task has a title, description, priority level, expected impact, and the agent responsible for execution.
Task States
Tasks move through a clear lifecycle:
Queued
The task has been created and is waiting to be processed. Most tasks move through this state quickly.
Awaiting Approval
The task is ready for your review. You can see exactly what the agent plans to do, review the details, and decide whether to approve, modify, or dismiss it.
This is the primary checkpoint for human oversight.
In Progress
The agent is actively working on the task. Depending on the complexity, this could take seconds (fixing a meta tag) or minutes (writing a long-form article).
Completed
The task has been successfully executed. You can review the deliverables — the content that was created, the changes that were made, or the campaign that was launched.
Failed
Something went wrong during execution. The agent provides error details and typically suggests a corrective action. Failed tasks can be retried after the issue is resolved.
Viewing Tasks
The Tasks page in the sidebar shows all tasks across all agents. You can filter by:
- Status — See only tasks awaiting approval, in progress, or completed
- Agent/Product — Filter to a specific agent's tasks
- Priority — Focus on high-impact tasks first
Task Details
Click any task to see its full details:
- What — What the agent is doing or plans to do
- Why — The reasoning behind this task
- Expected impact — What improvement to expect
- Deliverables — The output once completed (content, configurations, reports)
Bulk Actions
You can approve multiple tasks at once from the tasks list. This is useful when reviewing a batch of similar tasks, like approving all meta description updates from an audit.
Task History
All completed and failed tasks remain in your history, creating a full audit trail of everything agents have done on your behalf. This is useful for understanding what changed and when.