docker-agent

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 550 🐛 待处理 76 👀 关注 17

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4652

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，定价信息待确认

项目预览

docker-agent 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队docker

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

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

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agents,ai

GitHub 星标★ 4652

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

代码更新2026-11-04

仓库体积88.1 MB

本站数据更新2026-11-04

维护状态活跃

收录时间2026-09-12

浏览次数2

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-12 · 当前星标 ★ 4652

技术标签

agents ai

使用教程

难度：入门约 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`