Agent Scheduling: Automate Your Tasks
The Agent Scheduling feature allows you to automate repetitive tasks by scheduling your agents to execute specific prompts on a recurring basis. Whether you need a daily report, a weekly summary, or frequent monitoring, you can configure your agent to perform the task and deliver the results directly to you.
You schedule tasks by talking to your agent. Simply tell your agent what you want done and when.
Example: "Summarize the top 3 AI news articles and send them to me every morning at 8 AM."
How It Works
To use this feature, you'll interact with an agent that has the Schedule Task capability enabled. You provide the agent with two key pieces of information:
1. The Prompt
The specific instruction you want the agent to execute automatically
2. The Schedule
How often the task should run (e.g., daily, weekly, every 15 minutes)
The agent will then confirm the details with you before saving the schedule.
Managing Your Scheduled Tasks
As an agent owner, you can view, pause, and delete your scheduled tasks directly from the chat interface.
Task Management Features:
- ✓View Status: See all scheduled tasks by expanding the "Scheduled Tasks" section in the chat interface
- ✓Pause Tasks: Temporarily disable a task without deleting it using the pause toggle
- ✓Delete Tasks: Permanently remove a task by clicking the delete button
- ✓View Schedule Details: See the cron schedule and next run time for each task
Scheduling a Task
When you're ready to schedule a task, simply tell your agent what you want it to do and when.
The Prompt
The prompt for a scheduled task should be clear, specific, and self-contained. Because the task runs automatically, the agent cannot ask for clarification or follow-up questions.
Tips for Writing Effective Prompts:
- •Be Explicit: Instead of "Check the news," say "Summarize the top 3 articles from HackerNews about large language models."
- •Provide Context: If the task depends on previous information, ensure that information is accessible to the agent (e.g., through its memory) or included in the prompt.
- •Handle Failure: If a task fails, the agent will attempt to provide feedback on how to improve the prompt. Use this feedback to refine your scheduled tasks.
The Schedule (Cron Expressions)
The schedule is defined using a standard 5-field cron expression, representing: minute hour day-of-month month day-of-week
| Field | Allowed Values |
|---|---|
| Minute | 0-59 |
| Hour | 0-23 |
| Day of Month | 1-31 |
| Month | 1-12 |
| Day of Week | 0-6 (Sun-Sat) |
Common Examples:
*/15 * * * *- Every 15 minutes (Note: The minimum interval is 10 minutes)0 9 * * *- Every day at 9:00 AM0 17 * * 1-5- Every weekday (Monday to Friday) at 5:00 PM0 0 1 * *- At midnight on the first day of every month
Confirmation Flow
For interactive channels like the web chat or a voice call, the agent will always verify the details with you before finalizing the schedule. It will present a summary of the task, including the prompt, the schedule, and where the results will be sent. You must confirm this summary for the task to be scheduled.
Receiving Task Results (Output Targets)
The results of your scheduled tasks can be delivered to different targets depending on the platform you used to schedule them.
1. Email
If you are interacting with your agent through the web interface, the agent must ask for your email address to deliver the results. When prompted, please provide and spell out your email address clearly, especially during a voice conversation.
2. Telegram
- The deployment has an associated Telegram bot configured
- The scheduling was initiated through a Telegram chat conversation (not through the web interface)
If you have integrated your agent with Telegram and are scheduling a task from within a Telegram chat, the results will be sent back to that same chat by default. You can also choose to have the results sent to your email instead by simply asking the agent:
Important Considerations
- Autonomous Execution: Scheduled tasks run in the background without your direct involvement. Design your prompts for autonomous execution.
- Execution Limits: The execution of scheduled tasks counts towards your account's daily message limits, just like any other agent interaction.
- Minimum Interval: The minimum time between task executions is 10 minutes. Cron expressions for more frequent intervals will be rejected.
Common Use Cases
📊 Daily Reports
Schedule agents to compile and send daily reports on metrics, analytics, or key performance indicators.
📰 News Summaries
Get curated news summaries on specific topics delivered to your inbox every morning.
🔍 Monitoring & Alerts
Monitor specific conditions or data sources and receive alerts when certain thresholds are met.
📅 Weekly Summaries
Schedule weekly summaries of conversations, activities, or progress reports.