Claude Code Alt Ajanlar ve Ajan Ekipleri: Pratik Bir Kılavuz

"Alt ajanlar," "Ajan Takımları," "orkestrasyon" kelimelerini duydunuz ve bir şeyleri kaçırıp kaçırmadığınızı merak ediyorsunuz. Kısa cevap: Çoğu göreviniz için hayır. Ama büyük işler için evet ve anlamaya değer.

Bunu jargon olmadan çözelim.

Alt ajanların gerçekte ne olduğu

Bir alt ajan, kendi bağlamı, kendi istemi ve kendi araç izinleri olan uzman bir asistandır.

Ana ajan iyi tanımlanmış bir alt göreve ulaştığında, bunu bir alt ajana devreder. O alt ajan kendi bağlam penceresinde çalışır, işini yapar ve sadece sonucu geri döndürür. Ana ajan, bağlamını kirleten tam geçmişi almaz, sadece sonucu alır.

Amaç: ana ajanın bağlamını temiz tutmak. 50.000 tokenlık dosya aramasında boğulan bir ajan yerine, aramayı yapan ve üç faydalı satır raporlayan bir alt ajanınız var.

Alt ajanlarınızı projenizin .claude/agents/ klasöründe tanımlarsınız. Her birinin bir adı, ne zaman kullanılacağını belirten bir açıklaması ve bir sistem istemi vardır.

---
name: test-writer
description: Testlerin yazılması veya düzeltilmesi gerektiğinde kullanın
---
Testler yazıyorsunuz. Mutlu yol değil, uç durum kapsamını hedefliyorsunuz. Üretim koduna asla dokunmuyorsunuz.

Ajan Takımları, bir sonraki adım

Ajan Takımları, Claude Code'a entegre edilmiş çoklu ajan orkestratörüdür. Hâlâ deneysel, varsayılan olarak devre dışı, ancak sağlam bir başlangıç noktası.

Fikir: bir ana ajan büyük bir görevi böler, her parçayı uzman bir ajana (kendi modeli, istemleri, araçları ile) devreder, uzmanlar paylaşılan bir dosya sistemi üzerinde paralel çalışır ve sonuçlar ana ajana geri akar.

"Eğer bir uzmana devretmek" alt ajanlar gibi geliyorsa, bu normaldir. Ajan Takımları, bu fikrin birkaç ajanın gerçekten paralel çalıştırılmasına kadar genişletilmiş halidir, sadece birbiri ardına değil.

Yerleşik olanın ötesinde, Multiclaude ve Gas Town gibi üçüncü taraf orkestratörler de vardır. Onlar, başlangıçta iyi bir başlangıç noktası yapan görüşlüdürler: alışkanlıklarınızı oluşturana kadar sizin için karar verirler.

Ne zaman ihtiyacınız var (ve ne zaman yok)

Açık olalım: çoklu ajan orkestrasyonu, ajan destekli görevlerin %95'i için gereksizdir. Günlük işlerinizin çoğu için tek bir ajan daha hızlı ve daha basittir.

Şu anda, çoklu ajan, büyük projelere saldırmanın hâlâ pahalı ve deneysel bir yoludur.

Buna ihtiyacınız var:

• Proje, farklı dosyalara dokunan gerçekten bağımsız parçalara ayrıldığında.
• Tek bir bağlam penceresi tümünü barındıramadığında.
• Geniş bir yeniden yapılandırmayı veya depo genelinde bir geçişi paralel hale getirmek istediğinizde.

Bir hata düzeltmesi, odaklanmış bir özellik veya tek bir kafaya sığan herhangi bir şey için buna ihtiyacınız yok.

Tuzak, bir ajanın beş dakikada yapacağı bir şey için on ajanlık bir "takım" oluşturmak. Görevin asla istemediği bir paralellik için token ve karmaşıklık ödüyorsunuz.

Asıl sorun: görünürlük

Yeterince konuşulmayan şey burada. Birkaç alt ajan veya bir Ajan Takımı çalıştırdığınız anda, ipi kaybedersiniz.

Bir lider beş uzmana devreder. Hangisi çalışıyor? Hangisi bitirdi? Hangisi bir kararı bekliyor? Bir terminalde kayan bir metin duvarı görüyorsunuz ve kimin ne yaptığını söyleyemiyorsunuz.

Bu noktada görsel bir pano her şeyi değiştirir. AgentsRoom, her ajanı ve her alt ajanı kendi karosu olarak gösterir, durumu açıkça belirtilmiştir. Delege etmenin nasıl gerçekleştiğini izlersiniz, kimin yanıtınızı beklediğini görürsünüz, kimin çöktüğünü görürsünüz. Metin duvarı okunabilir bir haritaya dönüşür.

Bu görünüm olmadan, çoklu ajan orkestrasyonu günlük olarak yönetilemez bir etkileyici demo olarak kalır. Bununla, gerçekten kullandığınız bir araç haline gelir.

Nereden başlamalı

Sekiz ajanlık bir takıma doğrudan atlamayın.

Belirli, tekrarlayan görevler için bir veya iki alt ajanla başlayın: biri testler yazar, biri kod tabanını arar. Ana ajanın bağlamında hızlıca kazanç hissedeceksiniz.

Bu mekanik doğal hissettirdiğinde, temiz bir şekilde bölünen işler için Ajan Takımlarını açın. Kimin ne yaptığını takip edin, planları yürütmeden önce onaylayın ve inceleme darboğazınız olduğunda durun.

Çoklu ajan, başlatmadan önce yapılandıranları ödüllendirir. En çok ajanı başlatanları değil.