Urus memori ruang kerja
Panduan ini menunjukkan cara bekerja dengan stor pengetahuan sesuatu ruang kerja.
Perkara penting yang perlu diketahui sebelum anda bermula: antara muka memori ialah permukaan semakan, bukan permukaan pengarangan. Fakta dan polisi ditulis oleh ejen — melalui propose_fact dan propose_policy, dengan supersede_fact dan supersede_policy untuk menggantikannya. remember menulis item peringkat panas yang terikat sesi yang mungkin kemudiannya dinaikkan taraf oleh consolidate_memory menjadi fakta. Keputusan mesyuarat yang dirakam dituai ke dalam domain decisions; tiada penuaian pada larian ejen yang telah selesai. Apa yang anda lakukan di sini ialah membaca apa yang ditulis oleh mereka, membetulkannya, menyahaktifkannya atau memadamkannya.
Memori terletak di Tetapan → Ruang kerja → Memori (/workspaces/<id>/settings/memory). Ia bukan destinasi bar sisi peringkat atas.
Tiga tab
Bahagian bertajuk “Tiga tab”Halaman ini mempunyai tepat tiga tab. Fakta dan Polisi menunjukkan kiraan langsung; graf tidak:
- Fakta — setiap fakta dalam ruang kerja, dengan kiraan fakta yang belum diganti
- Polisi — peraturan normatif yang dikelompokkan mengikut domain, dengan kiraan peraturan yang aktif
- Graf pengetahuan — kanvas interaktif domain, topik, fakta dan polisi
Domain bukan sesuatu yang anda cipta. Sesuatu domain wujud apabila ejen menulis fakta atau polisi pertama ke dalamnya; tiada kawalan penciptaan domain di mana-mana dalam antara muka.
Semak dan betulkan fakta
Bahagian bertajuk “Semak dan betulkan fakta”- Buka tab Fakta.
- Gunakan kotak carian untuk mengecilkan senarai. Ia ialah penapis subrentetan biasa terhadap domain, topik dan kandungan setiap fakta — tiada indeks kata kunci, tiada kedudukan.
- Gunakan penapis skop untuk menunjukkan semua skop, fakta seluruh ruang kerja sahaja, atau fakta satu repositori.
- Gunakan togol isihan untuk menyusun mengikut kebaharuan atau keyakinan.
- Klik kawalan sunting sesuatu fakta.
Dialog sunting membolehkan anda menukar:
- Domain — memindahkan fakta antara domain
- Topik — label pendeknya
- Kandungan — teks pengetahuan itu
- Keyakinan — penggelongsor dalam langkah 5%
Simpan untuk menulisnya semula. Tiada butang Tambah fakta; dialog itu hanya terbuka pada baris yang sudah ada.
Lihat fakta yang diganti
Bahagian bertajuk “Lihat fakta yang diganti”Tab Fakta mempunyai suis Tunjuk yang diganti. Fakta yang diganti tersembunyi secara lalai dan didedahkan oleh suis itu, di situlah jejak audit berada — penggantian tidak pernah memadam.
Padam fakta
Bahagian bertajuk “Padam fakta”Gunakan kawalan padam sesuatu fakta dan sahkan. Ini pemadaman sebenar, bukan penggantian: gunakannya untuk fakta yang memang salah untuk direkodkan dan biarkan ejen menggantikan fakta yang kandungannya sudah berubah.
Urus polisi
Bahagian bertajuk “Urus polisi”Tab Polisi mengelompokkan polisi aktif mengikut domain dan menurunkan yang tidak aktif ke bahagian di hujung. Bagi setiap polisi anda boleh:
- Sunting polisi itu
- Padam polisi itu
- Nyahaktifkan / Aktifkan polisi itu — pilihan yang boleh dipulihkan dan biasanya yang betul. Hanya polisi aktif sampai ke prompt ejen.
Seperti fakta, tiada kawalan penciptaan.
Teroka graf pengetahuan
Bahagian bertajuk “Teroka graf pengetahuan”Tab Graf pengetahuan membentangkan domain, topik, fakta dan polisi sebagai kanvas nod yang boleh dinavigasi — geser, zum, seret nod. Mengetuk nod membuka helaian butirannya, yang daripadanya dialog sunting yang sama boleh dicapai. Ia ialah cara terpantas untuk melihat domain mana yang benar-benar berisi.
Sunting memori kerja ejen
Bahagian bertajuk “Sunting memori kerja ejen”Memori kerja ialah pad conteng peribadi bagi setiap ejen, yang disuntik ke dalam promptnya pada masa penghantaran. Ejen menulisnya sendiri dengan record_observation dan update_my_notes, tetapi anda boleh membacanya dan menyuntingnya secara terus:
Tetapan → Ruang kerja → Ejen → pilih ejen itu → tab Memori.
Geran akses
Bahagian bertajuk “Geran akses”Geran akses memori memetakan peranan ejen kepada kebenaran (none, read, write) bagi setiap domain. Tulisnya dengan operasi memory_access_grant.*.
Dua perkara yang perlu difahami tentang cara ia diselesaikan:
- Bacaan gagal terbuka. Tanpa baris geran untuk pasangan (peranan, domain), kebenaran berkesannya ialah
read. Satu-satunya penulisan yang melontar tanpawriteialahpropose_policy. Penulisan fakta tidak dikawal geran. - Geran berkunci pada peranan ejen. Alat yang mencadangkan menganggap
agent_roleyang tiada sebagaigeneralsecara lalai. Geran yang ditulis untuk peranan lain tidak mengikat ejen tersebut; gerangeneralpula mengikat.
Carian tidak sama di semua tempat
Bahagian bertajuk “Carian tidak sama di semua tempat”Tiga perkara berbeza dipanggil “carian memori” dan ketiga-tiganya tidak selaras:
| Di mana | Apa yang dilakukannya |
|---|---|
| Kotak carian tab Fakta | Penapis subrentetan terhadap fakta yang sudah dimuatkan dalam klien |
Operasi RPC memory_fact.search |
Carian kata kunci FTS5 sahaja — klien nipis tidak boleh menghantar embedding pertanyaan, jadi carian hibrid kekal dalaman hos |
Alat search_memory di sisi ejen |
keyword, semantic atau hybrid (nilai lalai). Hibrid menggabungkan empat suara: leksikal, semantik, temporal dan graf |
Jadi ejen dan halaman Memori tidak akan menyusun pertanyaan yang sama dengan cara yang sama. Apabila anda menyemak apa yang sebenarnya boleh diingati oleh ejen, tanyalah ejen itu.
Embeddings
Bahagian bertajuk “Embeddings”Fakta di-embed pada masa penulisan dan hanya apabila model embedding pada peranti dipasang. Semak statusnya di bawah Tetapan → Pelayan → Diagnostik & privasi → Carian semantik. Pasang model itu sebelum ejen mula menulis memori jika anda mahukan pengingatan semantik.