Variables

Variable Categories

Global Variables

Accessible throughout the flow. Persist across the entire execution.

Input Variables

Defined at flow entry. The start node populates these from the trigger payload.

Output Variables

Captured by the end node and returned as the flow result.

Variable Definition

{
  "variables": {
    "global": {
      "counter": {
        "name": "counter",
        "type": "number",
        "defaultValue": 0,
        "description": "Iteration counter",
        "required": false
      }
    },
    "inputs": {
      "input": {
        "name": "input",
        "type": "string",
        "description": "User input text",
        "required": true
      }
    },
    "outputs": {
      "output": {
        "name": "output",
        "type": "string",
        "description": "Agent response"
      }
    }
  }
}

Variable Types

Type	Description
string	Text value
number	Numeric value
boolean	True/false
object	JSON object
array	JSON array
any	Any type

Interpolation

Use {{variable}} syntax to reference variables in node configurations:

{{input.message}}          — Input variable
{{agent-1.output}}         — Output from a specific node
{{state.counter}}          — Global state variable
{{credentials.api_key}}    — Credential reference
{{item.title}}             — Current item in map_reduce

Setting State

Use set_state nodes to update global variables during execution:

{
  "type": "set_state",
  "data": {
    "type": "set_state",
    "assignments": [
      { "key": "counter", "value": "{{state.counter}} + 1" },
      { "key": "lastResult", "value": "{{agent-1.output}}" }
    ]
  }
}