Workspace hafızası

Agent'lar bir görevde öğrendiklerini normalde bir sonraki göreve taşımaz, çünkü her koşu temiz başlar (Hafıza ve bağlam). Workspace hafızası bunun bilinçli istisnasıdır. Koşulardan damıtılan kalıcı, kısa notlar (en fazla 500 karakter) saklanır ve tamamı her yeni koşunun başında agent'a otomatik hatırlatılır. "E-postalar resmi dille yazılır" düzeltmesini bir kez yaparsınız, sistem bunu öğrenir ve bir daha sormaz.

#Nasıl öğrenir?

İki yol vardır ve ikisi de sizin ekstra bir şey yapmanızı gerektirmez.

1. Doğal akışta. Bir koşu biterken agent, kalıcı bir öğrenme varsa onu kendisi damıtır. Sistem ayrıca güçlü sinyalleri arka planda değerlendirir, örneğin revizyon geri bildirimini, "bundan sonra…" gibi ifadeleri ve art arda başarısız olup sonunda çözülen işlemleri. Bu değerlendirme sizin LLM anahtarlarınızı harcamaz, sunucudaki yerel modelde çalışır.
2. Elle. Ayarlar → Memory sekmesinden (Admin) veya profilinizin Hafıza sekmesinden kendiniz not ekleyebilirsiniz.

Sohbette de iki biçimde çalışır. "Bundan sonra raporları maddeler halinde yaz" gibi açık bir talimat verdiğiniz anda not sabit (📌) olarak kaydedilir. "Unutma" demeseniz bile doğal akışta paylaştığınız kalıcı bir bilgi ("Zonguldak'ta yaşıyorum" gibi) konuşma sakinleştikten birkaç dakika sonra arka planda değerlendirilip normal not olarak alınır. Dil de fark etmez, çünkü tespit kalıp üzerinden değil niyet üzerinden yapılır ve Japonca ya da Fransızca yazsanız da aynı şekilde çalışır. Gelip geçici haller ("bugün yorgunum") ve sağlık ya da inanç gibi hassas konular, siz açıkça istemedikçe kaydedilmez.

Görev kartındaki yorumlarınız da aynı süzgeçten geçer. Bir yorumunuzun ardından agent cevap yazdıysa, kart incelemeden geri döndüyse ya da hatalı bir madde sonradan tamamlandıysa, kart sakinleşince yorumlarınız arka planda değerlendirilir. Bu, işi Claude Code gibi dışarıdan bağlanan bir agent yaptığında da çalışır, çünkü Orbi agent'ın konuşmasına değil kartta bıraktığınız düzeltmeye bakar. Notun kaynağında kart ve yorum görünür. Kimsenin karşılık vermediği bir yorum ve işi onaylayıp kapatan bir yorum değerlendirilmez.

Sizden istenen iş de hafıza değildir. "Projeleri listele", "görseli anlat", "şu konuda bir yazı yaz" gibi istekler o anki işi söyler, sizinle ilgili kalıcı bir şey söylemez, bu yüzden not olmaz. Agent'a bir akış, koleksiyon ya da takvim etkinliği kurdururken verdiğiniz ayrıntılar (saat, konum, bütçe, beğendiğiniz mutfak) da not olmaz, çünkü kurulan şey onları zaten taşır. Agent sohbet sırasında kendi başına da not yazamaz. Koşu içinde yalnızca sizin açıkça "bunu unutma" dediğiniz şeyi kaydeder, gerisini arka plandaki değerlendirme süzer. Yine de hafızada yersiz bir not görürseniz Ayarlar → Memory'den silin, silinen not arşive iner ve gerekirse geri alınır.

#Üç kapsam

Kapsam	Kimi etkiler	Kim görür
Workspace	Herkesin koşuları	Tüm üyeler
Proje	Yalnızca o projedeki koşular	Tüm üyeler
Kişisel	Yalnızca sizin başlattığınız koşular	Yalnızca siz, Admin dahil kimse göremez

"Bana kısa özet ver" gibi kişisel tercihler kişisel kapsamda tutulur. Agent bunları davranışına yansıtır ama paylaşılan çıktılara yazmaz. Emin olunamayan durumda sistem kişisel kapsamı seçer, çünkü kişisel bir tercihin herkese uygulanması, paylaşılan bir kuralın kişisel kalmasından daha rahatsız edicidir.

