
Docker Agent 和 Gordon 区别:一张表选对
一句话拆开:Gordon 是 Docker 内置的 AI 助手,docker-agent 是 Docker 开源的 Agent 编排框架,两个东西共用「Docker Agent」这个叫法,但解决的是完全不同的问题。
搜「Docker Agent」的人会撞上两个官方页面,CSDN 教程又各讲一半,结果有人想排障却装了编排框架。
Docker 官方文档自己在 docker-agent 页面顶部写了划分线:Docker Agent 是构建和运行自定义 agent 团队的框架,内置的 AI 助手请看 Gordon(docker ai)(Docker Docs·Docker Agent)。这就是全文答案。

一张表看清六个维度
| 维度 | Gordon(内置助手) | docker-agent(开源框架) |
|---|---|---|
| 它是什么 | Docker Desktop / CLI 内嵌的 AI 助手 | 用 YAML 声明多 Agent 团队的开源框架 |
| 解决什么问题 | 写 Dockerfile、排容器故障、解释 Docker 概念 | 把复杂任务拆给多个专职 Agent 协作完成 |
| 部署形态 | 装一个 Docker Desktop 就有 | 需装 CLI 插件或独立二进制 |
| 调用方式 | Docker Desktop 图形界面或终端 | docker agent run xxx.yaml |
| 是否需要自己写配置 | 不需要,直接提问 | 需要,核心产出就是那份 YAML |
| 典型用户 | 日常做容器化、偶尔卡住的开发者 | 想搭 agent 工作流、跑多角色协作的人 |
看完表还拿不准,用这条规则:你打开它时心里想的是「帮我看看这个容器为什么起不来」,那是 Gordon;你想的是「我有一批活要分给不同角色处理」,那是 docker-agent。
名字容易混,是因为它换过三次叫法
这段变更史是搜索混乱的真正源头。
2025 年 2 月,Docker 发布内嵌 AI 助手 beta 版,当时叫 Project: Gordon,嵌在 Docker Desktop 和 CLI 里,帮你跑容器、写 Dockerfile、排查问题。
后来开源编排工具上线,最初叫 cagent,仓库挂在 github.com/docker/cagent,用 YAML 定义 root agent 和 sub_agents。Docker Desktop 4.49 到 4.62 期间,这个功能就叫 cagent。
到 4.63,它正式改名 Docker Agent,仓库迁到 github.com/docker/docker-agent,二进制名从 cagent 变成 docker-agent 并随版本内置。
所以讲「cagent 安装」的老教程,讲的就是今天的 docker-agent,agents: 根节点、root、sub_agents 写法都没变。
Gordon 到底能干什么
按官方 beta 发布博文的描述,Gordon 的能力边界都围着 Docker 转:
- 解释、评分、优化 Dockerfile,用的是最新版 Docker 的能力
- 结合本地上下文给出合适的
docker run命令,能检查端口占用、卷冲突 - 回答 Docker 全家桶的问题,答案基于官方最新文档并附来源链接
- 把软件项目容器化,处理 Docker 相关的 GitHub Actions
- 容器启动失败时给出修复建议,针对容器、镜像、卷提供上下文帮助
- 可以通过目录级的 MCP server 增强回答
它明确不做的事:不帮你编排多 Agent 团队,不给你一套 YAML schema 让你定义角色分工。

启用方式见 官方 beta 发布博文:装好最新 Docker Desktop,进 Settings 的 Features in Development 打开 Docker AI,再到 General 开启 Docker terminal。默认关闭,得手动开。企业版需管理员先在 Settings Management 为组织开启。
docker-agent 的模型:root 带 sub_agents
docker-agent 的核心思路是不再让一个通用模型干所有事,而是定义一组有明确角色的 Agent 互相协作。官方博客给的开发团队示例里,root agent 扮产品经理,往下派给 designer 做线框、awesome_engineer 写前端后端、qa 测试、fixer_engineer 修 bug。
每个 Agent 由五个关键属性定义:
model:用哪个模型,不同 Agent 可以用不同模型description:角色的简短摘要,用来判断什么时候该把任务派给它instruction:详细指令,含工作流、约束和领域知识sub_agents:这个 Agent 能派活给谁,构成团队层级toolsets:可用工具,内置的有 filesystem、shell、think、todo、memory 和 mcp
几个设计上值得一提的点:每个 Agent 有自己的模型和自己的上下文,Agent 之间不共享知识,上下文污染在结构上被隔离掉了。配置可以包成 OCI artifact,用 docker agent share push 像推镜像一样推到 Docker Hub,别人 share pull 就能跑。
要跑起来,最短路径三行:装好 Docker Desktop 4.63 以上(或 brew install docker-agent),导出模型厂商的 API Key,然后 docker agent run debugger.yaml。

