> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rovax.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Nó Variáveis (Definir Variável)

> Crie, armazene e transforme valores para reutilizar em qualquer ponto do workflow via {{ $vars.nome }}.

<Note>
  Variáveis definidas neste nó existem apenas durante a execução atual. Elas não persistem entre execuções distintas do mesmo workflow.
</Note>

## Como Funciona

O nó **Definir Variável** cria ou sobrescreve variáveis com escopo de execução. Uma vez definidas, ficam acessíveis em todos os nós seguintes via `{{ $vars.nome_da_variavel }}` — incluindo nós de condição, HTTP, código JS e o prompt do nó LLM.

Use o nó para:

* Extrair campos de um payload volumoso e dar nomes claros e curtos a eles
* Calcular ou concatenar valores derivados de múltiplas fontes do fluxo
* Armazenar resultados intermediários que serão consumidos por mais de um nó adiante
* Inicializar contadores, flags ou objetos de controle antes de entrar em um loop

## Opções de Configuração

Um único nó pode definir quantas variáveis forem necessárias. Cada variável exige três campos:

* **Nome** — identificador em snake\_case sem espaços; após digitar, o painel exibe a expressão de acesso `{{ $vars.seu_nome }}`
* **Tipo** — determina como o valor é armazenado e interpretado pelo motor de execução
* **Valor** — campo estático, referência dinâmica via template `{{ }}` ou editor de bloco para JSON

| Tipo         | Quando usar                                                            |
| ------------ | ---------------------------------------------------------------------- |
| `string`     | Textos, IDs, nomes, e-mails, valores alfanuméricos                     |
| `number`     | Quantidades, totais, índices para cálculos e comparações               |
| `boolean`    | Flags de controle (`true` / `false`) para condicionais                 |
| `json`       | Objetos ou arrays complexos que serão passados ao nó HTTP ou ao nó LLM |
| `expression` | Template dinâmico completo — o valor inteiro é resolvido em execução   |

## Casos de Uso Comuns

O nó Definir Variável é mais útil nos seguintes padrões:

* **Renomear campos do payload** — um webhook externo chega com chaves em inglês (`customer.full_name`, `order.ref`); defina variáveis com nomes em português antes de referenciar nos nós seguintes, tornando o fluxo mais legível
* **Construir corpo de requisição HTTP** — monte um objeto `json` complexo com campos vindos de diferentes partes do fluxo (`$trigger`, `$json`, outros `$vars`) e referencie a variável como `{{ $vars.payload }}` no campo de corpo do nó HTTP
* **Controlar iterações em loop** — inicialize `contador` como `number` com valor `0` e `lista_erros` como `json` com valor `[]` antes do nó Loop; o nó JavaScript interno atualiza esses valores a cada iteração usando `vars.contador` e `vars.lista_erros`