Ir para o conteúdo

Variável

Os valores da equipe que os procedimentos referenciam por nome, os tipos que existem, e como distingui-los dos valores de execução.

Uma variável do workspace é um valor que pertence à equipe e que qualquer procedimento pode referenciar. Ela existe para que um dado que muda de vez em quando exista em um lugar.

O endereço de uma API que migrou de domínio, o prazo padrão que a diretoria reviu, o e-mail que recebe as exceções: sem variável, cada um desses vive copiado em cinco etapas e some em quatro quando alguém atualiza a quinta.

Tipos

TipoGuarda
Textoqualquer cadeia
Númeroum valor numérico
Booleanoverdadeiro ou falso
E-mailum endereço válido
URLum endereço web válido
Datauma data
Segredouma credencial, tratada à parte

O tipo não é decoração, porque ele é conferido quando a variável é usada, e é o que impede um endereço malformado de só aparecer como erro quando um cliente já está esperando resposta.

Onde elas entram

Em todo campo de um procedimento que aceita referência, como o endereço e o corpo de uma requisição, o texto de um Template, uma condição ou uma fórmula. Você as insere por um seletor, e a referência guarda o identificador em vez do nome, o que faz renomear uma variável não quebrar nada que a use.

Vale notar onde elas não entram: as instruções de um agente são texto puro e não resolvem referência nenhuma. Um valor que precisa aparecer no comportamento do agente pertence ao Conhecimento, que é lido e conferido, e não ao prompt, que é apenas repetido.

As outras duas origens

Dentro de um procedimento, as variáveis de workspace convivem com duas outras origens, e distingui-las evita um defeito específico:

OrigemViveExemplo
Etapadurante uma execuçãoo número do pedido que acabou de ser coletado
Workspacepermanente, para a equipea chave da API da transportadora
Sistemasempre disponívela data e hora atuais

Um valor que muda a cada execução é de etapa, e um valor que é o mesmo para todo mundo é de workspace. Confundir os dois produz o procedimento que funciona no teste e, em produção, responde com o dado da execução anterior.