Agent Studio

The Agent Studio is Chatty’s visual workflow editor. You build directed graphs of interconnected nodes — each node performs a specific task (LLM call, tool execution, vector search, etc.) — and the executor runs them with automatic parallelism, error routing, and checkpointing.

Key concepts

Nodes

Units of computation: LLM calls, tools, conditions, merges, loops, file I/O, and more. Each node reads from the context store and writes its output back.

Edges

Directed connections between nodes. Data edges define execution order. Fail edges route errors for retry cycles.

Context Store

A key-value store (HashMap<String, String>) that accumulates outputs. Any node can reference previous outputs via {{variable}} templates.

Parallel Execution

Independent nodes at the same topological level run concurrently using tokio::JoinSet. The merge node waits for all inputs.

Graph editor

The editor is built with @xyflow/svelte and provides:

• Drag & drop nodes from the toolbar (grouped by category: Flow, AI, Data)
• Connect nodes by dragging from output handles to input handles
• Configure nodes via the right-side panel (model, prompt, parameters)
• Right-click context menu for duplicate/delete
• Delete/Backspace to remove selected nodes or edges
• Position persistence — node positions are saved and restored

Execution flow

1. Validate — check for missing models, empty prompts, disconnected nodes
2. Start — sends the graph + input to the backend via WebSocket
3. Execute — the backend runs nodes level by level, streaming tokens and status events
4. Monitor — the execution panel shows real-time logs, node status badges, and streaming output
5. Inspect — click any node to see its execution history in the Node Inspector

Edge types

Type	Visual	Purpose
Data (default)	Blue solid line	Normal execution flow
Fail	Red dashed line	Error routing — followed when a node fails
Success	Blue solid line	Explicit success path (used with fail edges)

Fail edges are excluded from topological sorting, allowing controlled retry cycles without triggering cycle detection.