로컬 개발 환경을 시작합니다.
Synopsis
로컬 개발 스택을 시작합니다.
핫 리로드가 기본값입니다. 앱 컨테이너가 애플리케이션 프로세스를 실행하고 파일 감시 기능이 변경 사항 발생 시 프로세스를 다시 시작합니다. --isolated는 프로세스당 하나의 컨테이너를 실행하며 변경 사항이 있을 때마다 다시 빌드해야 합니다.
--all은 공유 프로젝트 서비스와 함께 하나의 UI 아래에서 모든 에이전트를 시작합니다. 핫 리로드만 지원하며, --isolated, --headless, --with-egress 옵션과 함께 사용하면 거부됩니다.
memory-서버는 프로젝트-config.yaml의 memory: 섹션에서 구성됩니다. 단일 에이전트 실행은 에이전트 디렉토리 이상에서 가장 가까운 파일을 사용하고 리포지토리 루트에서 중지되므로 작업 영역 파일이 모노레포 루트의 파일을 재정의합니다. --all은 모노레포 루트의 파일만 읽습니다. 에이전트 프로젝트의 경우 agent.yaml의 features.memory도 memory-서버 실행 여부를 제어합니다. 메모리 전용 프로젝트는 항상 하나를 시작합니다.
로컬 이그레스(egress)는 기본값으로 설정되어 있습니다. --no-egress는 CONNECT 프록시를 건너뛰고 인터넷을 엽니다. --with-egress는 프록시를 강제로 켜는 더 이상 사용되지 않는 별칭입니다.
artifact_repositories를 선언하는 에이전트는 비개 PyPI 인덱스용 레지스트리 인증을 받습니다. 인증은 UV_INDEX_*재정의에서 먼저 해결되고, 그 다음에 .env 파일에서 해결됩니다. 비밀, 그 다음에 발급된 AWS CodeArtifact 토큰. --no-artifact-auth는 UV_INDEX_*자격 증명을 사용자에게 맡긱니다.
TLS 검사 프록시(예시: Zscaler)가 HTTPS를 다시 서명할 때 로컬 이미지 빌드에서 회사 인터셉트 CA를 신뢰하려면 --ca-bundle을 사용하세요. PEM은 이 머신에서 나중에 실행할 때 재사용하기 위해 ~/.agentengine/ 아래의 각 작업 공간에 기록됩니다. 생성된 이미지는 승인된 복사본을 포함하며 리포지토리 콘텐츠는 신뢰의 원본이 아닙니다. AGENTENGINE_CA_BUNDLE은 동등한 프로세스 환경 대체입니다. 작업 공간 .env 값은 무시됩니다. 이전에 제공된 CA에 대한 신뢰를 중지하려면 --clear-ca-bundle을 사용하세요.
agentengine dev up [flags]옵션
--all Monorepo: start all agents under a single UI --ca-bundle string PEM file of extra CA certificates to trust in local image builds (TLS-inspecting proxies). Recorded per workspace under ~/.agentengine/ and reused on later runs. Also AGENTENGINE_CA_BUNDLE. --clear-ca-bundle Remove a previously persisted extra CA and build without it --headless Omit the playground UI service (for CI and automated testing)-h, --help help for up --isolated Run each process in its own container to simulate production --local-sdk string Install SDK from local source instead of pre-built wheels. Also hot-reloads playground UI (unless --headless) from the same SDK checkout. Pass the path to the client-libraries checkout root. --no-artifact-auth Skip auto-configuring registry auth for declared artifact_repositories --no-cache Build images without Docker layer cache --no-egress Do not start the local CONNECT proxy (open internet) --with-egress Force local egress even if preflight would skip (deprecated alias; default is on) --workspace string Monorepo: target a specific agent by name (from root agent.yaml)부모 명령에서 상속된 옵션
--log-file string override log file path --log-level string file log verbosity (error|warn|info|debug) (default "info") --no-log disable file logging-q, --quiet silence stderr below error-v, --verbose count raise stderr verbosity (-v info, -vv debug)다음도 참조하세요.
- agentengine dev - 로컬 개발 환경 명령.