Docker Agent: плагин Docker CLI запускает ИИ-агентов из YAML-конфига

Docker Agent: плагин Docker CLI запускает ИИ-агентов из YAML-конфига

docker-agent, инструмент для создания, запуска и распространения ИИ-агентов, которые описываются декларативным YAML-конфигом. По описанию в README, он позволяет создавать и запускать агентов, совместно решающих сложные задачи, «без кода». Работает как плагин для docker CLI и запускается командой «docker agent».

Базовый сценарий: в YAML описывается агент (в примере из README корневой агент root использует модель openai/gpt-5-mini, имеет описание и системную инструкцию «помогать пользователям, быть точным и кратким») и подключаются наборы инструментов. В примере подключён MCP-инструмент docker:duckduckgo, после чего конфиг запускается командой «docker agent run agent.yaml». Девиз README: определите агентов в YAML, дайте им инструменты и позвольте работать.

Возможности по списку README: многоагентная архитектура (команды специализированных агентов, которые автоматически делегируют задачи друг другу); богатый набор инструментов, встроенные плюс любой MCP-сервер (локальный, удалённый или на базе Docker); независимость от провайдера, перечислены OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner «и другие»; конфигурация, которую можно хранить в системе контроля версий и передавать; встроенные инструменты рассуждения think, todo и memory; подключаемый RAG (поиск по базе знаний) с BM25, эмбеддингами, гибридным поиском и реранкингом; публикация агентов в любой OCI-реестр и запуск их из реестра в другом месте.

Установка: в Docker Desktop версии 4.63 и новее плагин уже предустановлен, достаточно выполнить «docker agent». Альтернативы, Homebrew («brew install docker-agent») или бинарные релизы с GitHub; в обоих случаях бинарник можно запускать напрямую или сделать на него символическую ссылку в ~/.docker/cli-plugins/docker-agent. Для работы нужен хотя бы один API-ключ (например, OPENAI_API_KEY или ANTHROPIC_API_KEY) либо Docker Model Runner для локальных моделей.

Примеры команд: «docker agent run», запуск агента по умолчанию; «docker agent run myorg/agent:tag», запуск из OCI-реестра; «docker agent new», интерактивная генерация нового агента; «docker agent run agent.yaml», запуск собственного конфига. В README также есть ссылки на документацию (агенты, модели, инструменты, мультиагентность, справочник по конфигурации, TUI, CLI, режим MCP, RAG) и каталог examples/. Авторы README пишут, что разрабатывают docker-agent с помощью самого docker-agent (пример: «docker agent run ./golang_developer.yaml»). Инструмент собирает анонимные данные об использовании; подробности отсылаются к разделу Telemetry.

Ключевые факты

  • docker-agent, плагин для docker CLI: агенты описываются в YAML и запускаются командой «docker agent run agent.yaml».
  • Поддерживаются команды из нескольких специализированных агентов с автоматической передачей задач и любые MCP-серверы (локальные, удалённые, на базе Docker).
  • Среди провайдеров перечислены OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI и Docker Model Runner для локальных моделей; нужен минимум один API-ключ или локальная модель.
  • Есть подключаемый RAG (BM25, эмбеддинги, гибридный поиск, реранкинг) и публикация агентов в любой OCI-реестр.
  • В Docker Desktop 4.63+ плагин предустановлен; иначе ставится через Homebrew или бинарные релизы. Инструмент собирает анонимные данные об использовании.

Почему это важно

Описание агентов декларативным YAML и запуск их как обычной команды Docker снижает порог входа: по README, кода для этого писать не нужно. Агентов можно версионировать, как конфигурацию, и публиковать в OCI-реестрах так же, как контейнерные образы. Поддержка MCP и нескольких провайдеров моделей делает подход не привязанным к одному вендору.

Кому это важно

Разработчикам, которые уже работают с Docker и хотят собирать ИИ-агентов, не пересаживаясь на отдельный фреймворк. Командам, которым нужно делиться агентами через реестр. Тем, кто экспериментирует с мультиагентными схемами, MCP-инструментами и RAG, а также с локальными моделями через Docker Model Runner.

Как это применить

Если установлен Docker Desktop 4.63 или новее, плагин уже есть: достаточно задать хотя бы один API-ключ (или настроить Docker Model Runner) и выполнить «docker agent run». Свой агент описывается в agent.yaml и запускается командой «docker agent run agent.yaml»; новый конфиг можно сгенерировать через «docker agent new». Без Docker Desktop плагин ставится через Homebrew («brew install docker-agent») или бинарным релизом с символической ссылкой в ~/.docker/cli-plugins. Больше примеров, в каталоге examples/ репозитория.

Можно ли доверять

Пересказ основан на README репозитория docker/docker-agent. Это описание возможностей самим проектом, а не независимая проверка: бенчмарков, сравнений и данных о качестве работы агентов в README нет. Утверждения о поддержке провайдеров и функций следует считать заявленными, а не проверенными.

Риски и подводные камни

Инструмент собирает анонимные данные об использовании; что именно входит в телеметрию и как её отключить, в README не раскрыто, об этом отсылают к отдельному разделу. Для облачных моделей нужны API-ключи, и их нужно хранить аккуратно. Список провайдеров заканчивается словами «и другие», так что полный перечень стоит смотреть в документации. Лицензия в тексте README не указана.

«Определите агентов в YAML, дайте им инструменты и позвольте работать.»

— README репозитория docker/docker-agent