Docker Agent: Bildirimsel YAML ile Çoklu Ajan Mimarisi ve Çalıştırma Ortamı

Docker Agent Nedir?#

Docker Engineering tarafından geliştirilen Docker Agent, karmaşık problemleri iş birliği yaparak çözen akıllı yapay zeka ajanlarını kod yazmaya gerek kalmadan oluşturmanızı, çalıştırmanızı ve paylaşmanızı sağlayan bir Docker CLI eklentisidir (docker agent).

Yazılım geliştirme süreçlerinde ajan mantığını doğrudan uygulama koduna gömmek yerine, Altyapı Kodu (IaC) yaklaşımıyla bildirimsel (declarative) YAML dosyalarında tanımlamak bakım kolaylığı ve taşınabilirlik sağlar. Geliştiriciler ajanları, talimatları ve araç setlerini YAML üzerinde yapılandırıp hemen devreye alabilir:

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

Temel Özellikler#

Çoklu Ajan Mimarisi (Multi-agent architecture): Görevleri otonom olarak birbirine devreden özelleşmiş ajan takımları kurarak karmaşık süreçlerin modüler yönetilmesini sağlar.
Zengin Araç Ekosistemi (Rich tool ecosystem): Yerleşik araçların yanı sıra yerel, uzak veya Docker konteynerleri üzerinde koşan tüm Model Context Protocol (MCP) sunucularını destekler.
Yapay Zeka Sağlayıcı Bağımsızlığı (AI provider agnostic): OpenAI, Anthropic, Gemini, AWS Bedrock, Mistral, xAI ve yerel Docker Model Runner desteğiyle sağlayıcı bağımlılığını (vendor lock-in) önler.
YAML Yapılandırması (YAML configuration): Bildirimsel, Git ile sürümlenebilir ve ekip içinde kolayca paylaşılabilir şeffaf bir yapı sunar.
Gelişmiş Akıl Yürütme (Advanced reasoning): Yerleşik düşünme (think), görev takip (todo) ve bellek (memory) araçlarıyla karmaşık senaryolarda doğru kararlar alır.
RAG Desteği (RAG): BM25, embedding vektörleri, hibrit arama ve yeniden sıralama (reranking) tekniklerini tak-çıkar bir mimariyle entegre eder.
Paketleme ve Paylaşım (Package & share): Geliştirilen ajanları OCI registry standartlarında (Docker Hub vb.) paketleyip her ortamda tutarlı şekilde çalıştırmaya olanak tanır.

Kurulum#

Docker Desktop (4.63+): docker-agent CLI eklentisi önceden kurulu gelir; doğrudan docker agent komutuyla kullanılabilir.
Homebrew: brew install docker-agent komutuyla yüklenir. İkili dosya doğrudan çalıştırılabilir veya ~/.docker/cli-plugins/docker-agent dizinine sembolik bağ (symlink) yapılarak docker agent ile koşturulabilir.
Binary Dağıtımları (GitHub Releases): GitHub Releases üzerinden indirilerek doğrudan kullanılabilir veya ~/.docker/cli-plugins/docker-agent dizinine sembolik bağ oluşturulabilir.

Kullanım öncesinde en az bir model sağlayıcısı için API anahtarı tanımlanmalı ya da yerel modeller için Docker Model Runner yapılandırılmalıdır:

export OPENAI_API_KEY=sk-... # veya ANTHROPIC_API_KEY, GOOGLE_API_KEY vb.

Hızlı Başlangıç#

Varsayılan ajanı çalıştırma: docker agent run
OCI registry üzerinden çalıştırma: docker agent run myorg/agent:tag
Etkileşimli yeni ajan üretme: docker agent new
Kendi yapılandırmanızı çalıştırma: docker agent run agent.yaml

Dokümantasyon#

Kapsamlı dokümantasyon; kurulum adımları, model yapılandırma, hızlı başlangıç kılavuzu, ajan tanımları, modeller, araçlar ve çoklu ajan orkestrasyonu gibi tüm detayları barındırır (daha fazla örnek proje deposundaki examples/ dizininde yer almaktadır).

Bu konuyu derinlemesine öğrenmek isterseniz: Production MCP Entegrasyonu modülüne göz atın.