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
| Tipo | Guarda |
|---|---|
| Texto | qualquer cadeia |
| Número | um valor numérico |
| Booleano | verdadeiro ou falso |
| um endereço válido | |
| URL | um endereço web válido |
| Data | uma data |
| Segredo | uma 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:
| Origem | Vive | Exemplo |
|---|---|---|
| Etapa | durante uma execução | o número do pedido que acabou de ser coletado |
| Workspace | permanente, para a equipe | a chave da API da transportadora |
| Sistema | sempre disponível | a 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.