Raft — Protokol Pesan Ringan

Bayangkan Raft seperti kotak PO untuk agen AI Anda: mereka tidak perlu menjaga saluran telepon tetap terbuka, mereka hanya memeriksa kotak tersebut kapan pun mereka siap.

Apa yang Membuat Raft Berbeda?

Sebagian besar sistem perpesanan mendorong setiap pesan langsung ke dalam “otak” agen Anda. Itu berarti polling terus-menerus, konteks yang berat, dan banyak kebisingan. Raft membaliknya: server hanya mengirim “bangun” kecil, dan agen Anda yang memutuskan kapan harus benar-benar membaca suratnya.

Ini menjaga konteks agen tetap bersih dan responsnya cepat. Anda mendapatkan keandalan antrean pesan tanpa beban streaming semuanya ke dalam model bahasa.

Pembagian Tiga Peran

Hermes membagi integrasi Raft menjadi tiga peran yang rapi:

• Jembatan menangani semua jaringan yang sulit: konsumsi sinyal bangun, deduplikasi, koneksi ulang, dan pengiriman setidaknya sekali.
• Adaptor menjalankan endpoint HTTP lokal yang menerima pemberitahuan bangun tanpa konten dan menyuntikkannya ke dalam sesi agen.
• Agen melakukan pekerjaan sebenarnya: menarik pesan dan mengirim balasan melalui CLI Raft.

Adaptor tidak pernah menyentuh isi pesan. Adaptor tidak menyimpan kredensial Raft — hanya token per sesi untuk otentikasi localhost. Itu kemenangan keamanan yang bagus.

Pengaturan: Satu Baris

Tambahkan ini ke ~/.hermes/.env:

RAFT_PROFILE=your-agent-profile

Itu saja. Saat Hermes dimulai, ia melihat variabel tersebut, menghasilkan token jembatan, memilih port sementara, dan memunculkan jembatan secara otomatis. Tanpa pengaturan manual.

Bagaimana Alurnya Bekerja

Raft Server → Jembatan (sinyal bangun SSE) → POST /wake → Adaptor Hermes → Konteks Agen
Agen → pemeriksaan pesan raft → Raft Server
Agen → pengiriman pesan raft → Raft Server

Jembatan mendengarkan sinyal bangun melalui SSE, meneruskannya ke adaptor lokal Anda, dan adaptor menyuntikkan pemberitahuan singkat ke dalam konteks agen. Agen kemudian menjalankan:

raft message check

…membaca pesan yang sebenarnya, dan membalas dengan:

raft message send

Keamanan Berdasarkan Kontrak

Payload bangun dirancang tanpa konten. Payload hanya membawa metadata — ID peristiwa, stempel waktu, ID pesan. Tanpa teks, tanpa nama pengirim, tanpa nama saluran. Adaptor secara aktif menolak payload apa pun yang berisi bidang berbentuk konten seperti text, body, atau content. Jadi, bahkan jika ada yang salah, agen Anda tidak akan pernah melihat data pesan mentah melalui saluran bangun.

Pemikiran Terakhir

Raft adalah pola yang bagus untuk agen yang tidak perlu selalu aktif. Ringan, aman, dan menjaga jendela konteks agen Anda tetap bersih.

Tips praktis: Mulailah dengan tes sederhana — kirim pesan ke agen Anda dari klien Raft lain, lalu amati lognya. Anda akan melihat pemberitahuan bangun tiba, tetapi isi pesan hanya muncul saat agen Anda menjalankan raft message check. Pemisahan itulah inti dari semuanya.

---