← 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

Concept
Signals
Understand signal anatomy, routing, and dispatch.
Concept
Actions
Review action contracts and validated input schemas.
Next
Build your first workflow
Chain routed steps into a larger 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

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/signal_routing_agent.ex 30 lines 
defmodule AgentJido.Demos.SignalRoutingAgent do
  @moduledoc """
  Agent showcasing signal-based routing to distinct actions.
  """

  alias AgentJido.Demos.SignalRouting.{
    IncrementAction,
    RecordEventAction,
    SetNameAction
  }

  use Jido.Agent,
    name: "signal_routing_agent",
    description: "Routes incoming signals to dedicated actions",
    schema: [
      counter: [type: :integer, default: 0],
      name: [type: :string, default: ""],
      events: [type: {:list, :map}, default: []]
    ],
    signal_routes: [
      {"increment", IncrementAction},
      {"set_name", SetNameAction},
      {"record_event", RecordEventAction}
    ]

  @doc false
  @spec plugin_specs() :: nonempty_list(Jido.Plugin.Spec.t())
  def plugin_specs, do: super()
end