Variáveis de ambiente
Defina variáveis de ambiente que todos os agentes do workspace recebem em cada execução, e saiba quando usar um segredo no lugar de um valor em texto.
As variáveis de ambiente do workspace são entregues a todas as execuções de agentes do workspace. Use-as para configurações comuns a todos os agentes, como um proxy (HTTP_PROXY) ou o endereço de um serviço interno.
Os valores ficam visíveis em texto
Proprietários e administradores veem o valor de cada variável em texto simples. Para um token, uma senha ou qualquer valor sensível, crie um segredo e faça referência a ele na variável.
Variáveis de ambiente ou segredos
| Variável de ambiente | Segredo | |
|---|---|---|
| Para que serve | Configuração comum, não sensível. | Tokens, senhas e chaves. |
| O valor aparece na tela | Sim, para proprietários e administradores. | Nunca. Depois de salvo, só pode ser substituído. |
| Como chega ao agente | Direto, como variável de ambiente. | Por referência ${secret:NOME} dentro de uma variável de ambiente ou de um servidor MCP. |
| Oculto no registro da execução e nas memórias do agente | Não. | Sim. Em comentários, tarefas, base de conhecimento e chat, não. |
Os dois recursos trabalham juntos: a variável define o nome que o agente lê, e o segredo guarda o valor. Veja Segredos.
Onde configurar
No app, abra Configurações › Variáveis de ambiente, no grupo Espaço de trabalho. A aba só aparece para proprietários e administradores; para os demais membros ela não existe. Não há comando da CLI para essas variáveis.
Adicione a variável
Clique em Adicionar variável e informe a chave e o valor.
Salve
Clique em Salvar. Cada variável é gravada por conta própria: se uma falhar, as outras são salvas e a linha com problema continua na tela, com o erro.
Para editar, altere o valor e salve. A chave de uma variável existente não muda; para trocá-la, remova a variável e crie outra.
Para remover, clique na lixeira da linha. Ela fica marcada como A remover, e dá para desfazer antes de salvar. Ao salvar, o app pede confirmação listando as chaves.
Regras da chave e do valor
- A chave usa letras, números e
_, não começa com número e tem até 128 caracteres. - A chave não se repete no workspace. Maiúsculas e minúsculas contam como diferentes.
- O valor tem até 32 KB, e o workspace tem até 200 variáveis.
- Chaves que a plataforma usa por dentro são recusadas, com o aviso "Reservada pela plataforma; não é permitida". Entre elas estão as que começam com
JIRAYA_eHOME,PATH,USER,SHELL,TERM,TMPDIR,TMPeTEMP.
Usar um segredo no valor
Para um valor sensível, escreva no valor uma referência a um segredo existente:
| Chave | Valor |
|---|---|
GITHUB_TOKEN | ${secret:GITHUB_TOKEN} |
A referência também pode ficar dentro de um texto maior, como Bearer ${secret:API_TOKEN}. O que fica salvo na variável é só o texto da referência; o valor real é colocado no momento em que um agente começa a execução. Uma referência a um segredo que não existe é recusada ao salvar.
Precedência
As variáveis do workspace são aplicadas primeiro. Se um agente definir a mesma chave na aba Ambiente dele, vale o valor do agente, mesmo quando esse valor é vazio.
Nota
Referências ${secret:NOME} só são resolvidas nas variáveis e nos servidores MCP do workspace. Nas variáveis da aba Ambiente de um agente, a referência chega ao agente como texto, sem o valor do segredo.
Quando a mudança vale
As alterações valem para as próximas execuções. Execuções em andamento continuam com as variáveis que receberam ao começar.
Quem pode ver e alterar
Só proprietários e administradores leem e alteram as variáveis do workspace. Agentes não têm acesso a essa configuração; eles só recebem as variáveis no ambiente da execução. A auditoria das alterações registra as chaves, nunca os valores.
Atualizado em