Skip to content

YAML Configuration Guide

Everything you need to know about writing kaboo-workflows YAML configs — from zero to production.

kaboo-workflows lets you describe entire multi-agent systems in YAML and get back live, fully wired strands objects. This guide walks you through every configuration option, from the simplest one-agent setup to nested multi-orchestration systems with MCP servers, hooks, session persistence, conditional graph pipelines, and multi-file configs.

No prior YAML expertise required. We start simple and build up.

Table of Contents

  1. The Basics — Your First Config
  2. Models — Choosing Your LLM
  3. Variables — Environment-Driven Config
  4. YAML Anchors — DRY Config Blocks
  5. Tools — Giving Agents Superpowers
  6. Hooks — Middleware for Agents
  7. Session Persistence — Memory That Survives Restarts
  8. Conversation Managers — Controlling Context Windows
  9. MCP — External Tool Servers
  10. Orchestrations — Multi-Agent Systems
  11. Graph Conditions — Dynamic Routing
  12. Nested Orchestrations — Composing Systems
  13. Multi-File Configs — Splitting and Merging
  14. Agent Factories — Custom Agent Construction
  15. Event Streaming — Real-Time Observability
  16. Name Sanitization — How Names Are Handled
  17. The Loading Pipeline — What Happens Under the Hood
  18. Full Reference — Every Field at a Glance

Bonus: Quick Recipes — Copy-paste-ready configs for common patterns.

That covers everything kaboo-workflows YAML has to offer. When in doubt, check the examples — each one is a self-contained demo of the concepts above. And remember: after load(), what you get back are plain strands objects. No wrappers, no subclasses. Just the real deal, fully wired and ready to go.

Happy composing! 🎼