← 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

What you’ll learn

  • Action contracts and validation
  • Agent state/schema fundamentals
  • Signals and routing
  • How to wire a dedicated LiveView demo: AgentJidoWeb.Examples.AddressNormalizationAgentLive

How it works

This example focuses on one learning outcome: Action contracts and validation.

The interactive demo runs two deterministic payloads:

  1. A valid US-style address payload that normalizes into a canonical string.
  2. An invalid payload (missing postal_code) that is rejected by the action contract.

Agent Boundary

  • Agent module: AgentJido.Demos.AddressNormalizationAgent
  • Execute action: AgentJido.Demos.AddressNormalization.ExecuteAction
  • Reset action: AgentJido.Demos.AddressNormalization.ResetAction
  • Agent API: AddressNormalizationAgent.cmd/2

LiveView Boundary

  • Demo module: AgentJidoWeb.Examples.AddressNormalizationAgentLive
  • Demo source target: lib/agent_jido_web/examples/address_normalization_agent_live.ex
  • Route: /examples/address-normalization-agent

Demo flow

  1. Click Run Valid Payload to normalize a deterministic address sample.
  2. Click Run Invalid Payload to trigger action validation rejection.
  3. Click Reset to clear the demo state.

Prerequisites

  • training/agent-fundamentals

Story Link

Build this example in ST-EX-001 from specs/stories/07_examples_top20_liveview.md.