docker-agent README

The project's README from github.com/docker/docker-agent. As one markdown file: README.md.

🤖 Docker Agent 🤖

Build, run, and share AI agents with a declarative YAML config, rich tool ecosystem, and multi-agent orchestration.

docker agent in action

What is Docker Agent?

docker-agent lets you create and run intelligent AI agents that collaborate to solve complex problems — no code required.

docker-agent is a docker CLI plugin and can be run with docker agent.

Define agents in YAML, give them tools, and let them work.

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

Key Features

Install

Docker Desktop (4.63+) — docker-agent CLI plugin is pre-installed. Just run docker agent.

Homebrew — brew install docker-agent. Run docker-agent directly or symlink the binary to ~/.docker/cli-plugins/docker-agent and run docker agent.

Binary releases — Download from GitHub Releases. Symlink the docker-agent binary to ~/.docker/cli-plugins/docker-agent to be able to use docker agent, or use docker-agent directly.

Set at least one API key (or use Docker Model Runner for local models):

export OPENAI_API_KEY=sk-...        # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.

See Set Up a Model for the full walkthrough of both paths (cloud API key or local model).

Quick Start

# Run the default agent
docker agent run

# Run from an OCI registry
docker agent run myorg/agent:tag

# Generate a new agent interactively
docker agent new

# Run your own config
docker agent run agent.yaml

More examples in the examples/ directory.

Documentation

📖 Full documentation

Contributing

Read the Contributing guide to get started. We use docker-agent to build docker-agent:

docker agent run ./golang_developer.yaml

Telemetry

We collect anonymous usage data to improve the tool. See Telemetry.

Community

Docker Community Slack · #docker-agent channel

docker-agent (docker/docker-agent)

Searching Database…

这是什么?Docker Agent 是一个用声明式 YAML 配置来构建、运行和分享 AI 智能体的工具,内置各种工具和多智能体编排——无需写代码。
这是独立应用还是 Docker CLI 插件?它是一个 Docker CLI 插件,所以你以 'docker agent' 的方式运行它,不过该二进制也可以直接运行或通过 Homebrew 使用。
怎么安装和运行它?如果你有 Docker Desktop 4.63+,插件已预装,直接运行 'docker agent' 即可。否则用 'brew install docker-agent' 安装,或下载二进制 release 并把它软链接到 ~/.docker/cli-plugins/docker-agent。
用它需要 API key 吗?你至少需要一个 AI 提供商的 API key(OpenAI、Anthropic、Gemini、Bedrock、Mistral、xAI),除非你用 Docker Model Runner 在本地跑模型。
构建智能体需要写代码吗?不需要,智能体通过声明式 YAML 配置来定义,而不是代码。
它会收集使用数据吗?会,它收集匿名使用遥测数据来改进工具,并在专门的 Telemetry 页面里作了说明。
它支持哪些 AI 提供商?OpenAI、Anthropic、Gemini、AWS Bedrock、Mistral、xAI,以及用于本地模型的 Docker Model Runner。
多智能体编排是怎么工作的?你可以创建由专门化智能体组成的团队,它们会自动互相委派任务来解决复杂问题。
内置了哪些 RAG 能力?它内置可插拔的检索,支持 BM25、embedding、混合搜索和重排序。
怎么把智能体分享给别人?智能体可以打包并推送到任何 OCI registry,然后在任何地方拉取运行。
Creator
docker
Size
84.1 MB
Stars
4.6K
Age
1y
Commits · 90 Days