Temel kavramlar

Context window yönetimi

Bob'un 270.000 tokenlik context window'unun nasıl çalıştığını, her kategorinin token kullanımına nasıl katkıda bulunduğunu ve task'ları odaklı tutup maliyet verimliliğini korumak için en iyi uygulamaları öğrenin.

Context window'u anlamak

Chat panelindeki her task'ın bir context window'u vardır — o thread için token bütçesi. Üst sınır 270.000 token'dır. Bob'un yüklediği her şey bu sınıra sayılır.

Window'u dolduran şeyler

Context window'unu nelerin tükettiğine dair bir döküm görmek için chat panelinin sağ üst köşesindeki token usage indicator'ın üzerine gelin:

Context window breakdown panel showing token usage by category
Kategoriİçerdiği şeyler
System promptOturum için Bob'un temel talimatları
Tool definitionsYerleşik araç şemaları ve bağlı MCP araç tanımları
MCP ToolsBağlı MCP sunucularının sağladığı araçların talimatları ve açıklamaları
RulesProje ve mod rule dosyalarından özel talimatlar (örneğin, AGENTS.md veya .bob/rules-*)
SkillsBob'un konuşma için yüklediği skills'ten gelen talimatlar
MessagesPrompt'larınız, Bob'un yanıtları ve konuşmadaki araç etkinlikleri. Token olarak sayılan transcript budur.

@ bahisleri, komut çıktıları ve araç sonuçları Messages'a sayılır. Dosya içerikleri ayrı bir satır almaz.

Estimated breakdown altında:

  • Reserved for model response: Bob'un bir sonraki yanıtı için ayrılan token'lar (genellikle 20,0k).
  • Available space: Kalan boş token'lar.

Temel ek yük

Sabit kategoriler, Bob ile çalışmaya başlamadan önce context tüketir. Galaxium Travels örnek projesinde, "Quickly say hi back." bile yaklaşık 8,5k token'a ulaşır. Bunun büyük kısmı Tool definitions (5,1k), System prompt (1,5k), Rules (830) ve Skills (454)'tir. Yalnızca 590 token Messages'dadır.

Bob her prompt'ta tam ek yük yığınını yeniden gönderir. Daha fazla MCP sunucusu veya yüklü skill, siz bir şey yazmadan önce MCP Tools, Tool definitions ve Skills'i artırır.

Pratik sayılar ve sıfırlama rehberi için bkz. Create a new context window.

Token kullanımını izlemek

Token usage indicator, 270.000 tokenlik sınıra karşı doluluk yüzdesini ve kullanılan/toplam kesrini gösterir. Context window breakdown'ı açmak için üzerine tıklayın. Hangi kategorinin büyüdüğünü kontrol edin.

Aşağıdaki tablo her kategoriyi nelerin etkilediğini göstermektedir:

KategoriBüyümesine neden olan şeyler
System promptTask başladığında yüklenir. Normal çalışma sırasında sabit kalır.
Tool definitionsYerleşik araç şemaları. Task başladığında ayarlanır. Normal çalışma sırasında sabit kalır.
MCP ToolsBağlı MCP sunucuları ve etkin araçlar. Sunucu veya araç eklediğinizde büyür, prompt gönderdiğinizde değil.
RulesProje ve mod rule dosyaları (örneğin, AGENTS.md). Task açıldığında ayarlanır.
SkillsBob'un task için yüklediği skill'ler. Bob thread ortasında bir skill etkinleştirirse artabilir.
MessagesPrompt'larınız, Bob'un yanıtları, dosya okumaları, araç çıktısı ve @ bahisleri. Her turda ve repo keşfinde büyür.

Kısa bir alışverişte, sabit kategoriler çoğu zaman toplamın büyük kısmını kullanır. Bob'dan dosya okumasını veya araç çalıştırmasını istediğinizde, Messages genellikle en büyük kategori haline gelir. Bu değişimi izleyin.

Available space, herhangi bir kategori büyüdükçe küçülür. Reserved for model response, Bob'un bir sonraki yanıtı için ayrılmıştır. Yukarıda gösterilen kullanılan toplamın bir parçası değildir.

Gerçek bir repo'daki ölçülen örnekler için bkz. Create a new context window.

Token sınırları

Task başına sert sınır 270.000 token'dır. Bob, sınıra ulaşmadan önce sıkıştırmaya başlar. Sıkıştırma genellikle toplam kullanımın yaklaşık 190.000 token civarında başlar.

Otomatik context condensation

Sıkıştırma eşiğinde Bob:

  1. En son ve en ilgili context'i korur.
  2. Eski konuşma segmentlerini özetler veya kaldırır.
  3. Kritik sistem talimatlarını, tool definitions'ı, rules'u ve skills'i korur.
  4. Sıkıştırılmış context ile devam eder.

