Run Agents
The Run Agents page is your command center for executing and monitoring agent runs.
Overview
Access Run Agents from the sidebar under Agents. This page shows all your agents with their current execution status and provides controls to run, stop, and manage the queue.
Agent Queue
UniSync uses a queue-based execution system:
- Queue — Click Run to add an agent to the queue
- Scheduler — The queue scheduler polls every 30 seconds
- Execute — Agents are picked from the queue and executed in order
- Complete — Results are logged and the agent returns to idle
Controls
Individual Agent Controls
- Run — Add agent to execution queue
- Stop — Cancel a running or queued agent
- Republish — Re-run the agent immediately (priority queue)
Bulk Controls
- Queue All — Add all configured agents to the queue
- Stop All — Cancel all running and queued agents
- AutoPilot — Open AutoPilot configuration for scheduled runs
Filtering
Filter agents by type using the dropdown:
| Filter | Shows |
|---|---|
| All | All agents |
| Production | Agents with campaign planner assignments |
| Quick Publisher | Agents with automation assignments |
| Unconfigured | Agents without assignments |
Agent Cards
Each card displays:
- Agent name and avatar
- Agent type badge (Production / Quick Publisher)
- Current status (Idle / Queued / Running / Error)
- Queue position (if queued)
- Last run time
- Posts published count
- Target environment
Run Options
When clicking Run, you can configure:
| Option | Description |
|---|---|
| Priority | Skip the queue and run immediately |
| One Shot | Run once without repeating |
| Deferred | Schedule for a specific time |
Monitoring
While an agent is running:
- Status updates in real-time on the card
- Progress indicators show current phase (for Production agents)
- Errors are displayed inline with troubleshooting links
Related
- Manage Agents — Configure agents
- AutoPilot — Automated scheduling
- Troubleshooting: Agent Errors — Fix common issues