# Docker Agent Agententeams über YAML definieren und mit Werkzeugen auf eigener Infrastruktur ausführen. Kanonisches Profil: https://ki-agentenkompass.de/agenten/docker-agent/ Redaktion: [Michael Meierhoff](https://ki-agentenkompass.de/ueber-mich/) Quellenabgleich: 2026-10-19 Basis: Anbieter-Dokumentation. Praxisbeispiele sind redaktionelle Vorschläge, keine eigenen Produkttests. ## Einordnung Früher cagent; Framework für eigene Agententeams. Docker Gordon ist ein separates Angebot. - Anbieter: Docker - Produktfamilie: Docker Agent - Profiltyp: Agenten-Orchestrierung - Umgebung: Terminal; eigener Rechner oder Server - Verbindungen: Rollen definieren, Delegieren, Modelle kombinieren, MCP verbinden, Teams teilen - Einrichtung: Standalone installieren oder Docker Desktop ab 4.63 nutzen; Modellzugang einrichten. - Kostenmodell: Apache-2.0-Software; Modelle und Betrieb separat, gegebenenfalls Docker-Desktop-Lizenz. ## Kernfunktionen ### Rollen definieren YAML beschreibt Aufgaben und Anweisungen. Quelle: https://docs.docker.com/ai/docker-agent/ ### Delegieren Ein Hauptagent verteilt Arbeit an Subagenten. Quelle: https://docs.docker.com/ai/docker-agent/ ### Modelle kombinieren Agenten können unterschiedliche Modelle nutzen. Quelle: https://docs.docker.com/ai/docker-agent/ ### MCP verbinden Externe Werkzeuge ergänzen eingebaute Tools. Quelle: https://docs.docker.com/ai/docker-agent/ ### Teams teilen Konfigurationen über OCI-Registries verteilen. Quelle: https://docs.docker.com/ai/docker-agent/ ## Redaktionelle Praxisbeispiele ### Beispielauftrag 1 - Du gibst vor: Fehleranalyse und Korrektur auf zwei Agenten aufteilen. - Mögliches Ergebnis: Ein Entwurf zur fachlichen Prüfung. - Das prüfst du: Eingaben, Ergebnis und ausgeführte Aktionen prüfen. ### Beispielauftrag 2 - Du gibst vor: Eine Dokumentation von einem zweiten Agenten prüfen lassen. - Mögliches Ergebnis: Ein Entwurf zur fachlichen Prüfung. - Das prüfst du: Eingaben, Ergebnis und ausgeführte Aktionen prüfen. ## Voraussetzungen und Grenzen ### Einrichtung Voraussetzung: Standalone installieren oder Docker Desktop ab 4.63 nutzen; Modellzugang einrichten. Quelle: https://docs.docker.com/ai/docker-agent/ ### Produktgrenzen Einschränkung: Werkzeugrechte und Modellzugänge selbst konfigurieren und begrenzen. Quelle: https://docs.docker.com/ai/docker-agent/ ### Ergebnisqualität Noch offen: Erfolgsquoten und deutsche Bedienung wurden hier nicht praktisch geprüft. Quelle: https://docs.docker.com/ai/docker-agent/ ## Passt, wenn … - du Agententeams als YAML-Datei definieren und im Terminal ausführen möchtest - du Safety-Modi und Permissions für Werkzeugaufrufe selbst wählen möchtest - du Sitzungen lokal in SQLite behalten und fortsetzen willst ## Passt eher nicht, wenn … - du eine gehostete Oberfläche mit Konten, Rollen und Admin-Verwaltung erwartest - du fertige Zeitpläne und Fehlerbenachrichtigungen ohne eigenen Aufbau brauchst Redaktionelle Einschätzung auf Basis der Anbieterangaben. Kein Produkttest. ## Nutzbare KI-Modelle Frei wählbar Du legst das Modell je Agent in der YAML-Datei fest und hinterlegst dafür deinen eigenen API-Schlüssel, etwa für OpenAI, Anthropic, Gemini, Mistral oder xAI. OpenRouter wird ebenfalls unterstützt. Lokal laufen Modelle über Docker Model Runner, Nativ oder jeden OpenAI-kompatiblen Server wie Ollama und vLLM, dafür brauchst du keinen Schlüssel. - Genannte Modellfamilien: OpenAI (GPT), Anthropic (Claude), Google (Gemini), Mistral, xAI (Grok), DeepSeek · Weitere Modelle frei anbindbar - Modellwahl: Du wählst - Eigener API-Schlüssel: Ja - Router oder eigener Endpunkt: Ja - Lokale Modelle: Ja Belegt · Quellen abgerufen am: 2026-11-05 - [Docker Agent: Model providers](https://docs.docker.com/ai/docker-agent/model-providers/) - [Docker Agent: Repository](https://github.com/docker/docker-agent) ## Europa & regionale Verfügbarkeit Installationsanleitung und Modellvoraussetzungen geprüft. Die Einordnung betrifft den beschriebenen lokalen Betriebsweg; eine vollständige Länder- und Funktionsfreigabe aller angebundenen Dienste bleibt offen. Geprüfter Umfang: Lokale Software und dokumentierter Selbstbetrieb; externe Dienste separat Sichtung am: 2026-10-19 ### Selbstbetrieb mit eigenem Modellzugang Mit Voraussetzungen Docker Agent ist als eigenständige Binärdatei oder Docker-CLI-Erweiterung installierbar. Der Quickstart verlangt Zugangsdaten zum ausgewählten Modellanbieter; dessen regionale Freigabe und optionale Werkzeuge separat prüfen. Betroffene Region: Europa: eigener Rechner oder Server; Modelldienste landesspezifisch Belegter Grund: Technische Einordnung aus Installation und Anbieterwahl. Eine rechtliche Ursache für regionale Einschränkungen ist in diesen Quellen nicht belegt. Offizielle Quelle: https://docs.docker.com/ai/docker-agent/ ## Konten & Berechtigungen Angaben aus Anbieter-Dokumentation. Rechte hängen von Konto, Integration und Organisationsrichtlinien ab. Prüfe vor dem Einsatz die tatsächlich angeforderten Berechtigungen. Betrachtete Konfiguration: Docker Agent (Open Source, Apache-2.0) im Terminal oder als lokaler API-Server auf eigenem Rechner Quellenstand: 2026-11-05 ### Verwendetes Konto Dokumentiert: Die geprüften Seiten nennen kein eigenes Docker-Agent-Konto. Modellzugänge setzt du als Umgebungsvariablen, etwa ANTHROPIC_API_KEY oder OPENAI_API_KEY; für lokale Modelle bietet das Repository Docker Model Runner an. Nachweis: https://docs.docker.com/ai/docker-agent/ Nachweis: https://github.com/docker/docker-agent ### Admin-Freigabe In geprüften Quellen offen: Eine zentrale Freigabe oder Einschränkung durch einen Organisations-Admin nennt die CLI-Dokumentation nicht. Einschränkungen konfigurierst du selbst über Safety-Modi und Permissions. Nachweis: https://docs.docker.com/ai/docker-agent/features/cli/ ### Datenzugriff & Teamfreigaben Dokumentiert: Agentenkonfigurationen sind YAML-Dateien; jeder Agent hat laut Doku seinen eigenen Kontext und teilt kein Wissen, und er kann eingebaute Werkzeuge wie Todo-Listen, Speicher und Aufgabendelegation nutzen. Konfigurationen werden als OCI-Artefakte verpackt. Der API-Server verlangt an Nicht-Loopback-TCP-Listenern ein Auth-Token. Nachweis: https://docs.docker.com/ai/docker-agent/ Nachweis: https://docker.github.io/docker-agent/features/api-server/ ## Preise und enthaltene Nutzung Preisstand: 2026-10-19 Apache-2.0-Software; Modelle und Betrieb separat, gegebenenfalls Docker-Desktop-Lizenz. Abrechnung hängt von Tarif, Verbrauch und Einrichtung ab. Preise und Tarifdetails: https://github.com/docker/docker-agent ## Betrieb & Betreuungsbedarf Basis: öffentliche Anbieter-Dokumentation. Einschätzungen sind redaktionelle Ableitungen aus den genannten Eigenschaften. Tatsächlicher Zeitaufwand und Zuverlässigkeit wurden nicht gemessen. Betrachtete Betriebsform: Docker Agent als CLI (interaktiv oder --exec) und als API-Server auf eigener Infrastruktur Quellenstand: 2026-11-05 ### Dateien und Arbeitsstand Dokumentiert: Der Agent ist zwischen Läufen zustandslos, die Sitzung nicht: Sie liegt in einer SQLite-Datei im Datenverzeichnis, standardmäßig ~/.cagent. Laut API-Doku überstehen Sitzungen Server-Neustarts. Nachweis: https://docs.docker.com/ai/docker-agent/features/sessions/ Nachweis: https://docker.github.io/docker-agent/features/api-server/ ### Anmeldungen In geprüften Quellen offen: Zugänge sind Umgebungsvariablen beziehungsweise Token; zu Ablauf oder Erneuerung machen die geprüften Seiten keine Angaben. Nachweis: https://github.com/docker/docker-agent ### Start weiterer Läufe Bedingt dokumentiert: Läufe startest du per Befehl, headless mit --exec oder über den API-Server. Eine Zeitplanung ist in der API-Doku nur als Werkzeugname „Scheduler“ aufgeführt, ohne Details. Nachweis: https://docker.github.io/docker-agent/features/api-server/ Nachweis: https://docs.docker.com/ai/docker-agent/features/cli/ ### Menschliche Eingriffe Bedingt dokumentiert: Safety-Modi reichen von strict bis autonomous; restricted schlägt für unbeaufsichtigte Läufe fehl-sicher zu. Die Doku rät, dafür Permissions oder einen Safety-Modus zu konfigurieren. Mit --yolo werden Werkzeugaufrufe automatisch genehmigt, sofern sie nicht ausdrücklich verweigert sind. Das Standardverhalten ohne Konfiguration nennt die Seite nicht. Nachweis: https://docs.docker.com/ai/docker-agent/features/cli/ ### Fehler erkennen Bedingt dokumentiert: Mit --debug entsteht ein Logfile (standardmäßig ~/.cagent/cagent.debug.log), --json gibt zeilenweise Ereignisse aus (mit --exec), und docker agent doctor endet mit Fehlercode, wenn ein Problem den Agenten am Laufen hindert. Benachrichtigungen bei fehlgeschlagenen Läufen nennt die CLI-Doku nicht. Nachweis: https://docs.docker.com/ai/docker-agent/features/cli/ ### Nach Fehlern fortsetzen Dokumentiert: Mit --session setzt du eine frühere Sitzung fort, mit -1 die zuletzt erstellte. Über die API setzt POST /api/sessions/:id/resume eine nach einer Werkzeugbestätigung pausierte Sitzung fort. Nachweis: https://docs.docker.com/ai/docker-agent/features/sessions/ Nachweis: https://docker.github.io/docker-agent/features/api-server/ ### Redaktionelle Einschätzung Sitzungen, Safety-Modi und Wiederaufnahme sind dokumentiert, den Betrieb samt Zeitplanung und Fehlermeldung baust du aber selbst um das Werkzeug herum. Für unbeaufsichtigte Läufe musst du den Safety-Modus bewusst wählen. ## Gedächtnis und Gesprächskontinuität Geltungsbereich: Docker Agent mit aktiviertem memory-Toolset Quellen abgerufen: 2026-11-04 Konfigurierbarer SQLite-Speicher mit gezielter Suche und vollständigen CRUD-Werkzeugen. ### Speicherort und Umfang Belegt: Das Memory-Tool speichert Einträge in SQLite; Standard ist ~/.cagent/memory//memory.db, ein eigener Pfad ist möglich. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ### Auswahl und Speicherzeitpunkt Teilweise belegt: Der Agent schreibt über add_memory und update_memory. Die Konfiguration und Agentenanweisungen bestimmen die Nutzung; ein universeller Extraktionszeitplan ist nicht dokumentiert. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ### Einsicht, Bearbeiten und Löschen Belegt: get_memories, update_memory und delete_memory bieten Lesen, Bearbeiten und gezielte Löschung anhand der ID. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ### Agenten- und Kanalgrenzen Belegt: Agenten derselben Konfiguration teilen standardmäßig die Datenbank. Eigene Pfade pro Toolset isolieren ihre Erinnerungen. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ### Wiederabruf Belegt: search_memories sucht nach Schlüsselwörtern und/oder Kategorien; get_memories lädt alle Einträge. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ### Session-Reset und Compaction Belegt: Memory bleibt über Sitzungen erhalten. /compact fasst Gesprächshistorie zusammen; gespeicherte Sitzungen und Memory sind unterschiedliche Speicher. - [Memory Tool](https://docs.docker.com/ai/docker-agent/tools/memory/) - [Troubleshooting](https://docs.docker.com/ai/docker-agent/guides/troubleshooting/) ## Rahmen Werkzeugrechte und Modellzugänge selbst konfigurieren und begrenzen. Anbieterquellen geprüft; Beispiele sind redaktionelle Vorschläge. Kein eigener Praxistest. ## Offene Punkte Voraussetzungen und Grenzen, noch offen: - Ergebnisqualität ## Quellen - https://docs.docker.com/ai/docker-agent/ - https://github.com/docker/docker-agent ## Anbieter Produkt und Anbieter sind über die verlinkten Originalquellen dokumentiert. - Betreiber: Docker - Organisation: Anbieter - Website: https://docs.docker.com/ai/docker-agent/ - Stand: 2026-10-19 - Anbieterquelle: https://docs.docker.com/ai/docker-agent/ - Anbieterquelle: https://github.com/docker/docker-agent [Quellen und Methode](https://ki-agentenkompass.de/quellen/)