Queue

Manage your agent's task queue — add items manually, from emails, or from other agents, and process them on schedule.

Tip: The queue is managed through the UI and automated via schedules. Your agent processes queue items automatically when a schedule is enabled — you can also click Process on any item to start it manually.

Overview

The Queue is a prioritized task list that agents process sequentially. Each agent has its own queue where items wait to be handled. The queue is the foundation of autonomous agent operation — it's how agents know what to work on next.

How Items Enter the Queue

Items can be added to the queue from several sources:

SourceHow It Works
ManualAdd items directly through the Queue tab UI
EmailWhen auto-queue is enabled, incoming emails become queue items automatically
Scheduled JobsTime-based triggers inject prompts into the queue at configured times — see Schedule
Other agentsAn agent sends an email to this agent → auto-queued for processing

Adding Items Manually

  1. Open the Queue tab (accessible from the agent page or sidebar)
  2. Click Add Item
  3. Enter a description of the task
  4. The item appears at the bottom of the queue

From Email

When Auto-Queue Incoming Emails is enabled in the Mail settings:

  1. An email arrives at the agent's address
  2. The email is automatically added as a queue item
  3. The item includes the email subject, sender, and content
  4. On the next processing run, the agent reads the email and acts on it

The Queue Interface

The Queue tab shows all pending and completed items:

Drag-and-Drop Ordering

Drag items to reorder them. The agent processes items from top to bottom, so reordering lets you prioritize what gets handled first.

Bulk Actions

Select multiple items for bulk operations:

  • Delete selected — Remove items from the queue
  • Show/Hide completed — Toggle visibility of processed items

How Processing Works

Queue processing can be triggered two ways:

Manual Processing

Click the Process button on a queue item to start processing it immediately. The agent:

  1. Takes the top item from the queue
  2. Creates a dedicated chat session for the task
  3. Reads the item content and acts on it using all available tools
  4. Marks the item as completed
  5. Moves to the next item

Auto Processing

When auto processing is configured, the system automatically processes the queue at regular intervals:

  1. The cron system triggers at the scheduled time
  2. A sandbox is provisioned automatically (no human needed)
  3. The agent processes items sequentially — up to the configured maximum per run
  4. Each item gets its own chat session for full traceability
  5. After processing, the sandbox stays warm for the next run

Processing Limits

You can configure the maximum number of items per run in the queue settings. This prevents a single run from consuming too many resources if the queue has hundreds of items.

Each item also has a time budget — if processing takes too long, the agent gracefully wraps up the current item and moves on.

Queue Settings

Access queue settings to configure processing behavior:

SettingWhat It Controls
Schedule intervalHow often the agent automatically processes (5 min to 24 hours)
Max items per runMaximum queue items to process in a single scheduled run
Auto-queue emailsWhether incoming emails are added to the queue automatically
Processing orderItems are processed top-to-bottom (drag to reorder)

Auto Processing Interval

The interval determines how often the agent automatically wakes up and processes its queue:

  • Every 5 minutes — Near real-time processing
  • Every 15 minutes — Good balance of responsiveness and efficiency
  • Every hour — For batch-style processing
  • Every 24 hours — Daily digest/report agents
  • Custom intervals — Set any interval that fits your workflow

When auto processing is disabled, items accumulate in the queue until you manually trigger processing.

Queue Item Lifecycle

Added (manual / email / agent)
  → Pending (waiting in queue)
    → Processing (agent is working on it)
      → Completed ✓

Completed items remain visible (toggle with Show/Hide) so you can review what was processed and when.

Tips & Best Practices

  • Use the queue for repeatable work — Anything the agent does regularly (process emails, generate reports, check data) should flow through the queue
  • Prioritize with drag-and-drop — Put urgent items at the top
  • Combine with auto-queue — Email + auto-queue + schedule = fully autonomous task processing
  • Set reasonable limits — Configure max items per run to prevent resource exhaustion on large queues
  • Review completed items — Check the processed items periodically to ensure quality
  • Clean up regularly — Delete completed items you've reviewed to keep the queue manageable

What's Next?

  • Schedule — Create time-based triggers that inject prompts into the queue
  • Runs & Scheduling — Understand run types, status tracking, and scheduling details
  • Mail — Configure the email integration that feeds the queue
  • Agent Settings — Configure sandbox resolution, timeout, and other settings

Previous

Channels

Next

Scheduler