agentengine CLI는 CLI 자체의 동작을 변경하는 소규모 환경 변수 세트를 읽습니다. 이 페이지는 이러한 입력을 문서화합니다. 배포된 에이전트, 로컬 개발 스택 또는 생성된 컨테이너를 구성하는 변수는 해당 기능과 함께 문서화됩니다.
명령어에서 동일한 설정에 대한 플래그를 노출하는 경우, 환경 변수보다 플래그가 우선합니다.
업데이트 확인
릴리스된 바이너리는 더 최신 버전이 있는지 확인하고, 버전이 존재하면 stderr에 알림을 출력합니다. 이 확인은 최대 24 시간마다 한 번씩 실행되며 그 상태를 ~/.agentengine/update-check.json에 기록합니다.
AGENTENGINE_NO_UPDATE_CHECK=1을(를) 설정하여 확인을 비활성화합니다. CI 환경 변수가 설정되어 있거나 바이너리가 로컬 개발 빌드인 경우에도 확인이 건너뜁니다.
텔레메트리
CLI에는 두 개의 독립적인 보고 채널이 있습니다. 둘 다 릴리스된 바이너리에서는 기본적으로 켜져 있고, 개발 빌드 및 CI이 설정된 경우에는 꺼져 있습니다.
AGENTENGINE_TELEMETRY_ENABLED에이전트 엔진 게이트웨이로 전송되는 제품 사용 분석을 제어합니다.AGENTENGINE_SENTRY_ENABLEDSentry로 전송되는 충돌 및 오류 보고서를 제어합니다. 보고 기능을 사용하려면 빌드 시 Sentry DSN이 포함되어야 하며, 릴리스 빌드에는 이 DSN이 포함되어 있습니다.
해당 채널을 비활성화하려면 두 변수 중 하나를 0, false, no 또는 off으로 설정하세요.
제품 분석은 합성(카나리/테스트) 계정에 대해서도 자동으로 옵트아웃됩니다. 로그인이 원격 분석이 비활성화된 계정으로 확인되면 CLI는 설치 시 이를 기록하고 실제 계정으로 나중에 로그인하여 지울 때까지 사전 로그인 이벤트를 포함한 제품 분석 전송을 중단합니다. 위의 변수가 여전히 우선하므로 AGENTENGINE_TELEMETRY_ENABLED=0을(를) 설정하면 원격 분석이 계속 꺼져 있습니다.
제품 사용 분석은 기능이 사용되었다는 사실을 기록하며, 무엇에 사용되었는지는 기록하지 않습니다. 각 CLI 호출은 명령 경로(예시 agentengine dev up), 성공/실패 결과, 실패 시 대략적인 오류 클래스, 설치, 로그인 및 기능 마일스톤 이벤트와 함께 집계됩니다. 이벤트에는 명령 인수, 파일 경로, 비밀 값 또는 오류 메시지 텍스트가 포함되지 않습니다. 로그인 전 실행은 로그인 시 계정에 연결되는 가명 ID로 기록됩니다.
Sentry의 경우, CLI는 릴리스 빌드에 포함된 DSN을 제공하지 않습니다. 따라서 CLI가 시작하는 컨테이너는 사용자가 승인할 때까지 보고하지 않습니다. 컨테이너 보고에는 환경에서 AGENTENGINE_SENTRY_ENABLED=1과 명시적인 AGENTENGINE_SENTRY_DSN 모두 필요하며, 생성된 스택이 컨테이너가 읽는 이름으로 변환합니다.
로깅
CLI는 플랫폼 로그 디렉토리 아래의 파일에 세션 로그를 쓰기 (write)합니다. 다음 변수는 해당 로그를 제어합니다. 플래그 --log-level, --log-file, --no-log는 동일한 동작을 설정하며, 두 개 이상이 있는 경우 우선시됩니다.
변수 | 플래그 | 기본값 | 효과 |
|---|---|---|---|
|
|
| 파일 상세 수준: |
|
| 플랫폼 로그 디렉토리의 타임스탬프가 찍힌 경로 | 이 경로에 로그를 쓰기 (write)하십시오. |
|
| Unset | 파일 로깅 비활성화 |
| — |
| 가장 오래된 파일이 삭제되기 전에 보관할 로그 파일 수 |
| — | Unset | 자동 로그 정리 비활성화 |
이 두 불리언 값은 대소문자를 구분하지 않고 1, true, yes 또는 on을(를) true로 허용합니다. 설정되지 않은 변수를 포함한 다른 모든 값은 false입니다. 이 페이지의 다른 변수들은 각각 위에서 허용되는 값을 명시합니다.
명령 출력
대부분의 명령은 출력 상단에 명령이 적용될 조직, 프로젝트, 워크스페이스 및 환경을 보여주는 컨텍스트 줄을 출력합니다. 명령 출력을 구문 분석하는 스크립트에 적합하도록 해당 줄을 표시하지 않으려면 AGENTENGINE_NO_BREADCRUMB을(를) 비어 있지 않은 값으로 설정하세요.
로컬 개발 TLS 검사
agentengine dev up PyPI 및 npm에서 패키지를 가져오는 로컬 이미지를 빌드합니다. 회사 CA를 사용하여 HTTPS를 가로채는 네트워크에서는 AGENTENGINE_CA_BUNDLE을(를) 해당 CA의 PEM 파일로 설정하거나 --ca-bundle을(를) 전달하세요. CLI는 패키지 설치 전에 생성된 이미지에 이를 포함하므로 uv 및 npm은 재서명된 트래픽을 신뢰하며, 프록시를 통한 에이전트의 런타임 HTTPS 호출도 작동합니다. CA는 ~/.agentengine/ 아래의 작업 영역별로 기록되며 동일한 머신에서 나중에 실행할 때 재사용됩니다. 작업 영역 .env의 값은 무시되므로 복제된 리포지토리는 CA를 설치할 수 없습니다. 로컬 agentengine dev up의 기업 TLS 검사를 참조하세요.