#Yönetim ve sabitleme

• Ayarlar → Memory. Workspace ve proje notlarını herkes görür. Ekleme, düzenleme, arşivleme ve kalıcı silme Admin'dedir.
• Profil → Hafıza. Kendi kişisel notlarınızı tam yetkiyle yönetirsiniz.
• Claude Code sohbetlerimden öğren. Profil → Hafıza'nın üstündeki anahtar kapalı gelir. Açarsanız Claude Code'da yazdığınız kendi mesajlarınız oturum sonunda Orbi'ye gönderilir ve içlerinden kalıcı tercih ve kurallar çıkarılır. Bir mesajdan not çıkması için kuralın "bundan sonra", "her zaman", "biz … yapmayız" gibi kalıcılık bildiren bir sözle söylenmiş olması gerekir; tek bir işe dair talimat, onay ya da tartışma not olmaz. Modelin cevapları, Claude Code'un bağlam sıkıştırırken yazdığı özet ve dosyalar gönderilmez. Anahtar size bağlıdır, token'a değil: kapattığınızda bütün bilgisayarlarınızda kapanır ve token yenileseniz de kapalı kalır. Çalışması için bilgisayarınızda hafıza protokolünün tam kademesi kurulu olmalıdır (orbi-node memory install --tier full). Kanca Orbi'ye kişisel bir token ile bağlanır; token'ı Profil → Araç erişimi sekmesinde üretir ve kurulumun oluşturduğu .orbi/hooks/env dosyasına yazarsınız. Kurulum bu onayı dosyaları yazmaktan ayrı sorar. Kanca üst üste üç oturumda hiç mesaj okuyamazsa aynı yerde bir uyarı görürsünüz; istemcinin kayıt biçimi değişmiş olabilir.
• Tuval. Masaüstünde hafıza bir ağaç olarak çizilir. Solda konular ve not sayıları durur, bir konuya tıklayınca tuval o konunun notlarını gösterir. Notun türü şeklinden okunur: kural kalın sol kenarlı, ders kesik çizgili, karar çapraz köşelidir. Çelişkili not sarı, eskimiş not soluk görünür. Şekillerin anahtarı tuvalin sol altındadır. Bir nota tıklayınca sağda çekmece açılır. Çekmecede notun kaynağı, alıntısı, kaç koşuya girdiği, bağları ve geçmişi (kim arşivledi, kim konusunu değiştirdi, kim sabitlemeyi kaldırdı) yer alır. Düzenleme, sabitleme, arşivleme ve konu değiştirme de oradadır.
• Çelişkiyi çözmek. Çelişkili notun çekmecesinde iki not yan yana durur. "Bunu tut" düğmesi onay ister ve sonucunu önceden söyler. Sabit notu tutarsanız yeni not arşive iner. Yeni notu tutarsanız eski not geçersiz sayılır, yenisi sabitlenir.
• Konular. Admin konu ekler, adını değiştirir, siler ya da başka bir konuyla birleştirir. Birleştirmede notlar hedef konuya taşınır, kimlikleri ve bağları değişmez. Silinen konunun notları silinmez, Gelen kutusuna iner. Agent'ın açtığı konu listede işaretlidir.
• Yeni agent notları. Konuların altındaki kutu son yedi günde agent'ların yazdığı not sayısını gösterir. Onay gerekmez. "Yalnız bunları göster" ile hepsine tek bakışta göz atabilirsiniz.
• Ölçüm. Tuvalin üstündeki şerit dört sayı gösterir: arşivlenen not oranı, dış istemcilerden gelen not sayısı, son otuz günde bir koşuya giren not sayısı ve her koşunun başında okunan iskeletin boyutu. Şeridi gizleyebilirsiniz, tercihiniz hatırlanır.
• Liste görünümü. Arşiv, kalıcı silme, tür filtresi ve arama liste görünümündedir. Telefonda tuval yoktur, hafıza yalnız liste olarak açılır.
• Sabitleme (📌). Elle eklediğiniz veya düzenlediğiniz not otomatik sabitlenir. Sohbette "bunu asla unutma" gibi açık bir talimat verdiğinizde agent'ın kaydettiği not da sabit doğar, çünkü söz sizindir ve agent yalnızca katiptir. Sabit nota agent'lar ve otomatik damıtıcı bir daha dokunamaz, hafıza çok büyürse bile koşu bağlamında tam metniyle öncelikli kalır. İnsan sözü her zaman üstündür.
• Çelişki bayrağı (⚠). Agent, sabitlenmiş bir notla çelişen yeni bir öğrenme görürse notu değiştirmez. Üzerine bayrak diker ve kararı size bırakır. Workspace yöneticilerine bildirim gider, bildirime tıklayınca hafıza ekranı çelişen nota açılır. Not kişiselse bildirim yalnız sahibine gider. Çelişen not, siz karar verene kadar hiçbir koşuya girmez. Sabit bir kurala benzeyen yeni kural önce "Kontrol ediliyor" etiketiyle doğar ve koşulara girmez. Orbi iki kuralın çelişip çelişmediğine arka planda bakar, bu birkaç dakika sürer. Kurallar uyumluysa not kendiliğinden etkinleşir ve size bildirim gelmez, çelişiyorsa bayrak o zaman dikilir.
• Silme arşive indirir. Agent'ın sildiği not aslında arşive iner ve geri alınabilir. Kalıcı silme yalnızca arayüzden yapılır.
• Tür ve konu. Her not bir türle saklanır: kural, bilgi, ders, karar, kısıt ya da referans. Karar notu gerekçesini de taşır. Notlar konu başlıkları altında toplanır (Çalışma kuralları, Yazım, Kod, Ortam, Ürün kararları, Kişiler, Müşteri kuralları, Gelen kutusu); konusu belirtilmeden yazılan not önce Gelen kutusuna girer, birkaç dakika içinde uygun konuya taşınır; hiçbir konuya oturmayan not Gelen kutusunda kalır. Konu başlıklarını Admin düzenler, agent gerektiğinde yeni konu açabilir.
• Eskimiş notlar. Uzun süre hiçbir koşuda anımsanmayan agent notu "eskimiş" işaretlenir ve koşulara girmez; siz onaylarsanız yeniden aktif olur.

