Docker Agent[1] es un complemento de la línea de comandos de Docker para crear y ejecutar agentes de IA describiéndolos en un fichero YAML, sin escribir código. Lo mantiene el equipo de ingeniería de Docker y la idea es sencilla: defines uno o varios agentes, les das herramientas y los pones a colaborar con docker agent run. En este artículo cuento qué hace, cómo se usa y dónde encaja.

Puntos clave

  • Docker Agent se instala como complemento de la línea de comandos (el comando docker agent) y viene preinstalado en Docker Desktop 4.63 y superiores.
  • Los agentes se describen en YAML: el modelo, las herramientas y, si hace falta, varios agentes que se delegan tareas entre sí.
  • Las herramientas llegan por MCP (servidores locales, remotos o en contenedor), más utilidades integradas de razonamiento, tareas y memoria.
  • No te ata a un proveedor: es compatible con OpenAI, Anthropic, Gemini, Bedrock, Mistral, xAI o el Docker Model Runner.
  • Un agente se empaqueta y se comparte por cualquier registro OCI, igual que una imagen.

Qué resuelve

Montar un agente a mano implica pegar con código el modelo, las herramientas y la orquestación. Docker Agent traslada esa fontanería a un YAML declarativo, versionable y compartible, y reaprovecha dos cosas que ya conoces de Docker: los contenedores para aislar las herramientas y los registros OCI para distribuir. Si ya trabajas con servidores MCP, aquí están totalmente integradas. El propio README lo resume sin rodeos:

«Define agents in YAML, give them tools, and let them work.» — README de docker/docker-agent

La diferencia con montarlo a mano se aprecia mejor por partes:

Aspecto A mano (con código) Con Docker Agent
Definición del agente Código en Python o TypeScript Un fichero agent.yaml declarativo
Herramientas Integras cada SDK por tu cuenta Servidores MCP, locales o en contenedor
Aislar las herramientas Te lo montas tú Contenedores, igual que cualquier imagen
Compartir el agente Empaquetado a medida Cualquier registro OCI (push / pull)
Proveedor de modelo Atado al SDK que elijas OpenAI, Anthropic, Gemini, Bedrock, Mistral, xAI o el Model Runner

Cómo se ve

Un agente mínimo cabe en unas líneas: un modelo y un conjunto de herramientas por MCP.

agents:
  root:
    model: openai/gpt-5-mini
    toolsets:
      - type: mcp
        ref: docker:duckduckgo

Y se lanza con un solo comando:

docker agent run agent.yaml

docker agent new genera la plantilla de forma interactiva, y las operaciones de push y pull mueven el agente por un registro OCI.

Demostración animada de Docker Agent en la terminal: una sesión que resume un README mientras se ven el árbol de agentes (raíz, planificador, revisor), el uso de tokens y las herramientas MCP disponibles.

Varios agentes y herramientas

La gracia no está en un agente suelto, sino en combinarlos. Docker Agent reparte el trabajo entre un agente raíz y subagentes que se delegan tareas, el mismo patrón que vimos al comparar frameworks multiagente. Cada agente trae utilidades integradas para pensar, gestionar tareas y recordar, y puede montar cualquier servidor MCP local, remoto o en contenedor, además de RAG para consultar tus propios datos.

Diagrama de flujo de Docker Agent: del fichero agent.yaml al comando docker agent, que arranca un agente raíz que delega en subagentes y herramientas MCP.

Preguntas frecuentes

¿Docker Agent necesita Docker Desktop?

No es imprescindible. Viene preinstalado en Docker Desktop 4.63 y versiones posteriores, pero también puedes instalarlo con Homebrew (brew install docker-agent) o desde los binarios publicados en GitHub.

¿Con qué modelos funciona?

Con los que ya tengas: es compatible con OpenAI, Anthropic, Gemini, Bedrock, Mistral, xAI o el Docker Model Runner. No incluye ningún modelo propio, así que necesitas acceso a algún proveedor.

¿Cómo comparto un agente con mi equipo?

Se empaqueta y se publica en cualquier registro OCI, igual que una imagen de contenedor. Así se versiona y se distribuye con las mismas herramientas que ya usas para tus imágenes.

Mi lectura

Me parece un movimiento coherente: Docker no reinventa el agente, empaqueta la parte aburrida. El YAML declarativo y el registro OCI encajan con la forma en la que ya distribuimos software, y no atarte a un proveedor de modelos es de agradecer.

La parte honesta: es una herramienta joven y el YAML declarativo tiene techo; cuando la lógica se complica, tarde o temprano acabas escribiendo tus propias herramientas. Y da por hecho que tienes acceso a algún proveedor de modelos, porque trabaja con el proveedor que le configures y no incluye ninguno. Para prototipar y compartir agentes reproducibles, compensa; para lógica muy a medida, quizá te quedes corto.

Conclusión

Docker Agent lleva la creación de agentes al terreno que Docker domina: un fichero declarativo, contenedores para las herramientas y registros OCI para compartir. Con licencia Apache-2.0 y preinstalado en Docker Desktop, probar un agente cuesta un comando. Merece la pena si ya vives en el ecosistema Docker y quieres agentes reproducibles sin montar la fontanería a mano.

También disponible en inglés: what is Docker Agent.

Fuentes

  1. Docker Agent
  2. documentación de Docker
  3. blog de Docker