Kelola memori ruang kerja

Panduan ini menunjukkan cara bekerja dengan penyimpanan pengetahuan sebuah ruang kerja.

Hal penting yang perlu diketahui sebelum Anda mulai: UI memori adalah permukaan peninjauan, bukan permukaan penulisan. Fakta dan kebijakan ditulis oleh agen — melalui propose_fact dan propose_policy, dengan supersede_fact dan supersede_policy untuk menggantikannya. remember menulis butir tier panas yang dibatasi sesi yang nantinya mungkin diangkat consolidate_memory menjadi fakta. Keputusan rapat yang tercatat dipanen ke domain decisions; tidak ada pemanenan pada eksekusi agen yang selesai. Yang Anda lakukan di sini adalah membaca apa yang mereka tulis, mengoreksinya, menonaktifkannya, atau menghapusnya.

Memori berada di Pengaturan → Ruang kerja → Memori (/workspaces/<id>/settings/memory). Ini bukan tujuan di bilah samping tingkat atas.

Tiga tab

Halaman ini memiliki tepat tiga tab. Fakta dan Kebijakan menampilkan jumlah langsung; graf tidak:

Fakta — setiap fakta di ruang kerja, beserta jumlah fakta yang belum digantikan
Kebijakan — aturan normatif yang dikelompokkan menurut domain, beserta jumlah kebijakan yang aktif
Graf pengetahuan — kanvas interaktif berisi domain, topik, fakta, dan kebijakan

Domain bukan sesuatu yang Anda buat. Sebuah domain mulai ada ketika agen menulis fakta atau kebijakan pertama ke dalamnya; tidak ada kontrol pembuatan domain di mana pun dalam UI.

Meninjau dan mengoreksi fakta

Buka tab Fakta.
Gunakan kotak pencarian untuk mempersempit daftar. Ini filter substring sederhana atas domain, topik, dan konten setiap fakta — tanpa indeks kata kunci, tanpa peringkat.
Gunakan filter cakupan untuk menampilkan semua cakupan, hanya fakta seluruh ruang kerja, atau fakta satu repositori.
Gunakan tombol pengalih urutan untuk mengurutkan berdasarkan kebaruan atau keyakinan.
Klik kontrol edit sebuah fakta.

Dialog edit memungkinkan Anda mengubah:

Domain — memindahkan fakta antardomain
Topik — label singkatnya
Konten — teks pengetahuannya
Keyakinan — penggeser dengan langkah 5%

Simpan untuk menuliskannya kembali. Tidak ada tombol Tambah fakta; dialog hanya terbuka pada baris yang sudah ada.

Melihat fakta yang digantikan

Tab Fakta memiliki sakelar Tampilkan yang digantikan. Fakta yang digantikan disembunyikan secara bawaan dan ditampilkan oleh sakelar itu, dan di sanalah jejak audit berada — penggantian tidak pernah menghapus.

Menghapus fakta

Gunakan kontrol hapus sebuah fakta lalu konfirmasi. Ini penghapusan sungguhan, bukan penggantian: gunakan untuk fakta yang memang salah dicatat, dan biarkan agen menggantikan fakta yang kontennya sudah berubah.

Mengelola kebijakan

Tab Kebijakan mengelompokkan kebijakan aktif menurut domain dan memindahkan yang tidak aktif ke bagian di akhir. Untuk setiap kebijakan, Anda dapat:

Mengeditnya
Menghapusnya
Menonaktifkan / Mengaktifkan — opsi yang dapat dibalik dan biasanya yang tepat. Hanya kebijakan aktif yang sampai ke prompt agen.

Seperti halnya fakta, tidak ada kontrol pembuatan.

Menjelajahi graf pengetahuan

Tab Graf pengetahuan menampilkan domain, topik, fakta, dan kebijakan sebagai kanvas simpul yang dapat dinavigasi — geser, perbesar, seret simpul. Mengetuk sebuah simpul membuka lembar detailnya, tempat dialog edit yang sama dapat dijangkau. Ini cara tercepat untuk melihat domain mana yang benar-benar terisi.

Mengedit memori kerja agen

Memori kerja adalah buku catatan privat per agen, yang disuntikkan ke prompt-nya pada saat pengiriman. Agen menulisnya sendiri dengan record_observation dan update_my_notes, tetapi Anda dapat membacanya dan mengeditnya secara langsung:

Pengaturan → Ruang kerja → Agen → pilih agen → tab Memori.

Pemberian akses

Pemberian akses memori memetakan peran agen ke izin (none, read, write) per domain. Tuliskan dengan operasi memory_access_grant.*.

Ada dua hal yang perlu dipahami tentang cara resolusinya:

Pembacaan gagal terbuka. Tanpa baris pemberian akses untuk pasangan (role, domain), izin efektifnya adalah read. Satu-satunya penulisan yang melempar galat tanpa write adalah propose_policy. Penulisan fakta tidak digerbangi pemberian akses.
Pemberian akses dikunci pada peran agen. Alat proposal menggunakan nilai bawaan general jika agent_role tidak ada. Pemberian akses yang ditulis untuk peran lain tidak mengikat agen tersebut; pemberian akses general mengikatnya.

Pencarian tidak sama di semua tempat

Ada tiga hal berbeda yang disebut “pencarian memori” dan ketiganya tidak sepakat:

Di mana	Apa yang dilakukannya
Kotak pencarian tab Fakta	Filter substring atas fakta yang sudah dimuat di klien
Operasi RPC `memory_fact.search`	Hanya pencarian kata kunci FTS5 — klien tipis tidak dapat mengirimkan embedding kueri, sehingga pencarian hybrid tetap internal di host
Alat `search_memory` di sisi agen	`keyword`, `semantic`, atau `hybrid` (bawaan). Hybrid menggabungkan empat suara: leksikal, semantik, temporal, dan graf

Jadi agen dan halaman Memori tidak akan mengurutkan kueri yang sama dengan cara yang sama. Saat Anda memeriksa apa yang benar-benar dapat diingat agen, tanyakan kepada agen.

Embedding

Fakta di-embed pada saat penulisan dan hanya ketika model embedding di perangkat sudah terpasang. Periksa statusnya di Pengaturan → Server → Diagnostik & privasi → Pencarian semantik. Pasang model tersebut sebelum agen mulai menulis memori jika Anda menginginkan recall semantik.