CLI 从公共位置解析容器镜像、agentengine create 入门模板及其自身的发布二进制文件：镜像来自公共 GHCR，入门模板来自公共示例存储库，两者均在无需注册表登录和平台会话的情况下获取。
本页面介绍了默认源、覆盖变量和诊断信息。有关 custom 源和 source.yaml 本身的信息，请参阅 custom-artifact-source.md。
默认源
Public 是内置的默认设置。如果未设置覆盖，agentengine create、agentengine dev up 和 agentengine self-update 都会解析公共坐标。
覆盖变量
CLI 读取一对覆盖变量：AGENTENGINE_IMAGE_SOURCE 和 AGENTENGINE_IMAGE_SOURCE_FILE。旧版 AP_SOURCE / AP_SOURCE_FILE 名称不再被读取——设置其中任何一个都会导致命令失败，而不是静默解析为不同的源。
接受的值为 public 和 custom。已弃用的 internal 值仍被接受为 public 的静默别名。默认源为 public。
迁移
AP_SOURCE 以及 AP_SOURCE_FILE 已被移除；请重命名它们。
# beforeexport AP_SOURCE=customexport AP_SOURCE_FILE=/etc/agentic/source.yaml
# afterexport AGENTENGINE_IMAGE_SOURCE=customexport AGENTENGINE_IMAGE_SOURCE_FILE=/etc/agentic/source.yaml如果一台机器仍然只设置了 AP_SOURCE，则会报错并指出 AGENTENGINE_IMAGE_SOURCE，而不是静默回退到 public。这是记录在案的迁移中断。
默认源是 public如果没有设置变量，这就是解析的结果。
base: public 在 source.yaml 中使用公共默认值，因此省略 registry 或 release 块的自定义源会为该块继承它们。agentengine create 的模板存储库始终遵循 base:，因为 source.yaml 没有模板字段。固定 registry.prefix 以不受影响。registry 块仅固定镜像；模板存储库和发布托管继续遵循 base:。
agentengine create
agentengine create 使用 git 从公共示例存储库获取默认 public 源的入门模板，或从 custom source.yaml 名称的存储库获取。它需要在 PATH 上有 git 且没有平台会话。
agentengine dev up
第一方镜像来自公共 GHCR (ghcr.io/mongodb/agent-engine-client-libraries)，无需注册表登录。
诊断
agentengine version --full 当 AGENTENGINE_IMAGE_SOURCE=custom 时，打印自定义源的版本和注册表。使用默认的公共源时，它不会添加任何源行。