docker/docker-agent
GitHub: docker/docker-agent
Docker 官方的 AI 代理构建运行时，通过 YAML 声明式配置实现无代码多代理协作系统。
Stars: 2074 | Forks: 265
# 🤖 Docker Agent 🤖
## 什么是 Docker Agent？
`docker-agent` 让你能够创建并运行智能 AI 代理（Agent），这些代理可以相互协作以解决复杂问题 —— 无需编写代码。
`docker-agent` 是一个 `docker` CLI 插件，可以通过 `docker agent` 运行。
在 YAML 中定义代理，赋予它们工具，然后让它们开始工作。
```
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
```
```
docker agent run agent.yaml
```
## 核心功能
- **多代理架构 (Multi-agent architecture)** — 创建专业化的代理团队，自动委派任务
- **丰富的工具生态** — 内置工具 + 任何 [MCP](https://modelcontextprotocol.io/) 服务器（本地、远程或基于 Docker）
- **AI 提供商无关** — 支持 OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、xAI、[Docker Model Runner](https://docs.docker.com/ai/model-runner/) 等
- **YAML 配置** — 声明式、可版本控制、可共享
- **高级推理能力** — 内置思考、待办 和记忆 工具
- **RAG** — 可插拔检索，支持 BM25、embeddings、混合搜索 和重排序
- **打包与分享** — 将代理推送到任何 OCI registry，并在任何地方拉取运行
## 安装
**Docker Desktop** (4.63+) — docker-agent CLI 插件已预装。直接运行 `docker agent` 即可。
**Homebrew** — `brew install docker-agent`。直接运行 `docker-agent`，或者将二进制文件符号链接到 `~/.docker/cli-plugins/docker-agent`，然后运行 `docker agent`。
**二进制发布版** — 从 [GitHub Releases](https://github.com/docker/docker-agent/releases) 下载。将 `docker-agent` 二进制文件符号链接到 `~/.docker/cli-plugins/docker-agent` 即可使用 `docker agent`，或者直接使用 `docker-agent`。
至少设置一个 API 密钥（或使用 [Docker Model Runner](https://docs.docker.com/ai/model-runner/) 运行本地模型）：
```
export OPENAI_API_KEY=sk-... # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.
```
## 快速开始
```
# 运行默认 agent
docker agent run
# 从 agent 目录运行
docker agent run agentcatalog/pirate
# 交互式生成新 agent
docker agent new
# 运行自定义 config
docker agent run agent.yaml
```
更多示例请参见 [`examples/`](examples/README.md) 目录。
## 文档
📖 **[完整文档](https://docker.github.io/docker-agent/)**
- [安装](https://docker.github.io/docker-agent/#getting-started/installation) · [快速开始](https://docker.github.io/docker-agent/#getting-started/quickstart)
- [代理](https://docker.github.io/docker-agent/#concepts/agents) · [模型](https://docker.github.io/docker-agent/#concepts/models) · [工具](https://docker.github.io/docker-agent/#concepts/tools) · [多代理](https://docker.github.io/docker-agent/#concepts/multi-agent)
- [配置参考](https://docker.github.io/docker-agent/#configuration/overview)
- [TUI](https://docker.github.io/docker-agent/#features/tui) · [CLI](https://docker.github.io/docker-agent/#features/cli) · [MCP 模式](https://docker.github.io/docker-agent/#features/mcp-mode) · [RAG](https://docker.github.io/docker-agent/#features/rag)
- [模型提供商](https://docker.github.io/docker-agent/#providers/overview) · [Docker Model Runner](https://docker.github.io/docker-agent/#providers/dmr)
## 遥测
我们收集匿名使用数据以改进此工具。参见 [遥测](https://docker.github.io/docker-agent/#community/telemetry)。
## 社区
[Docker Community Slack](http://dockr.ly/comm-slack) · [#cagent 频道](https://dockercommunity.slack.com/archives/C09DASHHRU4)
标签：CLI插件, DLL 劫持, Docker, EVTX分析, LangChain替代, MCP协议, NIDS, OCI镜像, PyRIT, RAG, Ruby, YAML配置, 低代码, 向量检索, 多智能体系统, 大语言模型, 安全防御评估, 容器化, 工作流自动化, 无代码开发, 智能编排, 模型上下文协议, 模型运行时, 混合搜索, 生成式AI, 知识库, 索引, 自动化运维