Node Interactions

​

Overview

​

Selecting nodes

​

Single selection

• Node highlights with border
• Properties Panel updates to show node details
• Output/input ports become visible

​

Multiple selection

1. Click first node
2. Hold Shift
3. Click additional nodes
4. All selected nodes highlight

1. Click and drag on empty Canvas space
2. Drag to create selection box
3. All nodes inside box are selected
4. Release to complete selection

• Cmd+A (Mac) / Ctrl+A (Windows) — Select all nodes
• Useful for bulk operations

​

Deselecting

• Click empty Canvas — Deselects everything
• Cmd+click (Mac) / Ctrl+click (Windows) — Toggle individual node in/out of selection

​

Moving nodes

​

Basic movement

• Grid snapping helps align nodes
• Edges automatically update as you move
• Other selected nodes move together

​

Precise movement

​

Constrained movement

​

Moving multiple nodes

1. Select multiple nodes (Shift-click or box select)
2. Drag any selected node
3. All selected nodes move together, maintaining relative positions

​

Editing nodes

​

Accessing node properties

• Content tab — Code, prompts, configuration
• Input/Output tab — Schema and field definitions
• Info tab — Name, description, metadata
• Executions tab — History of runs

​

Editing Action nodes

1. Select the Action node
2. Properties → Content tab
3. Edit Action.py code directly
4. Update requirements.txt if needed
5. Changes auto-save

• Add logging
• Improve error handling
• Optimize performance
• Update logic

​

Editing Agent nodes

1. Select the Agent node
2. Properties → Content tab
3. Modify:
   • System Prompt — Agent instructions
   • Model — GPT-4, Claude, etc.
   • Temperature — Randomness (0-1)
   • Max Tokens — Response length
   • Tools — Available Actions/Flows
4. Changes auto-save

• Refine prompts for better results
• Add/remove tools
• Adjust temperature for consistency/creativity
• Switch models for cost/performance

​

Editing Flow nodes (sub-Flows)

1. Select the Flow node
2. Double-click to open its internal structure
3. Edit as you would any Flow (add/remove/connect nodes)
4. Use breadcrumbs to return to parent Flow

​

Editing Control nodes

• Define conditions for each output branch
• Set default path if no condition matches

• Choose merge strategy (wait for all, first wins, custom)
• Configure field mapping if combining data

• Set iteration logic (for each item, until condition, etc.)
• Define max iterations to prevent infinite loops

​

Configuring nodes

​

Renaming nodes

1. Select node
2. Properties → Info tab
3. Edit “Name” field
4. Press Enter

1. Double-click node label on Canvas
2. Type new name
3. Press Enter or click away

• Use descriptive names: Validate_Email not Action_1
• Follow naming convention: verb_noun format
• Be consistent across your Project

​

Adding descriptions

1. Select node
2. Properties → Info tab
3. Add description: what it does, why it exists, any gotchas

• Helps teammates understand
• Aids future you
• Useful for documentation generation

​

Node settings

• Timeout (seconds)
• Retry count
• Error handling behavior

• Model and parameters
• Tool permissions
• Response format

• Execution mode (sequential, parallel)
• Error propagation

​

Copying and pasting nodes

​

Copy/paste within a Flow

1. Select node(s)
2. Copy: Cmd+C (Mac) / Ctrl+C (Windows)
3. Paste: Cmd+V (Mac) / Ctrl+V (Windows)
4. Duplicate appears with offset

​

Copy across Flows

1. Select node(s) in source Flow
2. Copy (Cmd+C / Ctrl+C)
3. Open destination Flow
4. Paste (Cmd+V / Ctrl+V)
5. Reconnect as needed

​

Duplicating nodes

​

Deleting nodes

​

Delete single node

1. Select the node
2. Delete: Press Delete or Backspace
3. Or right-click → Delete
4. Confirm if prompted

​

Delete multiple nodes

1. Select multiple nodes
2. Press Delete or Backspace
3. Confirm

​

Delete and bridge

1. Select the node
2. Right-click → Delete and Bridge
3. Node is removed, incoming and outgoing edges reconnect around it

Before: A → B → C
After:  A → C

​

Node context menu

• Edit — Open editor (same as double-click)
• Duplicate — Create copy
• Delete — Remove node
• Delete and Bridge — Remove and reconnect edges
• Disconnect All — Remove all edges but keep node
• Copy — Copy to clipboard
• Find Usages — See where this component is used
• Export — Export as JSON
• View Executions — See execution history for this node
• Add to Favorites — Quick access for reuse

​

Grouping nodes

​

Visual grouping

1. Select multiple nodes
2. Right-click → Group
3. Choose: Add to new group
4. Name the group (e.g., “Validation Logic”)
5. A visual box appears around grouped nodes

• Clarifies structure
• Collapsible for cleaner Canvas
• Can move group as unit

​

Ungrouping

1. Click the group header
2. Right-click → Ungroup
3. Nodes remain but visual grouping is removed

​

Node states

​

Design time (editing)

• Default — Gray/blue, ready to configure
• Selected — Highlighted border
• Hovered — Slight highlight, ports visible
• Error — Red indicator (configuration error)

​

Execution time

• Pending — Gray, waiting to run
• Running — Yellow, currently executing
• Success — Green, completed successfully
• Failed — Red, error occurred
• Skipped — Faded, not part of execution path

​

Advanced interactions

​

Node metadata

1. Select node
2. Properties → Info tab → Metadata section

• Created date
• Last modified
• Creator
• Version
• Dependencies
• Usage count

​

Node performance

1. Select node
2. Properties → Executions tab
3. View:
   • Average execution time
   • Min/max time
   • Success rate
   • Error types

​

Node search within Flow

1. Press Cmd+F (Mac) / Ctrl+F (Windows)
2. Type node name
3. Canvas highlights matching nodes
4. Arrow keys to jump between matches

​

Best practices

Name nodes clearly — Future you will thank present you

Group related logic — Visual organization aids understanding

Delete unused nodes — Clutter confuses

Use descriptions — Document non-obvious decisions

Test nodes individually — Verify each works before connecting

Align nodes neatly — Use grid snapping and arrow keys

​

Keyboard shortcuts

​

Troubleshooting

​

Next steps