Variáveis

Uma variável é um valor que você define e reutiliza em um workflow. O Zoen tem dois tipos. Variáveis de workflow guardam dados durante uma execução, como um contador ou um objeto de config, e você as referencia com <variable.name>. Variáveis de ambiente guardam segredos e configuração, como chaves de API, e você as referencia com {{KEY}}.

Uma sintaxe, fontes nomeadas

Tudo entre colchetes angulares é o mesmo mecanismo: <name.path> lê um valor pelo nome em tempo de execução. O primeiro segmento diz de onde o valor vem. variable é literal — toda variável de workflow é lida por ele. Uma tag de conexão começa com o nome do próprio bloco, e dentro de um contêiner, loop e parallel são reservados para o contexto. {{KEY}} é a sintaxe diferente, para variáveis de ambiente.

A tabela está na ordem de resolução: quando uma referência entre colchetes angulares poderia bater com mais de uma fonte — digamos um bloco chamado variable — o contexto de loop e parallel vence, depois variáveis de workflow, depois saídas de bloco. ({{KEY}} não colide; é outra sintaxe.) Se nada bater, a referência crua fica no lugar sem substituição, o que em geral quebra o bloco que a lê — então dê nomes distintos a variáveis e blocos.

Digite < em qualquer campo de texto de bloco para abrir o seletor e navegar por tudo que você pode referenciar.

Variáveis de workflow

Variáveis de workflow são um store global que qualquer bloco pode ler ou atualizar durante uma execução. Abra o painel com ⋯ → Variables no canto superior direito do editor. Cada variável tem um nome, um tipo e um valor.

Referencie uma em qualquer lugar em que um campo aceite entrada. Para uma variável objeto ou array, use notação de ponto para alcançar um valor aninhado, como <variable.config.timeout>. O matching de nome ignora maiúsculas/minúsculas e espaços, então uma variável chamada My Counter resolve a partir de <variable.mycounter> — mas um nome não pode conter ponto: tudo depois do primeiro ponto é lido como caminho no valor, então <variable.config.timeout> sempre significa o campo timeout de config, nunca uma variável chamada config.timeout. Nomes consistentes como camelCase são os mais claros.

Tipos

"Hello, World!"

42

true

{ "name": "John", "age": 30 }

[1, 2, 3, "four", "five"]

Escopo

Variáveis de workflow são globais: todo bloco do workflow pode lê-las e modificá-las. Use o bloco Variables para atualizar um valor no meio da execução.

Cada execução começa do zero a partir dos valores definidos no painel. Uma mudança feita durante uma execução fica visível para blocos posteriores naquela mesma execução, mas nunca altera o valor inicial salvo para execuções futuras.

Variáveis de ambiente

Variáveis de ambiente armazenam valores sensíveis como chaves de API, tokens e configuração que nunca devem aparecer em logs ou no canvas. Crie-as em Settings → Secrets adicionando um par chave-valor.

Referencie-as com chaves duplas em qualquer campo de bloco, inclusive system prompts de Agent e código de bloco Function. O valor é substituído antes do bloco rodar, e as chaves de API são redigidas nos logs.

{{API_KEY}}

Pessoal vs. workspace

Quando uma variável do workspace e uma pessoal compartilham uma chave, o valor do workspace vence.

Use uma variável de ambiente para uma chave de API crua ou valor de config. Quando um serviço precisa de OAuth ou renovação gerenciada de token (Slack, GitHub, Google), use uma credencial em vez disso, selecionada em um dropdown na config do bloco.

Próximos passos