← back to examples

core beginner

Signal Routing Agent

Interactive Jido example showing how signal type routing maps into actions and executes through AgentServer.call/2 and AgentServer.cast/2.

signals routing agent-server core-mechanics l1

Related guides and notebooks

Understand signal anatomy, routing, and dispatch.

Review action contracts and validated input schemas.

Build your first workflow

Chain routed steps into a larger workflow.

Build your first workflow

Run the companion notebook in Livebook

What this example teaches

Interactive Demo

Run the agent and inspect state

Read the production implementation

signal_routing_agent.ex increment_action.ex set_name_action.ex record_event_action.ex signal_routing_agent_live.ex

lib/agent_jido/demos/signal_routing/actions/increment_action.ex 20 lines

defmodule AgentJido.Demos.SignalRouting.IncrementAction do
  @moduledoc """
  Increments the agent counter by a provided amount.
  """

  use Jido.Action,
    name: "increment",
    description: "Increments the counter",
    schema: [
      amount: [type: :integer, default: 1, doc: "Amount to increment by"]
    ]

  @impl true
  @spec run(map(), map()) :: {:ok, map()}
  def run(%{amount: amount}, context) do
    current = Map.get(context.state, :counter, 0)
    {:ok, %{counter: current + amount}}
  end
end