Condensation kayıplıdır. Messages'ın başındaki ayrıntılar hayatta kalamayabilir. Konu değiştiğinde veya Messages kaliteyi olumsuz etkileyecek kadar büyüdüğünde + (New task) ile yeni bir task başlatın.

Bobcoins üzerindeki etki

Bobcoins token kullanımını izler. Hem giriş hem de çıkış token'ları sayılır.

  • Her mesaj, sabit ek yük dahil tüm aktif context'i yeniden gönderir.
  • Bob her gönderimde zaten yüklü olanı yeniden işler.
  • Ağır Messages içeren uzun thread'ler, sonraki prompt başına daha pahalıya gelir.

En iyi uygulamalar

Context window depolama alanı değildir. Her adımda Bob'un kullanabileceği çalışma belleğidir. İçine nelerin girdiğini kontrol edin. Thread eski çıktılarla dolduğunda sıfırlayın veya sıkıştırın. Sonucu yalnızca Bob'un yanıtıyla değil, testlerle doğrulayın.

Task'ı ve konuşmayı kapsamlandırmak

Çalışma hedefi başına bir task kullanın ve dar bir prompt ile başlayın. Bob'dan repo'yu keşfetmesini istemeden önce hedefi, beklenen sonucu ve kısıtlamaları belirtin. Dosyaları ve fonksiyonları açıkça adlandırın. "Tüm repo'yu oku" veya "backend'i kontrol et" gibi belirsiz isteklerden kaçının. Konu değiştiğinde + (New task)'a tıklayın — Messages'daki ilgisiz içerik maliyet ekler ve Bob'u karıştırabilir.

Kalıcı context'i yalın tutmak

Sabit kategoriler siz bir şey yazmadan token tüketir. Bu ek yükü düşük tutmak için:

  • Custom rules'u ve AGENTS.md'yi kısa tutun — oraya yalnızca kurulum, test ve stil komutları koyun (örneğin, pnpm test, mvn verify).
  • Yalnızca mevcut çalışmanın ihtiyaç duyduğu MCP sunucularını, araçları ve skills'i bağlayın. Kullanmadığınızı bağlantısını kesin ve global yerine proje kapsamlı MCP yapılandırmasını tercih edin.
  • Messages'ı bu task'a özgü durumsal kanıtlar için — hata, log'lar ve ilgili dosyalar — ayırın. Her prompt'ta kalıcı rules'u tekrarlamayın.

İhtiyaç duyduğunuzda context eklemek

Thread'e büyük içerik blokları yapıştırmak yerine Bob'un hedefli dosyaları aramasına ve okumasına izin verin. Belirli bir dosyaya veya satır aralığına başvurmak için context mentions kullanın ve geniş dizin bahislerinden kaçının:

✓ @/src/utils/validation.ts:45-67 Fix the email validation logic
✗ @/src @/tests @/docs Review everything and suggest improvements

Editörde metin seçip Cmd + L (Mac) veya Ctrl + L (Windows/Linux) kullanarak doğrudan chat'e ekleyebilirsiniz.

Aşamalı çalışın — muhtemel dosyaları bulun, ilgili olanları inceleyin, planlayın, değiştirin ve doğrulayın. Geniş repo okumaları için subagents kullanarak her read_file çağrısının Messages'a düşmesi yerine task'ın sıkıştırılmış sonuçlar almasını sağlayın. Kaynaklar çeliştiğinde eski yorumlar veya eski README notlarına değil, çalışan kod ve testlere güvenin.

Büyük repo'lar için daha fazla taktik için bkz. Working with large projects.

Messages dolduğunda sıfırlamak veya sıkıştırmak

Uzun bir konuşma boyunca Messages, tekrarlanan dosya içerikleri, terk edilmiş planlar ve eski araç çıktısı biriktirir. Çalışma hedefi değiştiğinde veya thread kaliteyi olumsuz etkileyecek kadar büyüdüğünde + (New task) ile yeni bir task başlatın. Kısıtlamaları, kanıtları ve açık soruları koruyun — geri kalanını kaldırın.

Bob ayrıca eski segmentleri otomatik olarak sıkıştırabilir, ancak condensation kayıplıdır ve Messages'ın başındaki ayrıntılar hayatta kalamayabilir. Diff'lerin incelenebilir kalması ve Bob'un yolda kalması için büyük bir otonom çalıştırma yerine küçük, onaylanmış değişiklikleri tercih edin.

Daha fazla bilgi

Galaxium Travels örnek projesinde dökümü açmak ve sıfırlama pratiği yapmak için bkz. Create a new context window.

Bu konu nasıl?