Workflows

Colour: Emerald (#10b981)

Workflows are container nodes that group skills, prompts, and services into structured pipelines. They represent an end-to-end process — from input through processing to output.

Creating Workflows

Workflows are created through a four-step wizard:

1. Pattern — Name your workflow, add a description, and select a pattern template that defines the structure.
2. Services — Choose which service the workflow runs on (primary executor) and any additional services it requires.
3. Components — Fill the pattern’s slots by selecting existing nodes from your graph or creating new ones inline.
4. Review — Check everything before creation. The wizard shows all nodes and edges that will be created.

See Workflow Patterns for detailed descriptions of each pattern.

Pre-Built Patterns

Seven patterns are available out of the box:

1. Content Processing — Input, transform, output pipeline for converting content between formats
2. Analysis & Report — Analyse input thoroughly then generate a structured report
3. Classify & Route — Classify input by intent or type, then route to the appropriate handler
4. Data Extraction — Extract structured data from unstructured input, validate, and format
5. RAG Pipeline — Retrieve relevant context, augment the prompt, and generate an informed response
6. Multi-Step Generation — Research, draft, review, and polish for complex content creation
7. Human-in-the-Loop — Automated processing with a human review and approval gate

Each pattern defines required and optional slots with minimum and maximum counts, so the wizard enforces a sensible structure while still letting you customise.

Graph View Features

Workflows have several behaviours on the graph canvas:

• Expand/collapse — Click a workflow node to show or hide its child nodes and their connections.
• Focus mode — Isolate a single workflow to see only its components, filtering out everything else on the canvas.
• Workflows panel — The right sidebar lists all workflows with controls to toggle visibility and enter focus mode for each one.

Step Ordering

Workflow steps have a position number that defines execution order:

• Position 1 = first step(s)
• Position 2, 3… = subsequent steps in sequence
• Same position = parallel execution (e.g. two skills both at position 1 run in parallel)

The wizard assigns positions automatically based on the pattern template. You can reorder steps in the expanded editor using the up/down buttons in the Connection Manager.

Flow Diagram

The Flow tab in the expanded editor shows a pipeline visualisation:

• Steps arranged left-to-right by position
• Supporting nodes (services, sources, assets) shown below their associated steps
• Animated arrows show the flow direction
• Dashed lines for supporting relationships (references, requires)
• Click any node in the diagram to navigate to it

Connections

Workflows use three edge types:

• Runs on a service — the primary executor (e.g. an LLM provider the workflow sends requests to)
• Requires additional services — secondary dependencies (e.g. a vector database for retrieval)
• Uses child nodes — skills, prompts, assets, and sources that form the workflow’s internal pipeline. Each uses edge carries a position number for step ordering.