Variáveis

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

Uma sintaxe, várias origens nomeadas

Tudo entre < e > usa o mesmo mecanismo: <name.path> lê um valor pelo nome no momento da execução. O primeiro segmento diz de onde o valor vem. variable é literal — toda variável de workflow é lida por meio dele. Uma tag de conexão começa com o nome do próprio block, e dentro de um container, loop e parallel são reservados para o contexto dele. {{KEY}} é a única sintaxe diferente, usada para variáveis de ambiente.

A tabela está em ordem de resolução: quando uma referência entre < e > pode corresponder a mais de uma origem — por exemplo, um block chamado variable — o contexto de loop e parallel ganha, depois as variáveis de workflow, depois as saídas de block. ({{KEY}} não pode colidir; é outra sintaxe.) Se nada corresponder, a referência é deixada como está, sem substituição, o que normalmente quebra o block que a lê — então dê nomes distintos a variáveis e blocks.

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

Variáveis de workflow

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

Referencie uma variável em qualquer lugar que aceite entrada. Para uma variável de objeto ou array, use notação de ponto para alcançar um valor aninhado, como <variable.config.timeout>. A correspondência de nomes ignora maiú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 um caminho dentro do valor, então <variable.config.timeout> sempre significa o campo timeout de config, nunca uma variável chamada config.timeout. Nomes consistentes em 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 block do workflow pode lê-las e modificá-las. Use o block 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 os blocks seguintes dessa mesma execução, mas nunca altera o valor inicial salvo para execuções futuras.

Variáveis de ambiente

Variáveis de ambiente permitem manter valores sensíveis, como chaves de API e tokens, fora da configuração salva do seu workflow. Crie-as em Settings → Secrets, adicionando um par chave-valor.

Referencie-as com chaves duplas em qualquer campo de block, incluindo system prompts do Agent e código do block Function. A maioria dos campos resolve a referência antes de o block executar. O código de Function e de Custom Tool preserva {{KEY}} até o compilador compartilhado dos dois rodar no limite de execução, onde o valor é vinculado separadamente do código-fonte. Isso mantém o conteúdo exato da string fora do código-fonte salvo e executado. Quando um segredo salvo é resolvido com sucesso por {{KEY}}, as ocorrências exatas daquele valor são mascaradas na exibição ao vivo do log do block e no rastreamento de execução armazenado, sem mudar o valor em tempo de execução. Valores exatos de segredos também são convertidos de volta em placeholders antes de o conteúdo ser enviado a um modelo. Veja Proteção do log de execução para o escopo exato e as limitações.

{{API_KEY}}

Dentro do código de Function e de Custom Tool, {{KEY}} sempre resulta em uma string — o valor é vinculado, nunca interpretado como código-fonte. Use Number(), uma comparação === 'true' ou JSON.parse() quando precisar de outro tipo. Veja placeholders de segredos em código.

Pessoal vs. workspace

Quando uma variável de workspace e uma pessoal têm a mesma chave, o valor do workspace ganha.

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

Próximos passos