Inicie o ambiente de desenvolvimento local.
Synopsis
Inicie a pilha de desenvolvimento local.
O hot reload é o padrão: o contêiner do aplicativo executa os processos do aplicativo e o monitoramento de arquivos os reinicia quando há alterações. --isolated executa um contêiner por processo e precisa de uma reconstrução para alterações.
--all inicia todos os agentes em uma única IU com serviços de projeto compartilhados. Ele suporta apenas hot reload e não é compatível com --isolated, --headless e --with-egress.
O memory-servidor é configurado a partir da seção memory: de um projeto-config.yaml. Um executar de agente único usa o mais próximo no diretório do agente ou acima dele, parando na raiz do repositório, portanto, um arquivo de workspace substitui o da raiz do monorepo. --all lê apenas o arquivo da raiz do monorepo. Para um projeto de agente, features.memory em agent.yaml também controla se um memory-servidor é executado. Um projeto somente de memória sempre inicia um.
A saída local está ativada por padrão. --no-egress ignora o proxy CONNECT e abre a internet. --with-egress é um alias obsoleto que força a ativação do proxy.
Agentes que declaram artifact_repositories obtêm autenticação de registro para índices PyPI privados, resolvida de uma substituição UV_INDEX_*, então um .env segredo e, em seguida, um token AWS CodeArtifact emitido. --no-artifact-auth deixa as credenciais UV_INDEX_* com você.
Use --ca-bundle para confiar em uma CA de interceptação da empresa em criar de imagem locais quando um proxy de inspeção TLS (por exemplo, Zscaler) assina novamente o HTTPS. O PEM é registrado por workspace em ~/.agentengine/ e reutilizado em executar posteriores nesta máquina; a imagem gerada incorpora a cópia autorizada, e o conteúdo do repositório nunca é uma fonte de confiança. AGENTENGINE_CA_BUNDLE é um fallback de ambiente de processo equivalente; um .env de workspace o valor é ignorado. Use --clear-ca-bundle para parar de confiar em uma CA fornecida anteriormente.
agentengine dev up [flags]Opções
--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)Opções herdadas dos comandos pai
--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)Veja também
- agentengine dev - Comandos do ambiente de desenvolvimento local.