← 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/record_event_action.ex 28 lines

defmodule AgentJido.Demos.SignalRouting.RecordEventAction do
  @moduledoc """
  Records a typed event in agent state.
  """

  use Jido.Action,
    name: "record_event",
    description: "Records an event payload",
    schema: [
      event_type: [type: :string, required: true, doc: "Event type label"],
      payload: [type: :map, default: %{}, doc: "Event payload map"]
    ]

  @impl true
  @spec run(map(), map()) :: {:ok, map()}
  def run(%{event_type: event_type, payload: payload}, context) do
    events = Map.get(context.state, :events, [])

    event = %{
      type: event_type,
      payload: payload,
      recorded_at: DateTime.utc_now()
    }

    {:ok, %{events: [event | events]}}
  end
end