← 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

Concept
Agents
Review agent state model and immutability.
Concept
Actions
Understand action contracts and result handling.
Next
Build your first workflow
Compose multiple state mutations into workflows.
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

  • When to use SetState vs ReplaceState.
  • How to remove keys and nested paths safely.
  • How state operations stay pure under cmd/2.

How it works

Each button executes one action that returns a specific StateOp. The demo immediately renders the resulting state and logs each mutation.

Focus

This example intentionally stays local and deterministic:

  • No network
  • No external services
  • No background runtime required