Docker Agent 和 Gordon 区别:一张表选对封面图
Agent 与 Skills约 7 分钟

Docker Agent 和 Gordon 区别:一张表选对

AI 指南··◉ 0 浏览

一句话拆开: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)。这就是全文答案。

Docker 官方 docker-agent 仓库截图,4.6k 星,AI Agent Builder and Runtime

一张表看清六个维度

维度 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 转:

  1. 解释、评分、优化 Dockerfile,用的是最新版 Docker 的能力
  2. 结合本地上下文给出合适的 docker run 命令,能检查端口占用、卷冲突
  3. 回答 Docker 全家桶的问题,答案基于官方最新文档并附来源链接
  4. 把软件项目容器化,处理 Docker 相关的 GitHub Actions
  5. 容器启动失败时给出修复建议,针对容器、镜像、卷提供上下文帮助
  6. 可以通过目录级的 MCP server 增强回答

它明确不做的事:不帮你编排多 Agent 团队,不给你一套 YAML schema 让你定义角色分工。

Docker Desktop 中开启 Gordon 的 Settings 界面截图

启用方式见 官方 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 由五个关键属性定义:

  1. model:用哪个模型,不同 Agent 可以用不同模型
  2. description:角色的简短摘要,用来判断什么时候该把任务派给它
  3. instruction:详细指令,含工作流、约束和领域知识
  4. sub_agents:这个 Agent 能派活给谁,构成团队层级
  5. 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。

Docker Sandboxes 与 Docker Agent 配合的隔离工作流示意图

场景判断:你要干的活选哪个

你的场景 选谁 为什么
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,同目录重复执行会复用已有容器,改配置得先删再建。

先跑通最短路径

按三步走:

  1. 排障需求:装最新 Docker Desktop,Settings 里打开 Docker AI,直接在对话框问容器问题,不用写配置
  2. 编排需求:brew install docker-agent 或升级 Docker Desktop 到 4.63+,导出 ANTHROPIC_API_KEY 之类你要的那家 Key
  3. 存官方示例,执行 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)。

评论 (0)

?
0/1

还没有评论,来发第一条吧

网站上的服务均为第三方提供,
请用户注意自行甄别。

北京酷讯互动科技有限公司

备案京ICP备2024094994号-29

© 2026 AI345 · All Rights Reserved

用户服务协议·隐私政策