Temel kavramlar

Araçlar

Bob'un dosyaları okumak, kodu düzenlemek, komutları çalıştırmak, alt ajanlar oluşturmak, MCP entegrasyonlarını kullanmak ve kodlama iş akışınızı kolaylaştırmak için modları değiştirmek üzere özel araçları nasıl kullandığını öğrenin.

Araç iş akışı

Bob ile çalıştığınızda, uygun eylemleri belirler. Her adım için Bob:

  1. İsteğinize göre uygun aracı seçer
  2. Aracı parametreleriyle birlikte incelemeniz için sunar
  3. Onaylanan aracı çalıştırır ve sonuçları gösterir
  4. Göreviniz tamamlanana kadar bu süreci devam ettirir

Araç kategorileri

Bob'un araçları birincil işlevlerine göre gruplandırılmıştır. Bu kategorileri anlamak, Bob'un farklı görevleri nasıl gerçekleştirdiğini görmenize yardımcı olur.

Okuma araçları

Okuma araçları, Bob'un değişiklik yapmadan dosya içeriğine erişmesine ve kod yapısını anlamasına olanak tanır.

AraçAmaçÖrnek kullanım
read_fileİsteğe bağlı satır aralıklarıyla bir dosyanın içeriğini okurKonfigürasyon dosyalarını görüntüleme, kaynak kodunu inceleme
globİsim desenine göre dosyaları bulur (örn. **/*.ts)Test dosyalarını bulma, tüm bileşenleri bulma
grepRegex desenleri kullanarak dosya içeriğinde arama yaparFonksiyon tanımlarını bulma, TODO'ları bulma
list_filesDosyaları ve dizinleri listelerTek bir dizinin yapısına göz atma
GetSymbolsOverviewBir dosyadaki üst düzey sembolleri alırDerinlemesine dalmadan önce dosya yapısını anlama
FindSymbolİsteğe bağlı derinlikle isim yoluna göre sembol ararBir sınıfa, metoda veya fonksiyona gitme
FindReferencingSymbolsBir sembole yapılan tüm referansları bulurBir fonksiyonun veya türün nerede kullanıldığını anlama

Bob, isteğiniz kod inceleme, desen arama veya proje yapısını inceleme içerdiğinde okuma araçlarını kullanır.

Yazma araçları

Yazma araçları, Bob'un yeni dosyalar oluşturmasına veya mevcut kodu değiştirmesine olanak tanır.

AraçAmaçÖrnek kullanım
write_fileYeni bir dosya oluşturur veya mevcut bir dosyayı tamamen yeniden yazarYeni bileşenler oluşturma, konfigürasyon dosyaları oluşturma
apply_diffBir dosyanın belirli bölümlerine hassas, hedefli değişiklikler uygularFonksiyon mantığını güncelleme, hataları düzeltme, kodu yeniden düzenleme
insert_contentBir dosyada belirli bir konuma yeni satırlar eklerImport'lar ekleme, yeni fonksiyonlar ekleme
search_and_replaceBir dosyada metin veya regex desenlerini bulur ve değiştirirDeğişkenleri yeniden adlandırma, tekrarlanan desenleri güncelleme

Bob, isteğiniz dosya oluşturma, özellik uygulama, hata düzeltme veya kod yeniden düzenleme içerdiğinde yazma araçlarını kullanır.

Komut araçları

Komut araçları, Bob'un komutları çalıştırmasına ve sistem işlemlerini gerçekleştirmesine olanak tanır.

AraçAmaçÖrnek kullanım
execute_commandÇalışma alanınızda CLI komutlarını çalıştırırBağımlılıkları yükleme, testleri çalıştırma, projeleri derleme

Bob, isteğiniz komutları çalıştırma, paketleri yükleme, betikleri çalıştırma veya sistem işlemlerini gerçekleştirme içerdiğinde komut araçlarını kullanır.

Alt ajan araçları

Alt ajan araçları, Bob'un kendi izole bağlamında odaklanmış, bağımsız işleri yönetmek için bağımsız bir ajan oluşturmasına olanak tanır.

AraçAmaçÖrnek kullanım
spawn_subagentKendi bağlam penceresi olan bağımsız bir ajan oluştururKod tabanının bir bölümünü araştırma, ana bağlamı kirletmeden bilgi toplama

Alt ajanlar nasıl çalışır

Bir alt ajan, ana konuşmadan bağımsız olarak çalışır. Kendi bağlam penceresine sahiptir, atanan görevini yürütür ve sonuçların bir özetini Bob'a geri döndürür. Bu, alt ajanları ana konuşmaya büyük miktarda alakasız içerik ekleyecek işler için yararlı hale getirir.

Bob alt ajanları idareli kullanır. Varsayılan her zaman işi doğrudan yapmaktır. Bir alt ajan yalnızca aşağıdakilerin tümü doğru olduğunda düşünülür:

  • Görev açıkça bağımsızdır ve yalnızca bir özet geri gereklidir
  • Ana bağlama önemli alakasız içerik ekleyecektir
  • Bir veya iki doğrudan araç çağrısıyla gerçekleştirilemez

İki alt ajan türü vardır:

TürAçıklama
exploreSalt okunur kod tabanı keşfi, daha hafif bir modelde çalışır
generalTam araç erişimi, varsayılan modelde çalışır

Varsayılan olarak, bir alt ajan üst konuşma geçmişini görmez. fork_context: true ayarı, önceki kararları, kısıtlamaları veya kullanıcı tercihlerini anlaması gerektiğinde konuşma geçmişini alt ajana iletir.

Bob, basit dosya okumaları, hızlı aramalar, tek araç işlemleri veya zaten ilgili bağlama sahip olduğu görevler için alt ajanları kullanmaz.

Alt görev araçları

Alt görev araçları, Bob'un UI'da kendi özel konuşması olarak çalışan yeni, adlandırılmış bir görev örneği oluşturmasına olanak tanır.

AraçAmaçÖrnek kullanım
start_subtaskBaşlık, talimatlar ve isteğe bağlı yapılacaklar listesi olan yeni bir görev oluştururBüyük bir isteği kendi konuşma dizisi olan izlenen bir alt göreve bölme

Alt görevler nasıl çalışır

Bir alt görev, UI'da kendi içerik haritası ve konuşma geçmişi ile görünen tamamen bağımsız bir görevdir. Arka planda sessizce çalışan ve yalnızca bir özet döndüren bir alt ajandan farklı olarak, bir alt görev görünür ve etkileşimlidir. İlerlemesini takip edebilir, çıktısını inceleyebilir ve içinde konuşmaya devam edebilirsiniz.

Bob, bir istek özel izleme ve ayrı bir konuşma dizisinden yararlanacak kadar karmaşık olduğunda alt görevleri kullanır. Bir alt göreve şunlar verilebilir:

  • UI içerik haritasında gösterilen bir başlık
  • Ayrıntılı talimatlar içeren bir mesaj
  • Adımları izlemek için bir başlangıç yapılacaklar listesi
  • Başlatmak için isteğe bağlı bir mod (örneğin, tasarım çalışması için Plan modu)

MCP araçları

MCP araçları, Bob'un bağlı Model Context Protocol (MCP) sunucuları aracılığıyla yeteneklerini genişletmesine olanak tanır.

AraçAmaçÖrnek kullanım
MCP sunucu araçlarıBağlı MCP sunucuları tarafından sağlanan araçlara erişirVeritabanlarını sorgulama, API'lerle etkileşim kurma, harici hizmetlere erişme

Bob, isteğiniz yapılandırılmış MCP sunucuları tarafından sağlanan yetenekleri (monday.com, ürün bilgi tabanları veya özel entegrasyonlar gibi) içerdiğinde MCP araçlarını kullanır.

Mod araçları

Mod araçları, Bob'un özel görevler için farklı modlar arasında geçiş yapmasına olanak tanır.

AraçAmaçÖrnek kullanım
switch_modeFarklı bir moda geçiş yapar (Agent, Plan, Ask, vb.)Mimari tasarım için Plan moduna, uygulama için Agent moduna geçiş

Bob, isteğiniz farklı bir mod ve onun özel yetenekleri tarafından daha iyi ele alındığında mod araçlarını kullanır.

Beceri araçları

Beceri araçları, Bob'un belirli alanlar ve görevler için özel talimat setlerini etkinleştirmesine olanak tanır.

AraçAmaçÖrnek kullanım
use_skillAdlandırılmış bir beceri için ayrıntılı talimatları mevcut bağlama yüklerCarbon builder becerisini etkinleştirme, Jira iş akışı rehberliğini yükleme

Beceriler, Bob'un yerleşik bilgisini seçilmiş, alana özgü talimatlarla genişletir. Bir istek bir beceriyle eşleştiğinde — Carbon Design System bileşenleriyle çalışmak, DITA belgeleri yazmak veya Jira sprint'lerini yönetmek gibi — Bob devam etmeden önce tam rehberliğini yüklemek için konuşma başına bir kez ilgili beceriyi etkinleştirir.

İş akışı araçları

İş akışı araçları, Bob'un belirli tekrarlayan görevler için tasarlanmış önceden tanımlanmış, çok adımlı süreçleri başlatmasına olanak tanır.

AraçAmaçÖrnek kullanım
start_workflowKendi yapılandırılmış adımları olan adlandırılmış bir iş akışı başlatırPull request oluşturma, kod incelemesi yapma

İş akışları, yaygın görevler için seçilmiş adım adım süreçlerdir. Bob, bir istek bir iş akışının amacıyla açıkça eşleştiğinde bunları kullanır — örneğin, bir git diff'ten PR açıklaması oluşturma veya temel dala karşı kod değişikliklerini inceleme.

Yapılacaklar araçları

Yapılacaklar araçları, Bob'un görünür bir kontrol listesi kullanarak çok adımlı görevlerdeki ilerlemeyi izlemesine olanak tanır.

AraçAmaçÖrnek kullanım
update_todo_listGörev adımlarının markdown kontrol listesini oluşturur veya güncellerUygulama adımlarını izleme, tamamlanan öğeleri işaretleme, yeni keşfedilen görevleri ekleme

Bob, birden fazla adımı olan karmaşık görevler için yapılacaklar izlemeyi kullanır. Liste, iş ilerledikçe güncellenir — öğeler tamamlandı olarak işaretlenir, yeni keşfedilen adımlar eklenir ve aynı anda bir öğe devam ediyor tutulur. Bu, neyin yapıldığı ve neyin kaldığı konusunda net bir görünüm sağlar.

Soru araçları

Soru araçları, Bob'un görevleri tamamlamak için gereken ek bilgileri toplamasına olanak tanır.

AraçAmaçÖrnek kullanım
ask_followup_questionAçıklama veya ek ayrıntı isterTercih edilen uygulama yaklaşımı hakkında soru sorma, eksik bilgi isteme

Bob, isteğiniz devam etmeden önce daha fazla bilgi veya açıklama gerektirdiğinde soru araçlarını kullanır.

Bu konu nasıl?