← back to examples
production beginner

Schedule Directive Agent

Focused example for delayed scheduling, bounded retries, and CRON-based recurring signals.

scheduling directives cron coordination l1

Related guides and notebooks

Concept
Directives
Understand Schedule and other directive types.
Guide
Build your first workflow
Compose multi-step control flow with signals.
Livebook
Build your first workflow
Run the companion notebook in Livebook
Explanation

What this example teaches

Interactive Demo

Run the agent and inspect state

Source Code

Read the production implementation

schedule_directive_agent.ex start_timer_action.ex start_retry_action.ex handle_retry_action.ex schedule_directive_agent_live.ex
lib/agent_jido/demos/schedule_directive/actions/start_retry_action.ex 32 lines 
defmodule AgentJido.Demos.ScheduleDirective.StartRetryAction do
  @moduledoc """
  Starts bounded retry scheduling.
  """

  alias Jido.Agent.Directive
  alias Jido.Signal

  use Jido.Action,
    name: "start_retry",
    description: "Starts bounded retry loop",
    schema: [
      max_attempts: [type: :integer, default: 3],
      retry_delay_ms: [type: :integer, default: 80]
    ]

  @impl true
  def run(%{max_attempts: max_attempts, retry_delay_ms: retry_delay_ms}, _context) do
    retry_signal = Signal.new!("retry.attempt", %{}, source: "/schedule")
    schedule = %Directive.Schedule{delay_ms: retry_delay_ms, message: retry_signal}

    {:ok,
     %{
       status: :retrying,
       attempts: 0,
       max_attempts: max_attempts,
       retry_delay_ms: retry_delay_ms,
       last_event: "retry.started"
     }, schedule}
  end
end