场景判断:你要干的活选哪个
| 你的场景 | 选谁 | 为什么 |
|---|---|---|
| Dockerfile 语义看不懂,想让它解释并优化 | Gordon | 这是它的核心能力,不用写配置 |
| 容器起不来,报错看不懂 | Gordon | 官方明确定位含容器启动失败修复建议 |
| 想给项目做容器化但不会写 | Gordon | 内置能力,直接说需求 |
| 想把一个需求拆给设计、开发、测试多个角色 | docker-agent | 需要 sub_agents 定义团队 |
| 想让多个 Agent 各用不同模型(贵的干难活) | docker-agent | 每个 Agent 可独立指定 model |
| 想把 agent 团队打包分享给同事 | docker-agent | 配置是 OCI artifact 可推拉 |
| 想在隔离环境里让 Agent 自由跑命令 | docker-agent + Sandboxes | 两个配套使用 |
安全这块要单独说一句
Agent 团队要读写文件、执行 shell、调外部 API、跑可能不可信的代码。给 AI 完全访问开发机是危险的,配错了可能删文件、泄密。
Docker 的解法是 Sandboxes。从 Docker Desktop 4.60 起,sandbox 跑在专用 microVM 里,安全边界比传统容器更强。docker sandbox run <agent> 会建隔离工作区,把项目目录挂在同一个绝对路径,保留 Git 配置,不继承当前 shell 环境变量,还能配允许/拒绝网络名单(Docker 博客·AI Teams 与 Sandboxes)。
两个限制要提前知道:microVM 类型需要 macOS 或 Windows,Linux 只能用 4.57 以上的旧版容器型 sandbox;Docker 强制一工作区一 sandbox,同目录重复执行会复用已有容器,改配置得先删再建。
先跑通最短路径
按三步走:
- 排障需求:装最新 Docker Desktop,Settings 里打开 Docker AI,直接在对话框问容器问题,不用写配置
- 编排需求:
brew install docker-agent或升级 Docker Desktop 到 4.63+,导出ANTHROPIC_API_KEY之类你要的那家 Key - 存官方示例,执行
docker agent run debugger.yaml,先跑通一个 root 加一个 sub_agent,再往上加角色
老装法可以对照 Docker Agent / cagent 安装指南,命令是同一套。
AI345 · 最后更新:2026 年 10 月
常见问题
Docker Agent 和 Gordon 是同一个工具吗
不是。Gordon 是内嵌在 Docker Desktop 和 CLI 里的 AI 助手,负责写 Dockerfile、排容器故障、答 Docker 问题;docker-agent 是开源的多 Agent 编排框架,用 YAML 定义团队。官方文档顶部已明确指路:找内置助手去看 Gordon。
cagent 和 docker-agent 有什么区别
同一个东西的旧名和新名。4.49 到 4.62 叫 cagent,4.63 起改名 Docker Agent,仓库和二进制名一并换掉,老教程的安装步骤仍然适用。
Docker Agent 免费吗
工具本身开源,但要接模型 API Key,费用归模型厂商,Sandboxes 的 microVM 隔离还依赖 Docker Desktop 版本。额度细节见 [Docker Agent 免费吗](https://www.ai345.info/ai-guide/docker-agent-free-guide)。
Docker Agent 要写 YAML 吗,不写能不能用
要写。YAML 就是这个工具的核心产出物。不想写配置,说明你要的大概率是 Gordon 而不是 docker-agent。写法见 [Docker Agent YAML 配置教程](https://www.ai345.info/ai-guide/docker-agent-yaml-tutorial)。
Docker Agent 和 Claude Code 哪个好
不是一回事。Claude Code 是单个编码 Agent,docker-agent 是编排多个 Agent 的框架,你可以在某个 sub_agent 里指定 Claude 模型。取舍见 [Docker Agent 与 Claude Code 对比](https://www.ai345.info/ai-guide/docker-agent-vs-claude-code)。

京ICP备2024094994号-29