← back to examples

core beginner

Plugin Basics Agent

Focused example showing plugin mount state, plugin signal routes, and plugin-owned state updates.

plugins composition signals coordination l1

Related guides and notebooks

Understand plugin state, hooks, and route composition.

Review signal dispatch to plugin routes.

Plugins and composable agents

Build larger systems from composable plugins.

Plugins and composable agents

Run the companion notebook in Livebook

What this example teaches

Interactive Demo

Run the agent and inspect state

Read the production implementation

plugin_basics_agent.ex notes_plugin.ex add_note_action.ex clear_notes_action.ex plugin_basics_agent_live.ex

lib/agent_jido/demos/plugin_basics/actions/add_note_action.ex 20 lines

defmodule AgentJido.Demos.PluginBasics.AddNoteAction do
  @moduledoc """
  Appends a note entry to plugin-managed state.
  """

  use Jido.Action,
    name: "add_note",
    description: "Adds a note entry",
    schema: [
      text: [type: :string, required: true]
    ]

  @impl true
  def run(%{text: text}, context) do
    notes = get_in(context.state, [:notes, :entries]) || []
    note = %{text: text, added_at: DateTime.utc_now()}
    {:ok, %{notes: %{entries: [note | notes]}}}
  end
end