Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.sirenspec.dev/llms.txt

Use this file to discover all available pages before exploring further.

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?"

​
Graph

​
Next steps

Sequential Pipeline

Chain two agents together with an edge.

YAML Reference

Every field available in a workflow file.