Tek bir kodlama ajanı iyi bir çalışma arkadaşıdır. Ama iş planlama, kod yazma, inceleme ve test gibi farklı türde adımlar içerdiğinde tek ajan hepsini aynı anda taşımaya çalışır. Bir testi düzeltirken planı unutur, kendi yazdığı kodu incelerken de doğal olarak bir sorun göremez. Yapay zeka ajan ekibi bu yükü insan ekipleri gibi böler: bir ajan yönetir, diğerleri birer rol üstlenir ve herkes işini kime teslim edeceğini bilir.
Bu yazıda çoklu ajan ekibinin aslında ne olduğunu, tek ajana ya da paralel bir çalışmaya göre ne zaman zahmetine değdiğini ve AgentVera’nın ekip görünümünde nasıl kurulduğunu anlatıyorum.
Yapay zeka ajan ekibi ne demek?
Yapay zeka ajan ekibi, aynı hedef için çalışan ve etrafında bir düzen olan birkaç kodlama ajanıdır. Ekibi, aynı anda açık duran birkaç terminalden ayıran şey bu düzendir. Dört parçası var:
- Yönetici: İsteği alan, parçalara bölen, parçaları dağıtan ve gelen sonucu kontrol eden ajan.
- Roller: Her üyenin bir görevi vardır; araştırmacı, geliştirici, inceleyici ya da testçi gibi. Rolün talimatları ajanın neye dokunup neye dokunmayacağını söyler.
- Bağlılık çizgileri: Her üye birine bağlıdır. Sen belirtmezsen yöneticiye bağlı olur.
- İş teslimi: Bir üyenin biten işi için sabit bir sonraki durak olabilir. Örneğin geliştirici işini inceleyiciye, inceleyici de testçiye teslim eder.
Ajanlar birbiriyle doğrudan konuşur. Hata bulan testçi, hatayı geliştiricinin terminaline senin kopyalamanı beklemez; mesajı kendisi gönderir.
Ekip ne zaman tek ajandan iyidir?
Ekip, tek ajana göre daha fazla token ve daha fazla dikkat ister. Bu yüzden kurmadan önce gerçekten gerekip gerekmediğine bakmak lazım. Ben şu tabloya göre karar veriyorum:
| Durum | En uygun yol | Neden |
|---|---|---|
| Bir iki dosyalık küçük düzeltme | Tek ajan | Bölünecek bir şey yok, bölmek sadece yük getirir |
| Plan, kod, inceleme ve test içeren bir özellik | Ajan ekibi | Her adımın hedefi farklı; ikinci bir göz işe yarar |
| Birbirinden net ayrılan parçaları olan büyük bir iş | Paralel ekip | Parçalar ayrı worktree’lerde çalışır, tek dalda birleşir |
| Saatler ya da günler süren, devam eden iş | Ajan ekibi | Ekip açık kalır, roller görevler arasında korunur |
| Bir probleme iki farklı yaklaşım denemek | Yan yana iki ajan | Koordinasyon değil, birbirinden bağımsız cevap istersin |
Kısacası: işin içinde farklı türde adımlar varsa ve ajanların iş değiştikçe birbiriyle koordine olmaya devam etmesini istiyorsan ekip kur. Sadece bağımsız parçaları hızlıca bitirmek istiyorsan paralel çalışma daha sade bir çözümdür. O tarafı Paralel kodlama ajanları ve Birden fazla Claude Code ajanı yazılarında anlattım.
Ajan ekibi mi, paralel ekip mi?
AgentVera’da ikisi de var ve farklı sorunları çözüyorlar:
- Ekip görünümü, zaten açık olan ajanları kalıcı bir ekip olarak düzenler. Ajanlar rollerini korur, birbiriyle konuşur, görev listesini ve panoyu paylaşır.
- Paralel ekip ise bir ajanın tek bir iş için başlattığı çalışmadır. İşi en fazla 8 parçaya böler, her parçayı kendi git worktree’sinde çalıştırır, biten parçaları bir entegrasyon dalında birleştirir ve son bir kontrol çalıştırır. Orada biter; pull request açıp açmamaya sen karar verirsin.
İkisi birlikte de iyi çalışır: Ekibin yöneticisi, görevlerden biri bölünecek kadar büyükse paralel bir ekip başlatabilir.
Ekibi tasarlamak
Herhangi bir pencere açmadan önce ekibi kâğıt üzerinde çiz. Üç soru işin büyük kısmını halleder.
1. Kim yönetecek?
Yönetici, planlama konusunda en çok güvendiğin ajan olmalı. İsteği okur, parçalara ayırır ve kimin ne yapacağına karar verir. Talimatlarına işin nasıl kontrol edileceğini yaz; örneğin “testçi testleri çalıştırmadan bir görevi bitti sayma”.
2. İş gerçekte hangi rolleri gerektiriyor?
Küçük başla. Bir yöneticinin altında geliştirici, inceleyici ve testçi çoğu özellik işini karşılar. İş koddan önce okuma gerektiriyorsa araştırmacı, değişiklik dışa açık API’lere dokunuyorsa dokümantasyon rolü ekle. Her yeni ajan, doldurulacak bir bağlam ve harcanacak token demek.
3. İş nereden nereye akacak?
İki tür çizgi çiz:
- Bağlı olduğu ajan: Kim kime hesap verir. Ajan takıldığında kime soracağını bu belirler.
- İşini kime teslim eder: Biten işin sonraki durağı. Tipik zincir geliştirici → inceleyici → testçi.
Zinciri kısa tut. Uzun bir zincir, küçük bir değişikliğin bile bittiğini öğrenmeden önce çok sayıda turu beklemesi demektir.
AgentVera ekip görünümünde kurulum
Ekip görünümü bu taslağı çalışan bir ekibe çevirir. Pencereyi bir grubun üstündeki ekip simgesinden ya da kenar çubuğunun en üstünden açarsın.
Adım 1: Ajanları yerleştir
Pencerede Ekip yapısı ve yanında Çalışma alanındaki ajanlar havuzu görünür. Ajanları havuzdan yapıya sürükle ya da henüz olmayan bir rol için Yeni ajan aç ile yeni bir ajan başlat. Yönetici olarak işaretlediğin ajan ekibi yönetir. Bir ekipte tek yönetici ve en fazla 24 üye olur; tüm üyeler grubun projesindeki ajanlar olmalıdır. Terminal oturumları ekibe girmez.
Sıfırdan başlamak istemezsen Hazır ekipler sana tam bir kadro verir:
- Yazılım ekibi: Teknik lider ile planlayıcı, geliştirici, inceleyici ve testçi.
- Araştırma ekibi: Araştırma yöneticisi ile araştırmacı ve rapor yazarı.
- Sosyal medya ekibi: Sosyal medya yöneticisi ile trend araştırmacısı, metin yazarı, görsel tasarımcı ve reklam uzmanı. Taslak hazırlar; bir şey yayınlamadan ya da para harcamadan önce sana sorar.
Hazır ekip, ihtiyaç duyduğu yeni ajanları senin yerine açar.
Adım 2: Her ajana bir rol ver
Bir ajanı seç, Rol ve Talimatlar alanlarını doldur. Hazır roller ad ve talimatı senin için yazar: araştırmacı, planlayıcı, geliştirici, inceleyici, testçi, DevOps, tasarımcı, dokümantasyon ve güvenlik. Aynı rolü birden fazla ajan paylaşabilir; iki geliştiriciden biri ön yüzü, diğeri arka ucu alacaksa işine yarar.
Adım 3: Çizgileri çiz
Her üyenin Bağlı olduğu ajan ve İşini kime teslim eder alanları var. Bunları alanlardan seçebilir ya da bir ajanı diğerinin üstüne sürükleyip “… ajanına bağlı olsun”, “İşini … ajanına teslim etsin” veya “… ile yer değiştirsin” seçeneklerinden birini seçebilirsin. Otomatik yerleştir düzeni toparlar. Bağlı olduğu ajan seçilmemiş bir üye yöneticiye bağlanır; yanlışlıkla bir döngü kurarsan o da yöneticiye yönlendirilir.
Adım 4: Ekibe araçlarını ver
Ekibin MCP sunucuları bölümünde tüm üyelerin alacağı sunucuları seçersin. Her rol bunların üstüne kendi sunucularını ekleyebilir; testçiye Playwright, tasarımcıya bir tasarım aracı gibi. Bir ajan kendi ayarlarından bunu kapatabilir. Önerilen bir sunucu kurulu değilse uyarı görürsün ve katalogdan ekleyebilirsin. Araçları değişen ajanlar mevcut turları bitince yeniden başlar, böylece hiçbir iş yarıda kesilmez. MCP’yi MCP sunucusu nedir yazısında ayrıntılı anlattım.
Adım 5: Kaydet ve ekibe iş ver
Kaydet ve ekibe geç, ajanları gruba alır; böylece birbirine mesaj atabilir, görev listesini ve panoyu paylaşabilirler. Kaydetmek hiçbir işi başlatmaz. İş, Ekibe ver dediğinde başlar: İstek varsayılan olarak yöneticiye, istersen seçtiğin başka bir ajana gider. Her ajana rolü anlatılır; bu bilgilendirme sadece ekip değiştiğinde tekrarlanır. Ajanlar arası mesajlaşma kapalıysa açılır.
Ekibi çalışırken izlemek
Ekip sekmesi yapıyı canlı gösterir. Çalışan ajanlar parlar, mesajlar çizgiler boyunca ışık gibi akar ve konuşan ajanın üstünde bir konuşma balonu belirir. Yanında şunlar var:
- Ekip durumu: Her ajanın şu anki adımı; düzenliyor, okuyor, komut çalıştırıyor, arıyor, plan yapıyor ya da mesajlaşıyor.
- Akış: Mesajlar, işler ve ajan olayları; Tümü, Mesajlar, İş ve Ajanlar filtreleriyle.
- Görevler: Ajanların eklediği, üstlendiği ve bitirdiği ortak liste.
- Seni bekleyenler: İzin istekleri burada toplanır, onaylayabilir ya da reddedebilirsin.
Yön vermen gerektiğinde Durum raporu, yöneticiden her ajanın ne yaptığını, neyin bittiğini ve ekibin nerede takıldığını kısaca özetlemesini ister. Tek bir ajana yazarken Kes ve yönlendir elindeki işi keser ve mesajını hemen iletir; Sıraya koy ise mesajı elindeki iş bitince iletir. Hepsini kes de onay aldıktan sonra çalışan tüm ajanların işini keser.
Ajanlar nasıl konuşuyor?
Arka planda ajanlar arası mesajlaşma her ajana diğerlerini listeleme, mesaj gönderme (istersen cevabı bekleme), cevap verme ve ortak görev listesiyle çalışma araçları verir. Meşgul bir ajan mesajı turu bitince alır, yani kimse bir düzenlemenin ortasında bölünmez. Mesajlar başka bir ajandan geldiği belirtilerek iletilir ve iki ajanın sonsuza kadar birbirine yazmaması için her gönderenin bir sınırı vardır. Bu, CLI’lar arasında da çalışır: Claude Code, Codex, Gemini CLI ve diğerleri aynı araçları kullanır.
Sık yapılan hatalar
- İlk günden çok fazla ajan. Küçük bir değişikliğe beş ajan koyarsan turlarının çoğu birbirinin mesajını okumakla geçer. Üç ajanla başla, eksik görünce rol ekle.
- Belirsiz roller. “Koda yardım et” bir rol değildir. Ajanın neyin sahibi olduğunu, hangi klasörlere dokunabileceğini ve onun için “bitti”nin ne demek olduğunu yaz.
- İnceleyici ya da testçi olmaması. Geliştiricinin kendi işini kontrol ettiği bir ekip, fazladan adımları olan tek bir ajandan farksızdır.
- Aynı dosyalarda iki ajan. Aynı dosyalarda çalışan iki geliştirici birbirinin işini ezer. Klasöre göre böl ya da yöneticinin bir paralel ekip başlatmasına izin ver ki her parça kendi worktree’sini alsın. Ayrıntısı Git worktree ile paralel geliştirme yazısında.
- İşi her ajana ayrı ayrı vermek. Bölmeyi yöneticiye bırak; yöneticinin olmasının bütün amacı bu.
- Onayları gözden kaçırmak. İzin bekleyen bir ajan, zincirde kendisinden sonra gelen herkesi bekletir. Seni bekleyenler alanına göz kulak ol.
Kontrol listesi
- İşin nasıl kontrol edileceğini bilen tek bir yönetici var mı?
- Her rolün sahibi, kapsamı ve “bitti” tanımı net mi?
- Bağlılık ve teslim çizgileri çizildi mi, zincir kısa mı?
- Zincirin bir yerinde inceleyici ya da testçi var mı?
- Ekibin ve rollerin MCP sunucuları seçilip kuruldu mu?
- İlk istek her ajana ayrı değil, yöneticiye yazıldı mı?
Sonuç
Yapay zeka ajan ekibi, işin birbirinden ayrı adımları olduğunda ve bu adımları senin mesaj taşımana gerek kalmadan koordine olan ajanlara bırakmak istediğinde zahmetine değer. Yapısı basit: bir yönetici, iyi tarif edilmiş birkaç rol ve bağlılık ile teslim için kısa çizgiler. Küçük başla, ilk çalışmayı Ekip sekmesinden izle, ajanların beklediği ya da birbirini tekrarladığı yerde rolleri sıkılaştır. Sabit aşamalarla düşünmeyi tercih ediyorsan Yapay zeka ajan iş akışı yazısı o yaklaşımı anlatıyor.
AgentVera, hangi CLI ile çalışırsa çalışsın zaten açık olan ajanlarından ekip kurmanı sağlar. Ücretsiz planla hemen başlayabilir, ihtiyaç duyduğunda planlara göz atabilirsin.