Kodlama Ajanlarınıza Kendi Sahip Olduğunuz Bir Hafıza Kazandırın

Birden fazla makinede çalışırken ve göreve göre kodlama ajanları (Claude Code, Codex, pi veya Hermes) arasında geçiş yaparken her yeni oturum projeyle sıfırdan tanışır. Oturum kapandığında önceki günlerde yapılan akıl yürütmeler kaybolur. Kodlama ajanları; kod tabanını araştırırken, farklı yaklaşımlar denerken, hatalarla karşılaşıp belgeleri okurken sadece neyin değiştiğini değil, neden değiştiğini de anlatan zengin izler (traces) bırakırlar.

Ancak bu izler yalnızca potansiyel bir hafızadır. Ham oturum kayıtları tek başına pasif bir arşivdir; binlerce tur arasında "neden akış ayrıştırıcısından vazgeçtik?" gibi bir kararın gerekçesini basit arama komutlarıyla bulamazsınız. Bir ajanın bu izleri çalışırken aktif şekilde kullanabilmesi için indeksleme, geri getirme (retrieval), sıralama ve kesin kaynak takibi gerekir. funes, tam olarak bu kalıcı hafıza katmanını yerel makinenizde zaten bulunan oturumlardan inşa eder.

Kullandığınız Ajana Hafıza Ekleyin

funes, harici bir makine öğrenimi çalışma ortamı bağımlılığı bulunmayan tek bir ikili dosyadır (binary). Vektör gömme (embedding) ve yeniden sıralama (reranking) doğrudan kendi makinenizde gerçekleşir. Kurulum ve ajana entegrasyon tek bir komutla tamamlanır:

curl -fsSL https://huggingface.co/buckets/huggingface/funes/resolve/install.sh | sh
funes add claude # veya: codex, pi, hermes

Bu tek add komutu ilk indeksi oluşturur, ajana recall ve get araçlarını kazandırır ve tamamlanan her turu otomatik olarak indeksler. İndeksleme artımsal (incremental) olarak ilerler; yeni çalıştırmalar tüm geçmişi baştan işlemek yerine sadece yeni turları ekler, eski içerikler ise arka planda doldurulur.

Geliştirme sırasında bir görev geçmiş kararlara veya bulgulara temas ettiğinde, ajan recall aracını kendi kendine çağırır. Eski oturumu hatırlamanıza veya bağlamı kopyalayıp yapıştırmanıza gerek kalmaz. Ajan, yanıtının arkasındaki oturumu belirtir; özet yerine ham metni döndürür ve bilginin hangi ajandan, zaman damgasından, oturumdan ve turdan geldiğini gösterir. get komutu ise ilgili turun tüm bağlamını açar. Arka planda deterministik işlem hattı, izleri standart bir tur-blok yapısına dönüştürür, yerel Lance veri kümesine kaydeder, vektör ve BM25 hibrit aramasını çapraz kodlayıcı (cross-encoder) ile yeniden sıralar.

Bu tasarım funes'e üç kritik özellik kazandırır:

• Ajanlar arasında tek bir hafıza: Claude Code, Codex, pi ve Hermes aynı veri yapısına yazar. recall aracı tüm geçmişi tarar ve her bulgunun hangi ajan tarafından üretildiğini gösterir.
• Ham kanıtların korunması: Bilgiler yazma anında yapay özetlere dönüştürülmez. Her sonuç, doğrudan onu üreten konuşma turuna ve kanıtına geri bağlanabilir.
• recall varsayılan olarak yereldir: Hesap açma veya uzak depo zorunluluğu yoktur; barındırılan hiçbir model oturumlarınızı işlemez. İstenirse veriler kullanıcıya ait özel bir Hugging Face veri kümesine taşınabilir.

Yazılım Geliştirme ve Öğrenme Çıkarımları

Yazılım projelerinde bağlam kaybı, geliştiricilerin ve ajanların aynı hataları tekrar yaşamasına ve teknik borcun büyümesine yol açar. funes gibi yerel, bağımsız ve ajanlar arası çalışan bir bellek katmanı, üretim ortamında ajanların güvenilirliğini ve karar tutarlılığını önemli ölçüde artırır. Böylece geliştiriciler, farklı araçlar arasında geçiş yapsalar dahi projelerinin akıl yürütme geçmişine kesintisiz erişebilirler.

Orijinal kaynağa buradan ulaşabilirsiniz.

Bu konuyu derinlemesine öğrenmek isterseniz: Production'da Agent Güvenilirliği modülüne göz atın.