El CLI de agentengine lee un pequeño conjunto de variables de entorno que cambian el comportamiento del propio CLI. Esta página documenta esas entradas. Las variables que configuran un agente implementado, la pila de desarrollo local o los contenedores generados se documentan con esas funcionalidades.
Cuando un comando expone un indicador para la misma configuración, el indicador tiene prioridad sobre la variable de entorno.
Verificación de actualizar
Los binarios publicados comprueban si hay una versión más reciente e imprimen un aviso en stderr cuando existe una. La comprobación se ejecuta como máximo una vez cada 24 horas y registro su estado en ~/.agentengine/update-check.json.
Establezca AGENTENGINE_NO_UPDATE_CHECK=1 para deshabilitar la comprobación. La comprobación también se omite cuando se establece la variable de entorno CI y cuando el binario es una compilar de desarrollo local.
Telemetría
La CLI tiene dos canales de reporte independientes. Ambos están activados por defecto en los binarios publicados y desactivados en las compilar de desarrollo y siempre que se establezca CI.
AGENTENGINE_TELEMETRY_ENABLEDcontrola los análisis de uso del producto enviados a la puerta de enlace del motor de agente.AGENTENGINE_SENTRY_ENABLEDcontrola los informes de bloqueos y errores enviados a Sentry. El reporte también requiere un DSN de Sentry incrustado en el momento de compilar, que las versiones de lanzamiento que se compilan incluyen.
Establezca cualquiera de las variables en 0, false, no o off para deshabilitar ese canal.
El análisis de productos también se desactiva automáticamente para una cuenta sintética (canary/test): cuando un inicio de sesión resuelve una cuenta cuya telemetría está desactivada, la CLI registra eso en la instalación y deja de enviar análisis de productos, incluidos los eventos previos al inicio de sesión, hasta que un inicio de sesión posterior como cuenta real lo borre. Las variables anteriores siguen teniendo prioridad, por lo que establecer AGENTENGINE_TELEMETRY_ENABLED=0 mantiene la telemetría desactivada independientemente.
Los análisis de uso del producto registran que se utilizaron funcionalidades, no en qué se utilizaron: cada invocación de la CLI se cuenta con su ruta de comando (por ejemplo, agentengine dev up), un resultado de éxito/fallo y una clase de error general en caso de fallo, junto con eventos de instalación, inicio de sesión y hitos de funcionalidad. Los eventos nunca contienen argumentos de comando, rutas de archivo, valores secretos o texto de mensajes de error. Ejecutar antes del inicio de sesión se registran bajo un ID anónimo seudónimo que se vincula a su cuenta cuando inicia sesión.
Para Sentry específicamente, la CLI retiene el DSN incrustado en compilar de lanzamiento, por lo que los contenedores que inicia no informan hasta que usted se suscribe. El reporte de contenedores requiere tanto AGENTENGINE_SENTRY_ENABLED=1 como un AGENTENGINE_SENTRY_DSN explícito en el entorno, que las pilas generadas traducen en los nombres que leen los contenedores.
Registro
La CLI escribe un registro de sesión en un archivo en el directorio de registros de la plataforma. Las siguientes variables controlan ese registro. Los indicadores --log-level, --log-file y --no-log establecen el mismo comportamiento y tienen prioridad cuando ambos están presentes.
Variable | Flag | predeterminado | Efecto |
|---|---|---|---|
|
|
| Nivel de verbosidad del archivo: |
|
| ruta con marca de tiempo en el directorio de registro de la plataforma | guardar el registro en esta ruta |
|
| Sin establecer | Deshabilitar registro en archivo |
| — |
| Número de entradas de registro a conservar antes de que se purguen los más antiguos |
| — | Sin establecer | Desactivar la depuración automática de registros |
Ambos de estos booleanos aceptan 1, true, yes o on como verdadero, sin distinguir entre mayúsculas y minúsculas. Cualquier otro valor, incluyendo una variable no definida, es falso. Las otras variables de esta página establecen sus propios valores aceptados arriba.
Salida de comando
La mayoría de los comandos imprimen una línea de contexto en la parte superior de su salida, mostrando la organización, el Proyecto, el espacio de trabajo y el entorno sobre los que actuará el comando. Establezca AGENTENGINE_NO_BREADCRUMB en cualquier valor no vacío para suprimir esa línea, lo que es adecuado para script que analizan la salida de comandos.
Inspección TLS de desarrollo local
agentengine dev up compilar imágenes locales que obtienen paquetes de PyPI y npm. En una red que intercepta HTTPS con una CA de empresa, establezca AGENTENGINE_CA_BUNDLE en el archivo PEM de esa CA (o pase --ca-bundle). La CLI lo incorpora en la imagen generada antes de las instalaciones de paquetes, por lo que uv y npm confían en el tráfico vuelto a firmar, y el agente también puede llamar por HTTPS a través del proxy en tiempo de ejecución. La CA se registra por espacio de trabajo en ~/.agentengine/ y se reutiliza en ejecutar posteriores en la misma máquina; se ignora un valor en el espacio de trabajo .env para que un repositorio clonado no pueda instalar una CA. Consulte Inspección de TLS corporativa en agentengine dev up local.