使用声明式 YAML 配置、丰富的工具生态和多智能体编排来构建、运行和分享 AI 智能体。
什么是 Docker Agent？
docker-agent让你创建并运行能够协作解决复杂问题的智能 AI 智能体——无需编写代码。
docker-agent是一个dockerCLI 插件，可通过以下命令运行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 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。将docker-agent二进制文件符号链接到~/.docker/cli-plugins/docker-agent以便使用docker agent，或直接使用docker-agent。
至少设置一个 API key（或使用Docker Model Runner来运行本地模型）：
export OPENAI_API_KEY=sk-... #或 ANTHROPIC_API_KEY、GOOGLE_API_KEY 等。
参见设置模型了解两种路径（云 API key 或本地模型）的完整操作指南。
快速开始
#运行默认智能体 docker agent run #从 OCI registry 运行 docker agent run myorg/agent:tag #交互式生成新智能体 docker agent new #运行你自己的配置 docker agent run agent.yaml
更多示例见examples/目录。
文档
📖完整文档
贡献
阅读贡献指南开始上手。我们使用docker-agent来构建docker-agent：
docker agent run ./golang_developer.yaml
遥测
我们收集匿名使用数据以改进工具。参见遥测。