Hafıza ve kararlar

Agentbits kalıcı bir hafıza tutar; böylece lider ve ajanlar her çalışmada sıfırdan başlamaz. Hafıza kayıtları kısa bağlam parçalarıdır: bir görevin ne ürettiği, liderin neyi düzeltmeyi istediği, sohbette ne söylediğin, hangi kararların kabul edildiği. Bir ajan çalışmaya başlamadan önce en alakalı kayıtlar prompt’una eklenir.

Hafıza bilgisayarındaki yerel veritabanında, tam metin aramasıyla (SQLite FTS5) saklanır. Ajanın kullandığı sağlayıcıya giden prompt’lar dışında hiçbir yere gönderilmez.

Proje hafızası ve organizasyon hafızası

Her kaydın bir kapsamı vardır:

Kapsam	Nerede kullanılır	Tipik içerik
Proje hafızası	Yalnızca o projede	Görev özetleri, inceleme notları, sohbet bağlamı, kabul edilen kararlar
Organizasyon hafızası	Tüm projelerde	Genel tercihlerin ve ortak kuralların, örneğin “Tüm UI metinleri Türkçe olmalı; kod yorumları İngilizce.”

Bir ajan bir projede çalışırken o projenin hafızasını ve organizasyon hafızasını görür. Başka bir projenin hafızasını hiçbir zaman görmez; bir müşterinin ya da kod tabanının bağlamı diğerine sızmaz.

Bir kayıt ayrıca tüm ajanlar için ortak olabilir ya da tek bir ajana ait olabilir. Örneğin inceleme geri bildirimi, işi geri gönderilen ajan için saklanır.

Hafızaya neler yazılır

Agentbits şu kayıtları kendiliğinden, hepsini projenin hafızasına yazar:

• Görev özetleri: ajan bir görevi bitirince raporunun özeti.
• İnceleme geri bildirimi: lider bir görevi geri gönderince notu.
• Sohbet mesajların: projede gönderdiğin 20 karakter ve üzeri mesajlar.
• Kabul edilen kararlar: en yüksek önemle, böylece her zaman dikkate alınırlar.

Kendin kayıt eklemek için Ayarlar → Hafıza’yı kullan:

• Kapsamı seç: Organizasyon geneli ya da Bu proje.
• Kaydı yaz, örneğin tüm ekibin uyması gereken bir kural.
• Kimin için olduğunu seç: Ortak (tüm ajanlar) ya da yalnızca bir ajan.
• Organizasyon hafızasına ekle ile, proje kapsamında da proje adı hafızasına ekle ile kaydet.

Aynı ekranda hafızada arama yapar ve kayıt silersin.

Hafıza prompt’a nasıl girer

Bir ajan her göreve başladığında Agentbits hafızada görevin başlığı ve açıklamasıyla arama yapar. Sohbet cevapları da projenin hafızasından yararlanır. Eşleşmeler şunlara göre sıralanır:

• Alaka: metne ne kadar uyduğu en çok sayılır (%60).
• Önem: ardından gelir (%30). Kabul edilen kararların önemi en yüksektir, inceleme notları ve görev özetleri daha düşüktür.
• Tazelik: en az sayılır (%10). Yeni kayıtlar daha üstte çıkar; etkisi birkaç hafta içinde azalır.

Kabul edilen kararlar gibi önemi çok yüksek kayıtlar, hiçbir kelime eşleşmese de eklenir. En üstteki kayıtlar (en fazla sekiz) ajanın sistem prompt’una “Relevant memory” adlı bir bölüm olarak girer; bu bölüm ajana, aksini gösteren bir şey yoksa bunları doğru kabul etmesini söyler.

Bir ajana tam olarak ne gittiğini görebilirsin: Terminal → Ajan terminalleri’nde bir çalışmanın Gönderilen tam prompt kaydını aç ve Sistem promptu’na bak. Bkz. Terminaller.

Not: Hafıza anlamsal (embedding) arama değil, metin araması kullanır; anlamsal arama planlı. Görevden farklı kelimeler kullanan bir kayıt bulunmayabilir. Önemli kuralları kısa tut ve ajanların görevlerde göreceği kelimelerle yaz.

Kararlar

Kararlar ADR (mimari karar kaydı) tarzı kayıtlardır: Bağlam, Karar ve Gerekçe. Her projenin Decisions bölümünde (Ctrl+7) kendi Karar Kaydı vardır.

Bir kararın dört durumundan biri olur: Önerildi, Kabul, Red ya da Geçersiz.

Kararlar nasıl alınır

1. Bir ajan ya da lider önerir. Ajanlardan önemli kararları çıktılarında bildirmeleri istenir; lider de sohbette karar önerebilir. Bunlar Karar Kaydı’na Önerildi olarak düşer, üst çubukta bir sayaç belirir ve sohbetteki bir mesaj onlara işaret eder.
2. Sen karar verirsin. Kararı aç, gerekirse düzenle ve Kabul et’e tıkla, reddet ya da daha sonra yeni bir kararla Geçersiz kıl. Silebilirsin de.
3. Kabul edilen kararlar hafızaya girer. Kabul edilen karar en yüksek önemle projenin hafızasına yazılır; o andan itibaren projede çalışan her ajana ulaşır.

Kararı kendin de yazabilirsin: Yeni’ye tıkla, alanları doldur ve Öner ya da Doğrudan kabul et’i seç.

Kararları hızlıca bulmak için süzgeci kullan (Tümü, Önerilen, Kabul, Red).

Hafızayı temizlemek

• Ayarlar → Veri yönetimi tek bir projeyi temizler: proje hafızası, sohbet, çalışma kayıtları, raporlar, kararlar, görevler ya da dosyalar, istediğin bileşimde. Geri kalanı temizlerken kabul edilen kararları tutmak için Karar hafızasını koru’yu işaretle.
• Aynı ekran Organizasyon geneli hafıza’yı da temizler; orada da Kararları koru seçeneği var.
• Proje ayarlarındaki Hafızayı ve geçmişi temizle → Verileri yönet bu ekranı ilgili proje seçili olarak açar.
• Projeyi silmek proje hafızasını siler. Bir ajanı silmek onun kişisel hafızasını siler.

Yedekler ve sıfırlama için bkz. Ayarlar.

İpucu: Her yerde geçerli kuralları (“İngilizce cevap ver”, “Production veritabanına asla dokunma”) organizasyon hafızasına, projeye özgü bilgileri proje hafızasına ya da kabul edilmiş bir karar olarak yaz.