A CLI agentengine lê um pequeno conjunto de variáveis de ambiente que alteram o comportamento da própria CLI. Esta página documento essas entradas. As variáveis que configuram um agente implantado, a pilha de desenvolvimento local ou os contêineres gerados são documentadas com esses recursos.
Quando um comando expõe uma flag para a mesma configuração, a flag tem precedência sobre a variável de ambiente.
Verificação de atualizar
Os binários lançados verificam se há uma versão mais recente e imprimem um aviso no stderr quando ela existe. A verificação executa no máximo uma vez a cada 24 horas e registra seu estado em ~/.agentengine/update-check.json.
Defina AGENTENGINE_NO_UPDATE_CHECK=1 para desativar a verificação. A verificação também é ignorada quando a variável de ambiente CI está definida e quando o binário é uma criar de desenvolvimento local.
Telemetria
A CLI possui dois canais de relatório independentes. Ambos estão ativados por padrão em binários lançados e desativados em builds de desenvolvimento e sempre que CI está definido.
AGENTENGINE_TELEMETRY_ENABLEDcontrola a análise de uso do produto enviada ao gateway do agente mecanismo.AGENTENGINE_SENTRY_ENABLEDcontrola os relatórios de falhas e erros enviados ao Sentry. O relatório também requer um DSN do Sentry incorporado no momento de criar, que as versões de lançamento incluem.
Defina qualquer uma das variáveis como 0, false, no ou off para desativar esse canal.
A análise de produto também é desativada automaticamente para uma conta sintética (canary/teste): quando um login resolve uma conta cuja telemetria está desativada, a CLI faz o registro disso na instalação e para de enviar análises de produto — incluindo eventos pré-login — até que um login posterior como uma conta real o limpe. As variáveis acima ainda prevalecem, portanto, definir AGENTENGINE_TELEMETRY_ENABLED=0 mantém a telemetria desativada independentemente.
A análise de uso do produto faz o registro de que os recursos foram usados, não em que você os usou: cada invocação da CLI é contada com seu caminho de comando (por exemplo, agentengine dev up), um resultado de sucesso/falha e uma classe de erro geral em caso de falhas, juntamente com eventos de instalação, login e marcos de recursos. Os eventos nunca contêm argumentos de comando, caminhos de arquivo, valores secretos ou texto de mensagem de erro. Os executar antes do login são registradas sob um ID anônimo pseudônimo que é vinculado à sua conta quando você faz login.
Para o Sentry especificamente, a CLI retém o DSN incorporado em criar lançamentos, portanto, os contêineres que ele inicia não relatam até que você opte por participar. O relatório de contêiner requer tanto AGENTENGINE_SENTRY_ENABLED=1 quanto um AGENTENGINE_SENTRY_DSN explícito no ambiente, que as pilhas geradas traduzem nos nomes que os contêineres leem.
Exploração madeireira
A CLI grava um log de sessão em um arquivo no diretório de log da plataforma. As variáveis a seguir controlam esse log. Os sinalizadores --log-level, --log-file e --no-log definem o mesmo comportamento e têm precedência quando ambos estão presentes.
Variável | bandeira | Default | Efeito |
|---|---|---|---|
|
|
| Detalhamento do arquivo: |
|
| caminho com carimbo de data/hora no diretório de log da plataforma | Gravar o log neste caminho |
|
| Desconfigurar | Desativar registro de arquivo |
| — |
| Número de arquivos de log a serem retidos antes que os mais antigos sejam removidos |
| — | Desconfigurar | Desativar a poda automática de log |
Ambos os booleanos aceitam 1, true, yes ou on como verdadeiro, sem diferenciar maiúsculas de minúsculas. Qualquer outro valor, incluindo uma variável não definida, é falso. As outras variáveis nesta página indicam seus próprios valores aceitos acima.
Saída do comando
A maioria dos comandos imprime uma linha de contexto no topo da saída mostrando a organização, o projeto, o workspace e o ambiente em que o comando atuará. Defina AGENTENGINE_NO_BREADCRUMB como qualquer valor não vazio para suprimir essa linha, o que é adequado para scripts que analisam a saída do comando.
Inspeção de TLS em desenvolvimento local
agentengine dev up criar imagens locais que buscam pacotes do PyPI e npm. Em uma rede que intercepta HTTPS com uma CA da empresa, defina AGENTENGINE_CA_BUNDLE para o arquivo PEM dessa CA (ou passe --ca-bundle). A CLI o incorpora na imagem gerada antes das instalações do pacote, para que uv e npm confiem no tráfego re-assinado, e as chamadas HTTPS de tempo de execução do agente através do proxy também funcionem. A CA é registrada por workspace em ~/.agentengine/ e reutilizada em executar posteriores na mesma máquina; um valor no workspace .env é ignorado para que um repositório clonado não possa instalar uma CA. Veja Inspeção de TLS corporativa em agentengine dev up local.