Scheduler (Public Preview)

Agentic workflow includes a built-in business scheduler. You can use it to schedule a agentic workflow or an agent to run at a later time. Many business scenarios require schedule execution. For example:

Example 1
Example 2
Example 3

TEXT

Schedule this Helpdesk monitoring agentic workflow to run every weekday at 7 AM.

TEXT

Run this monitoring tool every hour for the next 24 hours.

TEXT

Schedule the stock_analysis_agent to run every day at 7 AM UK time with the ticker symbol IBM.

Show supported features

Schedule repeated runs of agentic workflow and Agents using the agent_run tool at specific times, dates, and repetition limits.
Always specify a timezone when creating a schedule. If no timezone is provided, the system uses UTC by default.
Define time patterns using natural language, such as “every day at 7am UK time” or “every Saturday at 5pm PST.” The system automatically converts these phrases into the correct cron expressions.
To avoid schedule overruns, the system defaults to one repetition if none is specified. Each schedule allows up to 100 repetitions. This limit cannot be changed at the moment.
Only schedule agents or agentic workflow that can run without user interaction, since scheduled runs may occur when no user is available. User notifications are not yet supported.
Create multiple schedules for the same agentic workflow or agent as needed.
Use the i__get_flow_status_intrinsic_tool__ tool to check the status of a agentic workflow run.
Use the i__get_schedule_intrinsic_tool__ tool to view available schedules.
Use the i__delete_schedule_intrinsic_tool__ tool to remove a schedule.

Scheduling a agentic workflow

To make a agentic workflow schedulable, enable the schedulable option in the @flow decorator:

Python

@flow(
        name = "alert_helpdesk_flow",
        input_schema=Product,
        output_schema=Message,
        schedulable=True
    )

After enabling this option, you can schedule the agentic workflow using a natural language command like:

TEXT

I want to schedule a call to alert_helpdesk_floeryday at 7am EST for 3 days

Scheduling an agent

Agents aren’t directly schedulable. Instead, use the agent_run tool to schedule an agent with a request. First, add the tool to an agent. For more information, see agent_scheduler. The agent_run tool is a agentic workflow with a single agent node that calls the specified agent with a request. After adding the tool, schedule the agent like this:

TEXT

I want to schedule agent "<agent id>" to run every day at 9 AM.

Release Notes

Get Started

Build

Analyze

watsonx Orchestrate Developer Edition

watsonx Orchestrate ADK MCP Server

Reference

Legal notices

Scheduling a agentic workflow

Scheduling an agent

​Scheduling a agentic workflow

​Scheduling an agent

Scheduling a agentic workflow

Scheduling an agent