A CLI resolve imagens de contêiner, agentengine create modelos iniciais e seu próprio binário de lançamento de localizações públicas: imagens do GHCR público e modelos iniciais de um repositório de exemplo público, ambos buscados sem login de registro e sem sessão de plataforma.
Esta página aborda a fonte padrão, as variáveis de substituição e os diagnósticos. Para a fonte custom e o próprio source.yaml, consulte custom-artifact-source.md.
A fonte padrão
Public é o padrão integrado. Sem nenhuma substituição definida, agentengine create, agentengine dev up e agentengine self-update resolvem coordenadas públicas.
Sobrescrever variáveis
A CLI lê um par de variáveis de substituição: AGENTENGINE_IMAGE_SOURCE e AGENTENGINE_IMAGE_SOURCE_FILE. Os nomes de legado AP_SOURCE / AP_SOURCE_FILE não são mais lidos — definir qualquer um deles faz com que o comando falhe em vez de resolver silenciosamente uma fonte diferente.
Os valores aceitos são public e custom. O valor internal desativado ainda é aceito como um alias silencioso para public. A fonte padrão é public.
migrar
AP_SOURCE e AP_SOURCE_FILE foram removidos; renomeie-os.
# beforeexport AP_SOURCE=customexport AP_SOURCE_FILE=/etc/agentic/source.yaml
# afterexport AGENTENGINE_IMAGE_SOURCE=customexport AGENTENGINE_IMAGE_SOURCE_FILE=/etc/agentic/source.yamlUma máquina que ainda define apenas AP_SOURCE falha com um erro nomeando AGENTENGINE_IMAGE_SOURCE, em vez de retornar silenciosamente para public. Esta é a quebra documentada da migração.
A fonte padrão é public. Sem nenhuma variável definida, é isso que é resolvido.
base: public em um source.yaml usa os padrões públicos, portanto, uma fonte personalizada que omite um bloco registry ou release os herda para esse bloco. O repositório de modelos do agentengine create sempre segue base:, já que source.yaml não tem campo de modelos. Fixe registry.prefix para não ser afetado. Um bloco registry fixa apenas as imagens; o repositório de modelos e o hospedar de lançamento continuam seguindo base:.
agentengine create
agentengine create busca o modelo inicial com git, do repositório de exemplos públicos para a fonte public padrão, ou do repositório com os nomes custom source.yaml. Ele precisa de git no PATH e nenhuma sessão de plataforma.
agentengine dev up
As imagens de primeira parte vêm do GHCR público (ghcr.io/mongodb/agent-engine-client-libraries) sem login de registro.
Diagnóstico
agentengine version --full imprime a versão e o registro da fonte personalizada quando AGENTENGINE_IMAGE_SOURCE=custom. Com a fonte pública padrão, ele não adiciona linhas de origem.