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-конфига, со встроенными инструментами и оркестрацией нескольких агентов — без написания кода.
Это отдельное приложение или плагин Docker CLI?Это плагин Docker CLI, так что запускается как 'docker agent', хотя бинарник можно запускать и напрямую или через Homebrew.
Как его установить и запустить?Если у вас Docker Desktop 4.63+, плагин уже предустановлен, и вы просто выполняете 'docker agent'. Иначе установите через 'brew install docker-agent' или скачайте бинарный релиз и сделайте симлинк в ~/.docker/cli-plugins/docker-agent.
Нужен ли API-ключ для использования?Нужен как минимум один API-ключ ИИ-провайдера (OpenAI, Anthropic, Gemini, Bedrock, Mistral, xAI), если только вы не используете Docker Model Runner для локального запуска моделей.
Нужно ли уметь программировать, чтобы собрать агента?Нет, агенты описываются декларативной YAML-конфигурацией, а не кодом.
Он собирает данные об использовании?Да, он собирает анонимную телеметрию использования для улучшения инструмента; это описано на отдельной странице Telemetry.
Каких ИИ-провайдеров он поддерживает?OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI и Docker Model Runner для локальных моделей.
Как работает оркестрация нескольких агентов?Можно создавать команды специализированных агентов, которые автоматически делегируют задачи друг другу для решения сложных проблем.
Какие возможности RAG встроены?В него входит подключаемый поиск с использованием BM25, эмбеддингов, гибридного поиска и переранжирования.
Как поделиться агентом с другими?Агентов можно упаковать и запушить в любой OCI-реестр, а затем подтянуть и запустить где угодно.
Creator
docker
Size
84 MB
Stars
4.5K
Age
1y
Commits · 90 Days