← back to examples

core beginner

State Ops Agent

Focused example for SetState, ReplaceState, DeleteKeys, SetPath, and DeletePath via pure cmd execution.

state stateops actions core-mechanics l1

Related guides and notebooks

Review agent state model and immutability.

Understand action contracts and result handling.

Build your first workflow

Compose multiple state mutations into 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

state_ops_agent.ex merge_metadata_action.ex replace_all_action.ex set_nested_value_action.ex state_ops_agent_live.ex

lib/agent_jido/demos/state_ops/actions/merge_metadata_action.ex 20 lines

defmodule AgentJido.Demos.StateOps.MergeMetadataAction do
  @moduledoc """
  Merges metadata using `StateOp.SetState`.
  """

  alias Jido.Agent.StateOp

  use Jido.Action,
    name: "merge_metadata",
    description: "Merges metadata into state",
    schema: [
      metadata: [type: :map, required: true]
    ]

  @impl true
  def run(%{metadata: metadata}, _context) do
    {:ok, %{}, %StateOp.SetState{attrs: %{metadata: metadata}}}
  end
end