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. TelegramAll Tiers
Telegram can be used as an output target for scheduled tasks on all tiers. Your agent must have a Telegram bot connected, and you need to complete a one-time verification to link the chat.
Telegram Verification Setup:
- Ensure your agent has a Telegram bot connected (see Telegram Integration Guide)
- When configuring the scheduled task output, select Telegram as the destination
- Click "Generate Verification Code" to receive a unique code
- Open the Telegram bot connected to your agent and send the code as a message
- Once verified, the scheduled task results will be delivered to that Telegram chat
- From Telegram chat: Results are sent back to the same chat by default. You can also ask the agent to send results to your email instead.
- From web interface: You can select Telegram as an output destination and complete the verification code flow to link a Telegram chat.
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.