🤖 Docker Agent 🤖

通过声明式 YAML 配置、丰富的工具生态以及多智能体编排，轻松构建、运行和分享 AI Agent。

什么是 Docker Agent？

docker-agent 允许你创建并运行智能 AI Agent，它们可以相互协作来解决复杂问题——完全无需代码。

docker-agent 是一个 docker CLI 插件，可以通过 docker agent 命令运行。

只需在 YAML 中定义 Agent，为其分配工具，剩下的交给它们即可。

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) — 创建由专用 Agent 组成的团队，自动委派任务。
• 丰富的工具生态 — 内置工具 + 支持任何 MCP server（本地、远程或基于 Docker 的服务）。
• 兼容多种 AI 提供商 — 支持 OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、xAI、Docker Model Runner 等。
• YAML 配置 — 声明式、可版本化且易于分享。
• 高级推理能力 — 内置思考 (think)、待办事项 (todo) 和记忆 (memory) 工具。
• RAG — 支持可插拔的检索功能，包括 BM25、嵌入 (embeddings)、混合搜索和重排序 (reranking)。
• 打包与分享 — 将 Agent 推送到任何 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 Key（或使用 Docker Model Runner 运行本地模型）：

export OPENAI_API_KEY=sk-...        # 或使用 ANTHROPIC_API_KEY, GOOGLE_API_KEY 等

快速开始

# 运行默认 Agent
docker agent run

# 从 Agent 目录中运行
docker agent run agentcatalog/pirate

# 以交互方式生成新的 Agent
docker agent new

# 运行你自己的配置文件
docker agent run agent.yaml

更多示例请参考 examples/ 目录。

文档

📖 完整文档

• 安装 · 快速开始
• Agent · 模型 · 工具 · 多智能体
• 配置参考
• TUI · CLI · MCP 模式 · RAG
• 模型提供商 · Docker Model Runner

贡献

阅读 贡献指南 以开始。我们正在使用 docker-agent 来构建 docker-agent 本身：

docker agent run ./golang_developer.yaml

遥测

我们会收集匿名使用数据以改进工具。详情请参阅 遥测说明。

社区

Docker 社区 Slack · #docker-agent 频道