Ambiente

O painel Ambiente define variáveis de ambiente simples que são exportadas para todas as shells na VM do espaço de trabalho. São botões de configuração não secretos — níveis de registo, sinalizadores de funcionalidades, interruptores de compilação — que pretende ter presentes no ambiente do agente sem ligar qualquer mecanismo de troca ou de credenciais.

A legenda do painel indica tanto o que faz como aquilo para que não serve: Pares KEY=VALUE simples exportados para todas as shells na VM através de proxy.env (obtidos de .bashrc). Sem substituição por proxy — os valores chegam à VM verbatim, por isso não coloque segredos aqui. Bom para níveis de registo, sinalizadores de funcionalidades e interruptores de compilação. Sem nada configurado, apresenta Nenhuma variável de ambiente configurada.

Como as variáveis são exportadas

Cada variável que adiciona é escrita em proxy.env, um ficheiro na partilha de metadados do espaço de trabalho que o .bashrc gerido obtém para todas as shells. Isto significa que o valor está presente em todos os separadores de terminal, em todos os comandos que o agente executa e em todas as shells de sessão e de não sessão — verbatim, exatamente como o escreveu. Não há qualquer engodo brm_… nem troca na transmissão: este painel é uma passagem direta, o que é precisamente a razão pela qual os segredos não pertencem aqui.

Se precisar que a VM guarde um token ou uma palavra-passe, use antes o painel Credenciais. Qualquer coisa definida aí é injetada como engodo e trocada pelo valor real na transmissão; um segredo escrito no painel Ambiente chegaria, em vez disso, ao interior da sandbox em texto simples.

Adicionar e editar variáveis

Clique em Adicionar variável para acrescentar uma linha. Cada linha é um campo Nome e um campo Valor, com um botão de menos para a remover.

O nome é validado em relação à regra de identificador de shell [A-Za-z_][A-Za-z0-9_]* — tem de começar por uma letra ou um sublinhado e conter apenas letras, dígitos e sublinhados. Um nome que não corresponda mostra um aviso laranja em linha e não é exportado. O valor não tem restrições e é utilizado exatamente como escrito.

Dica: Agrupe interruptores relacionados num espaço de trabalho e deixe um espaço de trabalho de rascunho vazio. Como estas variáveis são por espaço de trabalho, um espaço de trabalho afinado para depuração detalhada (RUST_LOG=debug, NODE_ENV=development) mantém-se separado de outro configurado para uma compilação limpa semelhante à de produção.

Atualização em tempo real numa sessão em execução

Editar este painel e guardar não exige reiniciar a VM. O Bromure Agentic Coding incrementa um contador interno env.generation e reescreve o proxy.env; as novas shells abertas após a gravação voltam a obtê-lo e veem os valores atualizados de imediato. Um agente em primeiro plano que já esteja em execução mantém o ambiente com que arrancou até terminar — um novo prompt (ou um novo separador) capta a alteração.

Embora estes valores sejam não secretos por intenção, são ainda assim armazenados no blob encriptado secrets.enc do espaço de trabalho ao guardar, juntamente com os restantes dados do painel, em vez de no profile.json em texto simples.

Referência de definições

Capítulos relacionados

• Credenciais — onde os segredos pertencem; injetados como engodos e trocados na transmissão.
• MCP — configuração de servidores de ferramentas, alguns dos quais leem variáveis de ambiente.
• Referência de definições — todos os painéis num relance.