#Sınırlar ve güvenlik

• Not başına en fazla 500 karakter yazılır, çünkü hafıza bir not defteri değil, damıtılmış ders deposu gibi çalışır.
• Workspace başına en fazla 1.000 aktif not tutulur. Bu bir fiyat sınırı değil, koşu bağlamını korumak için teknik bir güvenlik tavanıdır; dolunca yeni not yerine mevcutlar güncellenir.
• Koşu başında notların tamamı hatırlatılır. Hafıza belirli bir boyutu aşarsa sabit ve kural notları tam metniyle öncelikli kalır, kalanlar tek satırlık özet listeye iner ve agent gerektiğinde açar. Hafıza cevap vermezse koşu beklemeden, hafızasız devam eder.
• API anahtarı ya da şifre gibi sırlar hafızaya yazılamaz, sistem bunları reddeder.
• Agent hatırlatılan tercih ve kuralları uygular, ama görevin güncel talimatı her zaman kazanır ve bir hafıza notu agent'a yeni yetki veremez.

Dışarıdan bağlanan istemciler (ör. Claude Code, Codex, Cursor) de aynı hafızaya katılır, yani ekipteki tüm agent'lar aynı ders havuzunu paylaşır. Bağlanan istemci önce whoami çağırır; çıktının sonunda sabit kurallar ve hafızanın konu iskeleti gelir, bir araç bir koleksiyona ya da karta dokunduğunda ona bağlı kurallar sonucun sonunda görünür. Sunucu bunu dayatır: whoami çağrılmadan gelen sonuçlar uyarı taşır. İstemci bir depoda çalışıyorsa Orbi bir kez hafıza protokolü kurulumu önerir: talimat dosyasına bir bölüm ve isteğe bağlı olarak her oturum başında hafızayı çeken bir kanca. Kurulumda deponun hangi space için çalıştığı sorulur; oturum başında o space'in ve Genel'in hafızası gelir, başka bir space'in kartı açıldığında o space'in kuralları kartla birlikte gelir. Dosyalar ancak siz onaylayınca yazılır; "bir daha sorma" derseniz öneri tekrarlanmaz.