Agent iş akışları · 2026-09-22

Claude API ile uzun çalışan kodlama ajanında bağlam yönetimi

Bir kodlama ajanı saatlerce sürdüğünde bağlam penceresinin nasıl dolduğunu, hangi geçmişin özetlenip hangisinin olduğu gibi tutulması gerektiğini ve oturum sürekliliğini anlatır.

Uzun bir kodlama oturumunda eski turların özetlenip yakın geçmişin olduğu gibi tutulduğunu gösteren bağlam penceresi doluluk şeması.

Bağlam penceresi neden bir kodlama ajanında daha hızlı dolar

Claude API Türkiye rehberinde ele alınan model seçimi kriterleri kaliteyi ve maliyeti karşılaştırır; uzun süre çalışan bir kodlama ajanında üçüncü bir kısıt devreye girer: bağlam penceresi. Her araç çağrısı, dosya okuma sonucu ve komut çıktısı bağlama eklenir; bir refactor görevinde onlarca dosya okunduğunda pencere saatler içinde dolabilir.

Bu, tek seferlik bir soru-cevap etkileşiminden farklı bir mühendislik sorunudur: model uzun bir geçmişi taşımak zorunda kalırken hem maliyet artar hem de çok eski bir aracın çıktısı güncel karar için gereksiz hâle gelir.

Neyi özetleyin, neyi olduğu gibi tutun

Genel kural, yakın geçmişi (son birkaç araç çağrısı ve sonucu) olduğu gibi tutup daha eski turları bir özetle değiştirmektir. Örneğin bir dosyanın tam içeriğini okuyan bir araç çağrısı, o dosya üzerinde değişiklik yapıldıktan sonra artık güncel değildir; tam içeriği bağlamda tutmak yerine 'X dosyası Y amaçla değiştirildi' gibi kısa bir özetle değiştirmek yer açar.

Kritik olan, özetleme sırasında görevin nihai hedefini ve henüz tamamlanmamış adımları kaybetmemektir. Bir oturum başlarken görev tanımını ve kabul kriterlerini sabit bir blok olarak tutup yalnızca ara adımların geçmişini özetlemek, ajanın saatler sonra bile neden bu işi yaptığını hatırlamasını sağlar.

  • Son birkaç aracın çıktısını olduğu gibi tutun; daha eskisini özetleyin.
  • Değişmiş bir dosyanın eski tam içeriğini bağlamda tutmayın, kısa bir özetle değiştirin.
  • Görev tanımı ve kabul kriterlerini sabit bir blok olarak koruyun, özetlemenin dışında tutun.

Oturum sürekliliği: çökme sonrası nereden devam edilir

Uzun bir ajan oturumu ağ hatası veya zaman aşımıyla kesilebilir. Görev durumunu (tamamlanan adımlar, kalan adımlar, son bilinen dosya durumu) periyodik olarak bağlam dışında bir yere yazmak, oturum yeniden başladığında sıfırdan analiz yapmak yerine kaldığı yerden devam etmeyi mümkün kılar.

Sık sorulan sorular

Bağlam penceresi dolduğunda istek otomatik olarak mı kesilir?

Pencere sınırını aşan bir istek hata döner; otomatik kesme veya sessiz özetleme yapılmaz. Bağlamı sınır altında tutmak istemci tarafının veya ajan çatısının sorumluluğundadır.

Her ajan çatısı (framework) bağlam özetlemeyi kendisi mi yapar?

Değişir. Bazı ajan çatıları otomatik özetleme sunar, bazıları bu kararı geliştiriciye bırakır. Kullandığınız çatının bu davranışı destekleyip desteklemediğini kontrol etmeniz gerekir.

İlgili yazılar