← back to examples

core beginner

Emit Directive Agent

Focused example showing how actions emit domain events while still updating agent state in one step.

signals directives emit core-mechanics l1

Related guides and notebooks

Review built-in directives and effect modeling.

Understand signal structure and dispatch.

Build your first workflow

Combine emits into multi-step workflows.

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

emit_directive_agent.ex create_order_action.ex process_payment_action.ex multi_emit_action.ex emit_directive_agent_live.ex

lib/agent_jido/demos/emit_directive/actions/multi_emit_action.ex 27 lines

defmodule AgentJido.Demos.EmitDirective.MultiEmitAction do
  @moduledoc """
  Emits a batch of synthetic events in a single action execution.
  """

  alias Jido.Agent.Directive
  alias Jido.Signal

  use Jido.Action,
    name: "multi_emit",
    description: "Emits multiple batch.event signals",
    schema: [
      event_count: [type: :integer, default: 3]
    ]

  @impl true
  def run(%{event_count: event_count}, _context) do
    emissions =
      for idx <- 1..event_count do
        signal = Signal.new!("batch.event", %{index: idx}, source: "/emit")
        %Directive.Emit{signal: signal}
      end

    {:ok, %{emitted_count: event_count}, emissions}
  end
end