Simple Agent

A single agent, one node, no edges. This is the minimum viable SirenSpec workflow and the right starting point before exploring multi-agent patterns.

What it demonstrates

Declaring an agent with a model URI and system prompt
A single agent node that writes to output.reply
Running a workflow with a static input and overriding it from the CLI

Run it

sirenspec run docs/cookbook/simple-agent/workflow.yaml
# Override the question:
sirenspec run docs/cookbook/simple-agent/workflow.yaml --input "What is the boiling point of water?"

Workflow

docs/cookbook/simple-agent/workflow.yaml

version: "0.1"

agents:
  assistant:
    model: "openai:gpt-4o-mini"
    system: "You are a helpful assistant. Answer questions clearly and concisely."

nodes:
  answer:
    agent: assistant
    writes: output.reply

input:
  message: "What is the capital of France?"

Basics

Multi-Agent Patterns

Swrm & Fan-Out

Factory & Iteration

Guardrails

Human in the Loop

Budget & Cost Control

Stress Tests

Tool Nodes

What it demonstrates

Run it

Workflow

Graph

Next steps

Sequential Pipeline

YAML Reference

​What it demonstrates

​Run it

​Workflow

​Graph

​Next steps

Sequential Pipeline

YAML Reference

What it demonstrates

Run it

Workflow

Graph

Next steps