← back to examples
core beginner

Address Normalization Agent

Interactive Jido example for address normalization agent focusing on action contracts and validation. Includes a dedicated LiveView companion and source-first learning flow.

top20 rank-1 core l1 core-mechanics

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.
Next
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

address_normalization_agent.ex execute_action.ex reset_action.ex address_normalization_agent_live.ex
lib/agent_jido/demos/address_normalization/address_normalization_agent.ex 30 lines 
defmodule AgentJido.Demos.AddressNormalizationAgent do
  @moduledoc """
  Demo agent for deterministic US address normalization.

  This agent is intentionally small and focused on one learning goal:
  action contracts and validation.
  """
  use Jido.Agent,
    name: "address_normalization_agent",
    description: "Normalizes a US address with strict action contracts",
    schema: [
      last_input: [type: :map, default: %{}],
      normalized: [type: :map, default: %{}],
      normalized_address: [type: :string, default: ""],
      last_status: [type: {:in, [:idle, :ok, :error]}, default: :idle],
      validation_errors: [type: {:list, :string}, default: []],
      successful_runs: [type: :integer, default: 0]
    ]

  alias AgentJido.Demos.AddressNormalization.{ExecuteAction, ResetAction}

  @impl true
  def signal_routes(_ctx) do
    [
      {"address.normalize.execute", ExecuteAction},
      {"address.normalize.reset", ResetAction}
    ]
  end
end