Docker Agent

Wat is Docker Agent?

docker-agent stelt je in staat om intelligente AI-agents te maken en uit te voeren die samenwerken om complexe problemen op te lossen — zonder dat er code aan te pas komt.

docker-agent is een Docker CLI-plugin en kan worden uitgevoerd met het commando docker agent. Je definieert agents in YAML, geeft ze tools en laat ze aan het werk gaan.

Voorbeeldconfiguratie

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

Om deze agent te starten, gebruik je: docker agent run agent.yaml

Belangrijkste kenmerken

• Multi-agent architectuur — Maak teams van gespecialiseerde agents die automatisch taken delegeren.
• Rijk tool-ecosysteem — Ingebouwde tools plus ondersteuning voor elke MCP-server (lokaal, extern of Docker-gebaseerd).
• Agnostisch voor AI-providers — Ondersteuning voor OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI, Docker Model Runner en meer.
• YAML-configuratie — Declaratief, versieerbaar en deelbaar.
• Geavanceerde redenering — Ingebouwde tools voor denken (think), takenlijsten (todo) en geheugen.
• RAG (Retrieval-Augmented Generation) — Inplugbare retrieval met BM25, embeddings, hybride zoekopdrachten en reranking.
• Verpakken & delen — Push agents naar elke OCI-registry; trek ze op en draai ze overal.

Installatie

Installatiemethoden

• Docker Desktop (4.63+): De docker-agent CLI-plugin is vooraf geïnstalleerd. Voer simpelweg docker agent uit.
• Homebrew: Voer brew install docker-agent uit. Je kunt docker-agent direct aanroepen of het binary symlinken naar ~/.docker/cli-plugins/docker-agent om het via docker agent te gebruiken.
• Binary releases: Download de binaries via GitHub Releases. Symlink het docker-agent binary naar ~/.docker/cli-plugins/docker-agent om docker agent te kunnen gebruiken, of gebruik docker-agent direct.

Configuratie van API-sleutels

Stel minimaal één API-sleutel in (of gebruik Docker Model Runner voor lokale modellen):

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

Raadpleeg de sectie "Set Up a Model" voor een volledige handleiding over zowel cloud API-sleutels als lokale modellen.

Snelstart

# Voer de standaard agent uit
docker agent run

# Voer een agent uit vanuit een OCI-registry
docker agent run myorg/agent:tag

# Genereer interactief een nieuwe agent
docker agent new

# Voer je eigen configuratie uit
docker agent run agent.yaml

Voor meer voorbeelden kun je kijken in de examples/ directory.

Documentatie

De volledige documentatie is onderverdeeld in de volgende categorieën:

• Basis: Installatie, Set Up a Model, Quick Start.
• Concepten: Agents, Models, Tools, Multi-Agent.
• Referentie: Configuration Reference.
• Interface & Modus: TUI, CLI, MCP Mode, RAG.
• Providers: Model Providers, Docker Model Runner.

Bijdragen

Lees de Contributing guide om aan de slag te gaan. Docker Engineering gebruikt docker-agent zelf om docker-agent te bouwen:

docker agent run ./golang_developer.yaml

Telemetrie

Er worden anonieme gebruiksgegevens verzameld om de tool te verbeteren. Zie de sectie Telemetry voor meer informatie.

Community

Je kunt de community vinden via de Docker Community Slack in het #docker-agent kanaal.