#Build & Run

Once you have opened the editor, build your workflow by adding nodes, connecting them, configuring each step, and running it.

#Add Nodes

There are two ways to drop a node onto the canvas from the palette on the left:

• Click a node to place it in the center of the canvas.
• Drag a node onto the canvas to place it at a specific spot.

Once a node is on the canvas you can drag it around to reposition it. Use the search box at the top of the palette to filter the list before you pick.

#Connect Nodes

Each node has handles on its sides. Output handles sit on the right, input handles on the left. Trigger nodes only have output handles because they start the flow.

To connect two nodes, drag from an output handle on one node to an input handle on another. A curved line appears between them. This line represents the data path between the two steps.

Hover over a connection to highlight it and reveal a red delete button at the midpoint. Click the button or select the connection and press Delete to remove it.

#Configure a Node

Click any node on the canvas to open its settings in the configuration panel on the right. Every node has at least two fields:

• Node Label. A custom name for this step, shown on the node body.
• Node ID. A read-only identifier used in exports and logs.

Below those, each node type has its own configuration fields. An HTTP Request node asks for a URL and method. A Conditional node asks for a boolean expression. A Schedule Trigger asks for a cron expression and timezone. Required fields are marked with a red asterisk.

Some nodes have specialized pickers. Invoke Specialist includes a searchable specialist selector. Chat Respond includes a channel picker. AI Content Analysis includes a model picker for your connected providers.

To remove a node, scroll to the bottom of the configuration panel and click Delete Node. A confirmation dialog appears before the node is removed along with any connected edges.

#Choose an Execution Mode

The toolbar has a mode dropdown with three options:

• Dataflow. Pure data passing between nodes, similar to n8n. Each node receives input from the previous node and passes output to the next.
• State Machine. Shared state that nodes can read from and write to, similar to LangGraph. Good for workflows that need to track progress across steps.
• Hybrid. Combines both patterns in a single workflow.

Pick the mode that fits your use case. Dataflow is the simplest starting point for most workflows.

#Canvas Controls

The bottom-left corner of the canvas has standard controls:

• Zoom in / Zoom out.
• Fit view zooms to fit all nodes in the visible area.
• Lock freezes the canvas so you can scroll without accidentally dragging nodes.

The bottom-right corner shows a minimap with colored dots, one per node — colors match the node category. Drag the highlighted rectangle in the minimap to pan around large workflows.

#Save and Run

The toolbar provides these actions:

• Save. Persists the workflow. Disabled when there are no unsaved changes.
• Execute (green button). Runs the workflow. If there are unsaved changes, it saves automatically first. The button shows "Running..." while the workflow executes, and a status banner appears below the toolbar with the result.
• Undo / Redo. Step backward or forward through your edits. Keyboard shortcuts: Cmd+Z and Cmd+Shift+Z on macOS, Ctrl+Z and Ctrl+Shift+Z on Windows and Linux.
• New. Clears the canvas for a fresh start. Prompts to confirm if there are unsaved changes.

When the workflow runs, node states update in real time, and any errors surface directly on the failing node.

#Import and Export

#Export

Click Export JSON in the toolbar to download the workflow as a JSON file. The file uses Zephyr's native format and is named after your workflow.

#Import

Click Import in the toolbar to open a dialog with a large text area. Paste workflow JSON and choose one of three import formats:

• Import as n8n for workflows exported from n8n.
• Import as LangGraph for LangGraph workflow definitions.
• Import as Zephyr for Zephyr's native format.

The sidebar also has a collapsible Import n8n Workflow section for quick n8n imports without opening the full dialog.

#Attach to Channels and Specialists

Workflows can run automatically in response to chat activity. From a channel's right panel or a specialist's configuration, click Add Workflow to browse and attach a saved workflow.

When attaching to a channel, you pick a trigger type: Manual, Slash Command (users type a command like /analyze), Keyword Monitor (watches for specific words), Event Trigger, or Scheduled.

When attaching to a specialist, you pick an invocation mode: Manual, Automatic, or On Demand.

Each attachment has a priority (0 to 100) and an active/inactive toggle. Higher priority workflows execute first when multiple are attached.