Subagents
Bob'un ana konuşmayı kirletmeden izole bağlamlarda odaklanmış, bağımsız görevleri yerine getirmek için subagents'ı nasıl kullandığını öğren.
Subagents nedir?
Subagent, Bob'un odaklanmış, bağımsız bir görevi yerine getirmek için spawn edebildiği bağımsız bir ajandır. Kendi izole edilmiş context window'unda çalışır, atanan işi gerçekleştirir ve sonuçların özetini ana konuşmaya geri döndürür.
Subagents, aksi takdirde devam eden konuşmaya büyük miktarda ilgisiz içerik ekleyecek çalışmalar için kullanışlıdır; örneğin, Bob ana görevle devam etmeden önce belirli bilgileri toplamak amacıyla bir kod tabanının bir bölümünü derinlemesine keşfetmek.
Subagents nasıl çalışır
Bob bir subagent spawn ettiğinde:
- Kendi context window'una sahip yeni, bağımsız bir ajan oluşturulur.
- Bob, gerçekleştirilecek odaklanmış görevin bir açıklamasını ona iletir.
- Başlamadan önce spawn'ı onaylaman istenir. Bob onaylayana kadar bekler.
- Subagent, mevcut tools'ları kullanarak görevi gerçekleştirir.
- Subagent, bulgularının özetini Bob'a geri döndürür.
- Bob, ana konuşmaya devam etmek için bu özeti kullanır.
Subagent, ana konuşmadan ayrı olarak çalışır. Bob bunları açıkça açıklamada iletmedikçe durum, dosyalar veya tool sonuçlarını Bob ile paylaşmaz.
Subagent türleri
Her biri farklı görevlere uygun iki subagent türü vardır:
| Tür | Açıklama | Şunlar için en iyi |
|---|---|---|
explore | Salt okunur kod tabanı keşfi, daha hafif bir modelde çalışır | Kodu arama ve özetleme, ilgili dosyaları bulma, yapıyı anlama |
general | Tam tool erişimi, varsayılan modelde çalışır | Okuma, yazma veya komut gerektiren herhangi bir bağımsız görev |
Bağlam ve konuşma geçmişi
Varsayılan olarak, bir subagent üst konuşma geçmişini görmez. Bu, bağlamını yalın ve mevcut göreve odaklanmış tutar.
Bir subagent'in konuşmada daha önce ifade edilen önceki kararları, kısıtlamaları veya tercihleri anlaması gerektiğinde, Bob konuşma geçmişini subagent'e iletmek için fork_context: true ayarlayabilir.
Mod kısıtlamaları
Çalıştığın mod, Bob'un spawn etmesine izin verilen subagent türlerini kontrol eder. Bazı modlar tüm subagent türlerine izin verir; diğerleri spawning'i belirli türlerle kısıtlar veya tamamen yasaklar. Bir subagent spawn'ı etkin mod tarafından izin verilmiyorsa, Bob işi spawn etmeden doğrudan tamamlayacaktır.
Bob subagents'ı ne zaman kullanır
Bob, subagents'ı tutumlu kullanır. Varsayılan, bir subagent spawn etmeden her zaman işi doğrudan yapmaktır. Bir subagent yalnızca aşağıdakilerin tümü doğru olduğunda değerlendirilir:
- Görev açıkça bağımsızdır ve yalnızca bir özet geri alınması gerekir.
- Ana bağlama önemli miktarda ilgisiz içerik ekleyecektir.
- Bir veya iki doğrudan tool çağrısıyla gerçekleştirilemez.
Bob şunlar için subagents kullanmaz:
- Basit dosya okumaları veya hızlı aramalar.
- Tek tool operasyonları.
Paralel subagents paneli
Birden fazla subagent aynı anda çalıştığında — örneğin, paralel olarak birkaç özelleşmiş ajan oluşturan bir iş akışı sırasında — sohbette tek bir daraltılabilir panelde gruplandırılırlar.
Panel başlığı, çalışan tüm subagentlar için toplu istatistikleri gösterir:
- Tamamlanan subagent sayısı / toplam sayı
- Tüm subagentlarda kullanılan toplam araç sayısı
- Birleşik token kullanımı, maliyet ve geçen süre
- Başarısız araç çağrılarının sayısı
Her subagenti ayrı ayrı görmek için paneli genişlet. Her bir giriş, araç çağrılarını incelemek için daha da genişletilebilir. Bir subagent araç hatalarıyla karşılaşırsa, başarısızlık sayısı hem toplu başlıkta hem de bireysel girişte gösterilir.
- İlgili bağlamın zaten mevcut olduğu görevler.
Subagents ve subtasks karşılaştırması
Subagents ve subtasks ilişkili ancak farklı kavramlardır:
| Subagent | Subtask | |
|---|---|---|
| Görünürlük | Arka planda sessizce çalışır | Kendi breadcrumb'ı ve konuşmasıyla UI'da görünür |
| Etkileşim | Etkileşimsiz — yalnızca bir özet döndürür | Tamamen etkileşimli — ilerlemeyi takip edebilir ve konuşmaya devam edebilirsin |
| Amaç | Ana bağlamı kirletmeden bilgi toplama veya izole çalışmayı tamamlama | Özel takip ve ayrı bir thread'den yararlanacak kadar karmaşık işleri yönetme |
| Çıktı | Bob'a döndürülen özet | Bağımsız konuşma thread'i |
Arka plan bilgi toplama için subagents kullan. Görünürlük ve özel bir konuşmadan yararlanan karmaşık çalışmalar için subtasks kullan.
Subagent davranışını yapılandırma
.bob/agents/ dizininde bir agent persona dosyası oluşturarak bir subagentin neye odaklandığını, çıktısını nasıl biçimlendirdiğini ve hangi toolleri kullanabileceğini kontrol edebilirsin. Persona dosyaları bir subagente tanımlı bir rol ve kısıtlamalar seti verir; örneğin, önem derecesine göre sıralanmış bir bulgular tablosu üreten ve açıkça düzeltme önermemesi için talimat verilen bir kod inceleyici.
Kurulum talimatları ve örnekler için Agent personaları sayfasına bakabilirsin.
Modlar
Modlar, Bob'un davranışını senin belirli görevlerine göre şekillendiren uzmanlaşmış personelardır. Her mod, belirli hedefleri daha verimli şekilde gerçekleştirmene yardımcı olmak için farklı yetenekler ve erişim düzeyleri sunar.
Bağlam mention'ları
Bob konuşmalarında @ mention'ları kullanarak projenizin belirli öğelerine doğrudan referans verin ve hassas, bağlam farkında yardım alın.