Enabling scheduling for agentic workflows and agents

Enable scheduling for your agentic workflows and agents to create automated schedules through the Chat UI.

Enabling scheduling for agentic workflows

To enable scheduling in agentic workflows, set schedulable=True in the @flow decorator:

from ibm_watsonx_orchestrate.flow_builder.flows import flow

@flow(
    name="daily_report_flow",
    schedulable=True  # Enable scheduling
)
def my_workflow():
    # Agentic workflow logic
    pass

Configuring scheduling permissions

Use the schedulable_by_role parameter in the @flow decorator to control which roles can create schedules for an agentic workflow.

Value	Who can create schedules
`"user"`	Admins, builders, and end-users (default)
`"builder"`	Admins and builders only
`"admin"`	Admins only

The following example restricts scheduling to builders and admins:

@flow(
    name="my_flow",
    schedulable=True,
    schedulable_by_role="builder"
)

Note:schedulable_by_role controls who can create schedules. Regardless of this setting, each user can only view, modify, and delete their own schedules. Admins can always view, modify, and delete all schedules.

Enabling scheduling for agents

To enable scheduling in agents, enable scheduling when creating the agent:

from ibm_watsonx_orchestrate.agent_builder.agents import Agent

my_agent = Agent(
    name="monitoring_agent",
    is_schedulable=True,  # Enable scheduling
    # other agent configuration...
)

spec_version: v1
kind: native
name: monitoring_agent
is_schedulable: true  # Enable scheduling
# other agent configuration...

{
    "spec_version": "v1",
    "kind": "native",
    "name": "monitoring_agent",
    "is_schedulable": true,
    "description": "Agent description",
    "instructions": "Agent instructions"
}

Scheduling is disabled by default for all agents. Enable it manually if you want to use it.

Creating schedules through Chat UI

After you enable scheduling, create and manage schedules through natural language in the Chat UI: Create a schedule:

Schedule daily_report_flow to run every Monday at 9 AM EST

View schedules:

Show my schedules

Update a schedule:

Change the daily report to run at 10 AM instead

Delete a schedule:

Delete the monitoring schedule

You receive interactive forms that guide you through schedule configuration. For more information, see Scheduling tasks.

Release Notes

Get Started

Build

Deploy

Analyze

Developer experience

Legal notices

Enabling scheduling for agentic workflows and agents