🤖 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

核心特性

• 多智能体架构 — 创建专业化 Agent 团队，自动委派任务。
• 丰富的工具生态系统 — 内置工具 + 支持任何 MCP 服务器（本地、远程或基于 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 频道