Skip to main content

​
What it does

The Manage Scheduled Tasks tool lets agents run the full lifecycle of a recurring task on behalf of a user, mid-conversation. Instead of going to Control Hub, a user can say “send me a daily report at 9 AM” and the agent creates it — then later ask “what’s scheduled?”, “push that to 10 AM”, or “turn it off” and the agent handles those too. Tasks created this way run on the current agent, sending the stored prompt on the configured schedule.

​
Actions

The tool takes an action and the parameters that action needs. get returns each run’s link to its conversation, so the user can open a past report and follow up on it.

​
Parameters

​
Common use cases

​
Daily digest emails

“Send me a daily summary of new candidates in the knowledge base every evening at 6 PM” The agent calls create with a 0 18 * * * schedule and a prompt that searches the KB and emails the results.

​
Recurring reports

“Every Monday morning, pull last week’s sales data and email a summary to the team” A weekly task that queries databases and generates reports.

​
Reviewing what’s already scheduled

“What do I have running?” → list “Show me what the Monday report actually does and how the last few runs went” → get

​
Adjusting an existing task

“Move the daily digest to 7 AM” → update with a new schedule “Pause the ticket monitor while I’m out” → update with enabled: false

​
Best practices

  • Prompts must be self-contained: The agent only receives the prompt text on each run — no conversation history from when the task was created
  • Be specific in prompts: Include all context, recipients, formats, and conditions directly in the prompt
  • Include “no data” handling: Tell the agent what to do when there’s nothing to report (e.g., “If no new items, send a brief confirmation email”)
  • Pause rather than delete when a task is only temporarily unwanted — update with enabled: false keeps the prompt and history

​
Managing created tasks

Tasks created by this tool also appear in Control Hub → Scheduled Tasks where you can:
  • Edit the schedule or prompt
  • Enable/disable the task
  • View execution history
  • Run the task on demand
  • Delete the task
See Scheduled Tasks for full management details.
  • Send Email - Often used together — scheduled tasks generate reports and email them
  • Search Knowledge Base - Common in scheduled tasks that monitor for new documents
  • Call Agent - Scheduled tasks can trigger multi-agent workflows