Scheduled agents

Not every agent waits to be messaged. A scheduled agent has a goal and runs on its own — on a schedule or on demand — using its tools and knowledge to do work and report back.

The agent type

A scheduled agent is a bot with bot_type set to agent (versus chatbot). Instead of replying to incoming messages, it pursues an agent goal when it runs.

What you configure

• Goal (agent_goal) — what the agent should accomplish on each run.
• Schedule (schedule) — when it runs; the editor previews the upcoming run times, and next_run_at / last_run_at track its cadence.
• Iteration budget (max_iterations) and a per-run timeout (timeout_seconds) — bounds on how long and how hard it works.
• Output (output_config) — where its result goes (for example, email or a webhook tool).

These are fields on the bot — set them in the editor or via the Bots API.

Runs & results

Each run executes as a conversation you can read and trace, so you can see exactly what the agent did — the steps it took and the tools it called. Trigger a run on its schedule, or kick one off on demand from the dashboard.