docker-agent

用 Docker 把 AI 智能体打包成镜像，随处运行

docker-agent 是 Docker 工程团队开源的 AI Agent 构建与运行时框架，用 Go 语言实现。它把智能体的开发、打包和运行统一到容器化工作流中，解决智能体从本地原型到生产部署之间环境不一致、依赖难管理的问题。核心能力包括：以声明式方式定义智能体行为与工具调用，提供运行时负责调度、会话与工具执行，并借助 Docker 镜像把智能体及其依赖整体封装，实现一次构建到处运行。项目还支持把工具、模型接口等作为可组合组件接入，方便扩展和替换。对于已经使用 Docker 的团队，它能把智能体纳入现有 CI/CD、镜像仓库和编排体系，降低运维成本。项目处于成长阶段，星标约 3300，适合关注容器化智能体部署的开发者评估使用。

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3335

维护状态活跃

是否开源是

定价模式 free

项目数据

分类智能体

开发团队docker

所属国家

官网地址https://docker.github.io/docker-agent

GitHubhttps://github.com/docker/docker-agent

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agents,ai

GitHub 星标★ 3335

30天Star增速

HF 下载量

上线时间2025-09-01 00:00:00

最近更新2026-09-19 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-12

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：命令行工具 4 步

环境要求

Docker Desktop 4.63+（已预装 docker-agent CLI 插件）或 Homebrew / GitHub Releases 二进制
至少一个模型 API Key（如 OPENAI_API_KEY、ANTHROPIC_API_KEY、GOOGLE_API_KEY），或使用 Docker Mod
一个 YAML 格式的 agent 配置文件（如 agent.yaml）

安装与启动步骤

1安装 docker-agent

三种方式任选其一：Docker Desktop 4.63+ 已预装，可直接用 docker agent；Homebrew 安装；或从 GitHub Releases 下载二进制。
```
brew install docker-agent
```
2配置模型 API Key

至少设置一个模型提供方的 API Key 环境变量，或改用 Docker Model Runner 跑本地模型，否则无法调用大模型。
```
export OPENAI_API_KEY=sk-xxxxxxxx
```

3编写 agent.yaml

用声明式 YAML 定义 agent 的模型、描述、指令与工具集，工具集可引用内置工具或 MCP 服务器。

agents:
  root:
    model: openai/gpt-5-mini
    description: A helpful AI assistant
    instruction: |
      You are a knowledgeable assistant that helps users with various tasks.
      Be helpful, accurate, and concise in your responses.
    toolsets:
      - type: mcp
        ref: docker:duckduckgo

4运行你的 agent

用 docker agent run 加配置文件路径启动；不带参数则运行默认 agent，也可直接从 OCI registry 拉取运行。
```
docker agent run agent.yaml
```

关键配置

配置项	必填	说明	示例
`agents.root.model`	是	指定该 agent 使用的模型，格式为提供方/模型名	`openai/gpt-5-mini`
`agents.root.description`	否	agent 的用途描述，便于识别与多 agent 协作	`A helpful AI assistant`
`agents.root.instruction`	否	系统提示词，规定 agent 的行为与风格	`You are a knowledgeable assistant that helps users with vari`
`agents.root.toolsets`	否	agent 可用的工具集列表，支持 MCP 类型引用	`- type: mcp ref: docker:duckduckgo`
`OPENAI_API_KEY`	是	OpenAI 模型访问密钥，也可换用其他提供方密钥	`sk-xxxxxxxx`

如何确认成功

执行 docker agent run agent.yaml 后能进入对话并获得模型回复，即表示安装与配置成功。

常见问题

Q：没装 Docker Desktop 能用吗？

A：可以。用 brew install docker-agent 安装，或从 GitHub Releases 下载二进制，再直接运行 docker-agent 命令。

Q：为什么必须配置 API Key？

A：agent 需要调用大模型，未设置任何 API Key 时无法工作；也可用 Docker Model Runner 跑本地模型替代。

Q：docker agent 和 docker-agent 有什么区别？

A：docker-agent 是二进制本体，docker agent 是把它作为 Docker CLI 插件调用的方式，将二进制软链到 ~/.docker/cli-plugins/docker-agent 即可。

Q：如何分享制作好的 agent？

A：可将 agent 推送到任意 OCI registry，别人用 docker agent run myorg/agent:tag 直接拉取运行。

注意事项

Docker Desktop 4.63+ 已内置该插件，无需额外安装。
想用 docker agent 子命令需把二进制软链到 ~/.docker/cli-plugins/docker-agent。
除 OpenAI 外还支持 Anthropic、Gemini、AWS Bedrock、Mistral、xAI 及 Docker Model Runner。
更多配置示例见仓库 examples/ 目录。

核心亮点

以 Docker 镜像封装智能体及其依赖，解决环境不一致和部署难题
Go 语言实现，运行时轻量、启动快，适合容器与云原生环境
由 Docker 工程团队维护，与现有镜像仓库、CI/CD 和编排体系天然衔接

不足之处

项目较新，API 与运行时行为可能尚未稳定
生态和第三方工具集成数量有限，社区案例待积累

适用场景

把内部 AI 智能体容器化后部署到 Kubernetes 集群
在 CI/CD 流水线中构建、测试并发布智能体镜像
为不同团队提供统一、可复现的智能体运行环境

替代项目

LangChain、Dify

项目介绍

docker-agent 是一个智能体领域的开源项目，官方简介：AI Agent Builder and Runtime by Docker Engineering。项目使用 Go 开发，在 GitHub 上获得 3320 星标。

上一篇：UI-TARS-desktop

下一篇：openhanako