Tutorial 20: Memori Persisten — Memori Jangka Panjang

Ini adalah bagian dari seri tutorial resmi Hermes Agent. Lihat semua tutorial

Bayangkan fitur ini seperti catatan tempel di meja kerjamu: Hermes Agent menuliskan hal-hal penting tentang dirimu dan proyekmu supaya tidak lupa di antara sesi percakapan. Tidak perlu lagi mengulang-ulang hal yang sama setiap kali memulai chat baru.

Apa yang Dilakukan Persistent Memory?

Biasanya, agen AI memulai dari nol setiap sesi — ia melupakan segalanya begitu percakapan berakhir. Persistent Memory mengubah hal itu. Hermes Agent menyimpan dua file teks kecil di komputermu. File-file ini dibaca di awal setiap sesi, sehingga agen langsung mengingat preferensimu, detail proyekmu, dan hal lain yang pernah kamu ajarkan padanya.

Langkah 1: Kenali Dua File Memori

Memori agen tersimpan dalam dua file, berlokasi di ~/.hermes/memories/:

File	Isi yang Disimpan	Batas Ukuran
MEMORY.md	Catatan pribadi agen — fakta lingkungan, konvensi, hal-hal yang dipelajarinya	2.200 karakter (~800 token)
USER.md	Profilmu — preferensi, gaya komunikasi, ekspektasi	1.375 karakter (~500 token)

Batas ini memang disengaja. Mereka memaksa agen untuk hanya menyimpan hal-hal penting saja, seperti buku catatan yang rapi, bukan laci yang berantakan.

Langkah 2: Lihat Bagaimana Memori Muncul di Prompt

Di awal setiap sesi, agen memuat kedua file tersebut dan menampilkannya sebagai snapshot beku di system prompt-nya. Berikut contoh apa yang agen “lihat”:

══════════════════════════════════════════════
MEMORY (catatan pribadimu) [67% — 1.474/2.200 karakter]
══════════════════════════════════════════════
Proyek pengguna adalah layanan web Rust di ~/code/myapi menggunakan Axum + SQLx
§
Mesin ini menjalankan Ubuntu 22.04, sudah terpasang Docker dan Podman
§
Pengguna lebih suka respons ringkas, tidak suka penjelasan bertele-tele

Perhatikan detail-detailnya:

Header yang menunjukkan jenis penyimpanan (MEMORY atau USER PROFILE)
Persentase penggunaan dan jumlah karakter — supaya agen tahu berapa ruang yang tersisa
Entri dipisahkan oleh § (tanda section)
Entri bisa terdiri dari beberapa baris

Penting: Snapshot ini diambil sekali di awal sesi dan tidak pernah berubah di tengah sesi. Jika agen memperbarui memorinya saat mengobrol, perubahannya langsung disimpan ke disk tetapi tidak akan muncul di prompt sampai sesi berikutnya. Ini menjaga performa tetap cepat dengan mempertahankan cache model.

Langkah 3: Agen Mengelola Memorinya Sendiri

Agen menggunakan tool bernama memory dengan tiga aksi:

add — Menambahkan entri memori baru
replace — Mengganti entri yang sudah ada (menggunakan pencocokan substring dengan old_text)
remove — Menghapus entri yang sudah tidak relevan (juga menggunakan old_text)

Tidak ada aksi read karena memori sudah disuntikkan ke dalam prompt — agen selalu bisa melihatnya.

Berikut contoh sederhana bagaimana agen menggunakan tool tersebut:

memory action=add content="Pengguna lebih suka poin-poin daripada paragraf"

Atau mengganti preferensi lama:

memory action=replace old_text="Pengguna lebih suka respons ringkas" new_text="Pengguna lebih suka jawaban satu baris dengan emoji"

Langkah 4: Apa yang Terjadi Saat Memori Penuh?

Memori tidak otomatis dipadatkan. Ketika penulisan akan melebihi batas, tool memory mengembalikan error alih-alih diam-diam membuang entri. Agen kemudian membuat ruang sendiri — menggabungkan atau menghapus entri di giliran yang sama sebelum mencoba lagi.

Perlu dicatat juga: replace juga terikat oleh batas tersebut. Mengganti entri dengan yang lebih panjang tetap bisa melampaui batas, jadi konten baru harus dipersingkat (atau entri lain dihapus) agar muat.

Langkah 5: Satu Agen per Hermes Home (Penting!)

Jangan arahkan dua proses agen ke direktori home Hermes yang sama. Penulisan memori terjadi otomatis dan dimuat kembali ke system prompt di awal sesi, jadi dua penulis yang berbagi satu home akan menumpuk entri satu sama lain menjadi kekacauan yang tidak diciptakan oleh keduanya. Memori memang dirancang terpisah per profil — berikan profil sendiri untuk agen kedua. Jika mereka membutuhkan memori bersama, gunakan penyedia memori eksternal sebagai gantinya.

Ringkasan

Persistent Memory memberi Hermes Agent cara sederhana dan terbatas untuk mengingatmu lintas sesi. Dua file kecil — MEMORY.md dan USER.md — menyimpan catatan terkurasi, disuntikkan sebagai snapshot beku di awal sesi. Agen mengelola file-file ini sendiri menggunakan tool memory, dan batas karakter menjaga semuanya tetap fokus. Ingat saja: satu agen per direktori home, dan snapshot hanya diperbarui di awal sesi.

Selanjutnya: Tutorial 21 — Tugas Terjadwal: menyiapkan otomatisasi yang berjalan sendiri sesuai pengatur waktu.