Çalışma alanı belleğini yönetme

Bu kılavuz, bir çalışma alanının bilgi deposuyla nasıl çalışacağınızı gösterir.

Başlamadan önce bilmeniz gereken önemli şey şu: bellek arayüzü bir inceleme yüzeyidir, yazma yüzeyi değil. Olgular ve politikaları ajanlar yazar — propose_fact ve propose_policy ile; onların yerine geçmek için de supersede_fact ve supersede_policy vardır. remember, oturumla sınırlı bir sıcak katman öğesi yazar ve consolidate_memory bunu daha sonra bir olguya terfi ettirebilir. Kaydedilen toplantı kararları decisions bilgi alanına toplanır; tamamlanmış ajan çalıştırmaları üzerinde böyle bir toplama yoktur. Burada yaptığınız şey, onların yazdıklarını okumak, düzeltmek, devre dışı bırakmak veya silmektir.

Bellek Ayarlar → Çalışma alanı → Bellek (/workspaces/<id>/settings/memory) yolunda yaşar. Üst düzey bir kenar çubuğu hedefi değildir.

Üç sekme

Sayfada tam olarak üç sekme vardır. Olgular ve Politikalar canlı bir sayı gösterir; grafik göstermez:

Olgular — çalışma alanındaki her olgu; yerine geçilmemiş olanların sayısıyla birlikte
Politikalar — bilgi alanına göre gruplanmış normatif kurallar; etkin olanların sayısıyla birlikte
Bilgi grafiği — bilgi alanları, konular, olgular ve politikaların etkileşimli tuvali

Bilgi alanları sizin oluşturduğunuz bir şey değildir. Bir bilgi alanı, bir ajan ona ilk olguyu ya da politikayı yazdığında var olur; arayüzün hiçbir yerinde bilgi alanı oluşturma denetimi yoktur.

Bir olguyu gözden geçirme ve düzeltme

Olgular sekmesini açın.
Listeyi daraltmak için arama kutusunu kullanın. Bu, her olgunun bilgi alanı, konusu ve içeriği üzerinde düz bir alt dize filtresidir — anahtar sözcük dizini yok, sıralama yok.
Tüm kapsamları, yalnızca çalışma alanı geneli olguları ya da tek bir deponun olgularını göstermek için kapsam filtresini kullanın.
Yeniliğe veya güvene göre sıralamak için sıralama anahtarını kullanın.
Bir olgunun düzenleme denetimine tıklayın.

Düzenleme iletişim kutusu şunları değiştirmenizi sağlar:

Alan — bir olguyu bilgi alanları arasında taşıma
Konu — kısa etiketi
İçerik — bilgi metni
Güven — %5 adımlı bir kaydırıcı

Geri yazmak için kaydedin. Olgu ekle düğmesi yoktur; iletişim kutusu yalnızca var olan bir satırda açılır.

Yerine geçilmiş olguları görme

Olgular sekmesinde bir Geçersiz kılınanları göster anahtarı vardır. Yerine geçilmiş olgular varsayılan olarak gizlidir ve bu anahtarla görünür olur; denetim izi tam da buradadır — yerine geçme hiçbir zaman silmez.

Bir olguyu silme

Bir olgunun silme denetimini kullanın ve onaylayın. Bu gerçek bir silmedir, yerine geçme değil: kaydedilmesi baştan yanlış olan olgular için bunu kullanın; içeriği değişmiş olguların yerine geçmesini ise ajanlara bırakın.

Politikaları yönetme

Politikalar sekmesi etkin politikaları bilgi alanına göre gruplar ve etkin olmayanları sona eklenen bir bölüme indirir. Politika başına şunları yapabilirsiniz:

Düzenle
Sil
Devre dışı bırak / Etkinleştir — geri alınabilir seçenek ve genellikle doğru olanı. Ajan istemlerine yalnızca etkin politikalar ulaşır.

Olgularda olduğu gibi oluşturma denetimi yoktur.

Bilgi grafiğini keşfetme

Bilgi grafiği sekmesi bilgi alanlarını, konuları, olguları ve politikaları gezilebilir bir düğüm tuvali olarak yerleştirir — kaydırın, yakınlaştırın, düğümleri sürükleyin. Bir düğüme dokunmak ayrıntı panelini açar; aynı düzenleme iletişim kutularına oradan ulaşılır. Hangi bilgi alanlarının gerçekten dolduğunu görmenin en hızlı yoludur.

Bir ajanın çalışma belleğini düzenleme

Çalışma belleği, her ajan için özel bir karalama defteridir ve gönderim sırasında istemine enjekte edilir. Ajanlar onu record_observation ve update_my_notes ile kendileri yazar; ancak siz doğrudan okuyup düzenleyebilirsiniz:

Ayarlar → Çalışma alanı → Ajanlar → ajanı seçin → Bellek sekmesi.

Erişim yetkileri

Bellek erişim yetkileri, bir ajanın rolünü her bilgi alanı için bir izne (none, read, write) eşler. Bunları memory_access_grant.* işlemleriyle yazın.

Nasıl çözümlendiklerine dair anlaşılması gereken iki şey var:

Okumalar hata durumunda izin verir. Bir (rol, bilgi alanı) çifti için yetki satırı yoksa geçerli izin read olur. write olmadan hata fırlatan tek yazma propose_policy işlemidir. Olgu yazmaları yetkiye bağlı değildir.
Yetkiler ajanın rolüne göre anahtarlanır. Öneri araçları, eksik bir agent_role değerini general olarak varsayar. Başka bir rol için yazılmış bir yetki o ajanları bağlamaz; general yetkisi bağlar.

Arama her yerde aynı değildir

“Bellek araması” denen üç farklı şey var ve bunlar uyuşmaz:

Nerede	Ne yapar
Olgular sekmesinin arama kutusu	İstemcide zaten yüklü olan olgular üzerinde alt dize filtresi
`memory_fact.search` RPC işlemi	Yalnızca FTS5 anahtar sözcük araması — ince bir istemci sorgu gömmesi gönderemez, bu yüzden karma arama ana makinede kalır
Ajan tarafındaki `search_memory` aracı	`keyword`, `semantic` veya `hybrid` (varsayılan). Karma, dört sesi kaynaştırır: sözlüksel, anlamsal, zamansal ve grafik

Dolayısıyla bir ajan ile Bellek sayfası aynı sorguyu aynı şekilde sıralamaz. Bir ajanın gerçekte neleri hatırlayabildiğini kontrol ederken ajana sorun.

Gömmeler

Olgular yazma anında gömülür ve yalnızca cihaz üzerindeki gömme modeli kuruluysa. Durumunu Ayarlar → Sunucu → Tanılama ve gizlilik → Anlamsal arama altından denetleyin. Anlamsal geri çağırma istiyorsanız modeli, ajanlar bellek yazmaya başlamadan önce kurun.