core intermediate

Demand Tracker Agent

A Jido agent that tracks listing demand with boost/cool/decay actions. Demonstrates Directives — the agent's mechanism for requesting side effects like emitting domain events (Emit) and scheduling future signals (Schedule).

directives emit schedule signals state

Related guides and notebooks

Guide

Your first agent

Define typed state and run your first command.

Livebook

Your first agent

Run the companion notebook in Livebook

Concept

Actions

Understand action contracts, validation, and composition.

Build your first workflow

Chain actions into a multi-step workflow.

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

demand_tracker_agent.ex boost_action.ex cool_action.ex decay_action.ex toggle_auto_decay_action.ex demand_tracker_agent_live.ex

lib/agent_jido/demos/demand/demand_tracker_agent.ex 41 lines

defmodule AgentJido.Demos.DemandTrackerAgent do
  @moduledoc """
  A demand tracker agent demonstrating Jido capabilities:
  - Declarative cron schedules for recurring signals
  - Emit: Domain event publication
  - State updates vs side effects separation
  """
  use Jido.Agent,
    name: "demand_tracker",
    description: "Tracks listing demand with scheduled maintenance",
    schema: [
      listing_id: [type: :string, default: "demo-listing"],
      demand: [type: :integer, default: 50],
      ticks: [type: :integer, default: 0],
      last_updated_at: [type: :any, default: nil]
    ],
    schedules: [
      {"*/5 * * * *", "heartbeat.tick", job_id: :heartbeat},
      {"@daily", "cleanup.run", job_id: :cleanup, timezone: "America/New_York"}
    ]

  alias AgentJido.Demos.Demand.{
    BoostAction,
    CleanupAction,
    CoolAction,
    DecayAction,
    HeartbeatAction
  }

  @impl true
  def signal_routes(_ctx) do
    [
      {"listing.demand.boost", BoostAction},
      {"listing.demand.cool", CoolAction},
      {"listing.demand.tick", DecayAction},
      {"heartbeat.tick", HeartbeatAction},
      {"cleanup.run", CleanupAction}
    ]
  end
end