AI Rooms Workflow Engine - User Guide

Building and managing workflows using the Nexroo Engine workflow engine.

---

Copyright © 2025 Adrien Eppling and Romain Michaux Licensed under the Nexroo Engine Free Use License v1.0

---

This guide covers all aspects of building workflows with the Nexroo Engine engine. Start with simple workflows and gradually incorporate advanced features as you become more comfortable with the system. Use the mock and dry-run modes extensively during development, and leverage the observability features to optimize your workflows for production use.

Table of Contents

1. Use Cases
2. Quick Start
   • Installation
   • Your First Workflow
3. Running Workflows
   • Basic Command Line Usage
   • Command Line Options
   • Execution Modes
4. Workflow Structure
   • Addons Configuration
   • Entrypoints
   • Workflow Definition
5. Advanced Features
   • Step Properties
   • Multiple Entry Points
   • Queue Management & Iteration Control
   • Addon Testing & Validation
   • Advanced Observability Features
6. Template System
   • Variable Syntax
   • Variable Sources
   • Template Examples
7. Flow Control & Conditions
   • Basic Conditional Flow
   • Complex Conditions
   • Multiple Next Steps
   • Conditional Arrays
   • Loop Control
8. Error Handling
   • Error Strategies
   • Error Handling Examples
9. Addons & Actions
   • Built-in Actions
   • Logic Actions
   • Custom Addons
   • Addon Configuration
10. AI Features
    • Context Management System
    • Named Context Blocks
    • Dynamic Context Assembly
    • Semantic Memory System
    • Template Engine Integration
    • Advanced Use Cases
11. Testing & Development
    • Mock Mode
    • Mock Configuration
    • Built-in Mock Actions
    • Mock Response Examples
    • Step-Level Mock Overrides
    • Dry Run Mode
    • Dry Run Analysis
    • Development Workflow
12. Observability & Monitoring
    • Automatic Observation
    • Observation Data
    • Performance Insights
    • Custom Observability
13. Best Practices
    • Workflow Design
    • Step Design
    • Template Variables
    • Error Handling
    • Performance
    • Security