Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dify.com.br/llms.txt

Use this file to discover all available pages before exploring further.

The Scheduler lets you set up recurring tasks that agents execute automatically. Create daily reports, weekly analyses, periodic checks, and any automated workflow.

​
How Scheduling Works

Scheduled tasks use CRON expressions powered by BullMQ. When a schedule triggers:
  1. The system creates a new conversation thread
  2. The assigned agent receives the task prompt
  3. The agent executes using its configured tools and knowledge
  4. Results are saved and optionally sent to connected services

​
Creating a Schedule

You can create schedules directly in conversation:
“Schedule a weekly market analysis report every Monday at 9am”
Or through the Scheduler interface:
1

Open Scheduler

Navigate to the Scheduler section in the sidebar.
2

Create new schedule

Click New Schedule and configure:
​
prompt
string
required
The task instruction the agent will execute each time.
​
schedule
string
required
CRON expression (e.g., 0 9 * * 1 for every Monday at 9am).
​
agent
string
required
Which agent should execute this task.
3

Review and activate

Review the schedule preview and click Activate.

​
Common CRON Patterns

PatternSchedule
0 9 * * *Every day at 9:00 AM
0 9 * * 1Every Monday at 9:00 AM
0 */6 * * *Every 6 hours
0 9 1 * *First day of every month at 9:00 AM
0 9 * * 1-5Weekdays at 9:00 AM

​
Managing Schedules

  • Pause a schedule without deleting it
  • Edit the prompt, timing, or assigned agent
  • View history of past executions and results
  • Delete schedules you no longer need

​
Execution History

Each execution is logged with:
  • Timestamp and duration
  • Agent response and artifacts
  • Status (success, error, timeout)
Start with simple schedules and iterate. You can modify the prompt and timing at any time.