docker-agent 是一个 docker CLI 插件,可以通过 docker agent 命令运行。
用 YAML 定义智能体,为它们配备工具,然后让它们开始工作。
agents: root: model: openai/gpt-5-mini description: 一个乐于助人的 AI 助手 instruction: | 你是一位知识渊博的助手,帮助用户完成各种任务。 回答应乐于助人、准确且简洁。 toolsets: - type: mcp ref: docker:duckduckgo
docker agent run agent.yaml
主要特性
- 多智能体架构 — 创建由专业化智能体组成的团队,自动委派任务
- 丰富的工具生态 — 内置工具 + 任意 MCP 服务器(本地、远程或基于 Docker)
- 不锁定 AI 供应商 — 支持 OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、xAI、Docker Model Runner 等
- YAML 配置 — 声明式、可版本管理、可分享
- 高级推理 — 内置 think、todo 和 memory 工具
- RAG — 可插拔检索,支持 BM25、向量嵌入、混合搜索和重排序
- 打包与分享 — 将智能体推送到任意 OCI 仓库,在任何地方拉取并运行
安装
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 下载。将 docker-agent 二进制文件符号链接到 ~/.docker/cli-plugins/docker-agent 即可使用 docker agent 命令,或直接运行 docker-agent。
至少设置一个 API 密钥(或使用 Docker Model Runner 运行本地模型):
export OPENAI_API_KEY=sk-… # 或 ANTHROPIC_API_KEY、GOOGLE_API_KEY 等
请参阅 Set Up a Model 了解两条路径(云端 API 密钥或本地模型)的完整上手指南。
# 运行默认智能体
docker agent run
# 从 OCI 仓库运行
docker agent run myorg/agent:tag
# 交互式生成新的智能体
docker agent new
# 运行你自己的配置
docker agent run agent.yaml
更多示例请参见 examples/ 目录。
阅读 Contributing 指南 开始参与贡献。我们自己就用 docker-agent 来构建 docker-agent。