YAML Workflow Reference

YAML workflows provide a powerful way to define, version, and share workflow configurations in Klyntos. This reference guide covers the complete YAML syntax, block schemas, and best practices for creating robust workflows.

Quick Start

Every Klyntos workflow follows this basic structure:

version: '1.0'
blocks:
  start:
    type: starter
    name: Start
    inputs:
      startWorkflow: manual
    connections:
      success: agent-1

  agent-1:
    type: agent
    name: "AI Assistant"
    inputs:
      systemPrompt: "You are a helpful assistant."
      userPrompt: 'Hi'
      model: gpt-4o
      apiKey: '{{OPENAI_API_KEY}}'

Core Concepts

Version Declaration: Must be exactly version: '1.0' (with quotes)

Blocks Structure: All workflow blocks are defined under the blocks key

Block References: Use block names in lowercase with spaces removed (e.g., <aiassistant.content>)

Environment Variables: Reference with double curly braces {{VARIABLE_NAME}}

Block Types

Klyntos supports several core block types, each with specific YAML schemas: