docker/docker-agent

Docker Agent – 作为 Docker CLI 插件的 AI 代理

它是什么 – Docker Agent 是一个真正的开源工具，允许你使用简单的 YAML 文件定义、运行和共享 AI 代理。它作为 Docker CLI 插件（docker agent）提供，因此你可以使用与容器相同的命令行启动代理。

工作原理 – 你编写一个声明式配置，指定：

• 要使用的 LLM 模型（OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、Docker Model Runner 等）
• 代理的描述和系统提示
• 一个或多个工具集（例如，通过 Model Context Protocol 的 DuckDuckGo 搜索工具、RAG 工具、记忆、待办事项等）

然后 Docker Agent 启动模型，连接请求的工具，如果你定义了多个代理，它会编排它们，使它们能够自动相互委派任务。

主要功能

• 多代理编排 – 构建一个专业代理团队，无需编写代码即可交接工作。
• 工具生态系统 – 内置工具以及任何兼容 MCP 的服务（本地、远程或基于 Docker）。
• 提供商无关 – 适用于云 API 和通过 Docker Model Runner 本地运行的模型。
• 仅 YAML 配置 – 易于版本控制、共享和存储在 OCI 注册表中。
• RAG 支持 – 使用 BM25、嵌入、混合搜索和重排序的插件式检索。
• 打包与共享 – 将代理镜像推送到任何 OCI 注册表，并使用 docker agent run <image> 在任何地方运行。

安装

• Docker Desktop 4.63+ 自动包含该插件。
• Homebrew：brew install docker-agent（或将二进制文件符号链接到 ~/.docker/cli-plugins/docker-agent）。
• 从 GitHub Releases 页面获取二进制发布版。
• 设置至少一个提供商 API 密钥（例如，export OPENAI_API_KEY=…）。

快速开始

# 运行内置默认代理
docker agent run

# 运行存储在 OCI 注册表中的代理
docker agent run myorg/agent:tag

# 交互式创建新代理
docker agent new

# 运行自定义 YAML 定义
docker agent run agent.yaml

文档与社区 – 完整文档托管在 https://docker.github.io/docker-agent/，涵盖安装、模型设置、配置参考、TUI/CLI 用法、MCP 模式、RAG 工具和提供商详细信息。社区支持位于 Docker Slack（#docker-agent 频道）以及一系列社区项目、视频和文章。

典型用例 – 快速原型设计 AI 助手，构建用于数据分析或自动化的多代理管道，将可重现的 AI 工作流打包为 OCI 镜像，以及在不编写代码的情况下试验 RAG 或自定义工具集成。