Set Local Variables Node

Overview

Set Local Variables nodes assign values to variables without any conversation. They execute instantly and automatically advance to the next connected node. Use them to initialize data, transform values, or prepare variables before they’re needed downstream. Key characteristic: No conversation, no user interaction. The node sets variables and immediately moves on.

When to Use

Use Set Local Variables nodes to:

Initialize variables before a conversation or tool node needs them
Transform data — reformat, combine, or compute values from existing variables
Set defaults — provide fallback values for variables that may not be extracted yet
Prepare API parameters — assemble values before a tool node call
Store computed results — save derived data for later use in the flow

Core Configuration

{
  type: "set_local_variables",
  label?: string,
  description?: string,

  // Variables to set
  staticVariables?: Array<{
    id: string,
    name: string,            // snake_case, 1-50 chars
    description?: string,
    dataType: "string" | "number" | "boolean" | "array" | "object",
    value: string | number | boolean | any[] | object | null
  }>,

  // Transition (automatic — cannot be modified)
  transitions: Transition[]  // Single auto-transition to next node
}

Variables set in this node are available to all downstream nodes in the flow.

Variable Configuration

Each variable has four fields:

Field	Required	Description
Name	Yes	Variable name in `snake_case` format
Type	Yes	Data type: String, Number, Boolean, Array (JSON), Object (JSON)
Value	Yes	The value to assign — static or `{{variable}}` reference
Description	No	Optional description for documentation

Value Input by Type

Type	Input	Example
String	Text input with variable support	`"hello"` or `{{user_name}}`
Number	Numeric input with variable support	`42` or `{{order_total}}`
Boolean	Toggle switch	`true` / `false`
Array	JSON editor	`["item1", "item2"]`
Object	JSON editor	`{"key": "value"}`

All value inputs support {{variable}} references, allowing you to set a variable based on another variable’s value.

Use Cases & Examples

Example 1: Initialize Variables Before a Loop

Set Local Variables: Init_Counter
  variables:
    - name: attempt_count
      type: number
      value: 0
    - name: max_attempts
      type: number
      value: 3

  → Attempt_Action

Example 2: Combine Variables

Set Local Variables: Build_Full_Name
  variables:
    - name: full_name
      type: string
      value: "{{first_name}} {{last_name}}"

  → Greet_Customer

Example 3: Set Defaults

Set Local Variables: Set_Defaults
  variables:
    - name: language
      type: string
      value: "en"
    - name: priority
      type: string
      value: "normal"

  → Collect_Info

Example 4: Prepare API Parameters

Set Local Variables: Prepare_Booking
  variables:
    - name: booking_payload
      type: object
      value: {"customer_id": "{{customer_id}}", "date": "{{selected_date}}", "time": "{{selected_time}}"}

  → Submit_Booking_Tool

Transitions

Set Local Variables nodes use an automatic transition — they execute and immediately advance to the next connected node. You cannot add, remove, or edit transitions on this node type. Connect the node’s output to the next node in your flow. The connection is always unconditional.

Dashboard

Agents

Publishing

Variables

Tools

Knowledge Base

Batch Calls

Call History

Phone Numbers

Configuration

Set Local Variables Node

Overview

When to Use

Core Configuration

Variable Configuration

Value Input by Type

Use Cases & Examples

Example 1: Initialize Variables Before a Loop

Example 2: Combine Variables

Example 3: Set Defaults

Example 4: Prepare API Parameters

Transitions

Flow Examples

Pattern: Initialize → Collect → Process

Pattern: Transform Between Nodes

Next Steps

Change Agent Settings

Variables

Tool Node

Router Node

​Overview

​When to Use

​Core Configuration

​Variable Configuration

​Value Input by Type

​Use Cases & Examples

​Example 1: Initialize Variables Before a Loop

​Example 2: Combine Variables

​Example 3: Set Defaults

​Example 4: Prepare API Parameters

​Transitions

​Flow Examples

​Pattern: Initialize → Collect → Process

​Pattern: Transform Between Nodes

​Next Steps

Change Agent Settings

Variables

Tool Node

Router Node

Overview

When to Use

Core Configuration

Variable Configuration

Value Input by Type

Use Cases & Examples

Example 1: Initialize Variables Before a Loop

Example 2: Combine Variables

Example 3: Set Defaults

Example 4: Prepare API Parameters

Transitions

Flow Examples

Pattern: Initialize → Collect → Process

Pattern: Transform Between Nodes

Next Steps