Matrix — Jaringan Chat Terdesentralisasi

Matrix — Jaringan Chat Terdesentralisasi

Kalau kamu pernah ingin punya jaringan chat yang tidak mengunci kamu di server milik orang lain, Matrix adalah jawabannya. Ini adalah protokol pesan terbuka dan terfederasi — bayangkan email, tapi untuk instant messaging. Kamu bisa menjalankan homeserver sendiri, atau pakai server publik seperti matrix.org. Apa pun pilihanmu, kamu tetap memegang kendali atas percakapanmu.

Hermes Agent terhubung langsung ke Matrix menggunakan Python SDK mautrix. Artinya, bot kamu bisa ngobrol denganmu lewat Matrix, dengan semua kemampuan Hermes yang sudah kamu kenal dan sukai — penggunaan tools, memori, penalaran, dan respons real-time. Bot ini menangani teks, file, gambar, audio, video, bahkan enkripsi end-to-end (E2EE) opsional.

Dan ini bagian terbaiknya: Hermes bekerja dengan homeserver Matrix mana pun. Synapse, Conduit, Dendrite, atau server publik besar di matrix.org — pilih sesuai seleramu.

Bagaimana Perilaku Hermes

Setelah terhubung, Hermes punya pengaturan default yang cerdas. Berikut ringkasannya:

Konteks	Perilaku
DM	Hermes membalas setiap pesan. Tidak perlu menyebut @mention. Setiap DM mendapat sesi sendiri.
Room	Secara default, Hermes menunggu @mention sebelum merespons. Kamu bisa ubah ini dengan MATRIX_REQUIRE_MENTION=false atau tambahkan room tertentu ke MATRIX_FREE_RESPONSE_ROOMS. Undangan room diterima otomatis.
Thread	Hermes mendukung penuh thread Matrix. Balas di dalam thread, dan Hermes menjaga konteks itu terpisah dari timeline utama room. Thread yang sudah diikuti bot tidak perlu mention.
Auto-threading	Secara default, Hermes otomatis membuat thread untuk setiap respons di dalam room. Ini menjaga percakapan tetap rapi dan terisolasi. Matikan dengan MATRIX_AUTO_THREAD=false.
Perintah	Perintah /commands biasa berfungsi seperti yang diharapkan. Jika klienmu memesan / untuk perintah lokal, cukup gunakan !commands — Hermes menormalkan alias tersebut secara otomatis.
Kontrol interaktif	Persetujuan untuk perintah berbahaya dan pemilihan /model bisa menggunakan reaksi Matrix. Kamu bahkan bisa membatasi reaksi persetujuan hanya untuk pengguna yang meminta aksi tersebut.
Aktivitas berpikir dan tools	Hermes menggunakan panel ber-thread yang bisa diedit untuk aktivitas berpikir dan tools saat gateway progress diaktifkan. Tidak ada lagi banjir update di timeline utama.
Room bersama	Secara default, Hermes mengisolasi riwayat sesi per pengguna di dalam room. Dua orang di room yang sama tidak berbagi satu transkrip kecuali kamu menonaktifkannya secara eksplisit.

Tips pro: Cukup undang user Matrix bot ke room mana pun, dan bot akan bergabung serta mulai merespons secara otomatis.

Apa yang Bisa Dilakukan Hermes di Matrix

Berikut daftar kemampuan lengkapnya, langsung dari deklarasi adapter:

• Teks — ya
• Thread — ya
• Reaksi — ya
• Persetujuan — ya
• Pemilih model — ya
• Panel berpikir — ya
• Gambar — ya (termasuk banyak gambar sekaligus)
• File — ya
• Suara/audio — ya
• Video — ya
• E2EE — nonaktif / opsional / wajib (berbasis mode)
• Diagnostik — ya

Model Sesi di Matrix

Secara default, Hermes menjaga semuanya tetap terpisah dengan rapi:

• Setiap DM mendapat sesi sendiri
• Setiap thread mendapat namespace sesi sendiri
• Setiap pengguna di room bersama mendapat sesi sendiri di dalam room tersebut

Ini dikontrol oleh config.yaml:

group_sessions_per_user: true

Set ke false hanya jika kamu benar-benar ingin satu percakapan bersama untuk seluruh room:

group_sessions_per_user: false

Sesi bersama bisa berguna untuk room kolaboratif, tapi hati-hati: pengguna berbagi pertumbuhan konteks dan biaya token, satu tugas berat dengan tools dari satu orang bisa membengkakkan konteks orang lain, dan satu proses yang sedang berjalan bisa mengganggu lanjutan proses orang lain.

Konfigurasi Mention dan Thread

Kamu bisa mengubah semuanya melalui environment variables atau config.yaml. Berikut versi YAML-nya:

matrix:
  require_mention: true           # Wajib @mention di room (default: true)
  allowed_users:                  # User Matrix yang diizinkan memicu giliran agen
    - "@alice:matrix.org"
  allowed_rooms:                  # Room Matrix yang diizinkan memicu giliran agen
    - "!abc123:matrix.org"
  free_response_rooms:            # Room yang bebas dari kewajiban mention
    - "!abc123:matrix.org"
  ignore_user_patterns:           # User ghost bridge/appservice yang diabaikan
    - "^@telegram_"
    - "^@whatsapp_"
  process_notices: false          # Abaikan m.notice secara default
  session_scope: room             # auto|room|thread; room direkomendasikan untuk room proyek
  auto_thread: true               # Buat thread otomatis untuk respons (default: true)
  dm_mention_threads: false       # Buat thread saat di-@mention di DM (default: false)
  max_message_length: 16000       # Ukuran chunk keluar dalam karakter (default: 16000, maks: 65535)

Atau melalui environment variables:

MATRIX_REQUIRE_MENTION=true
MATRIX_ALLOWED_USERS=@alice:matrix.org
MATRIX_ALLOWED_ROOMS=!abc123:matrix.org
MATRIX_FREE_RESPONSE_ROOMS=!abc123:matrix.org,!def456:matrix.org
MATRIX_IGNORE_USER_PATTERNS='^@telegram_,^@whatsapp_'
MATRIX_PROCESS_NOTICES=false
MATRIX_SESSION_SCOPE=room       # direkomendasikan untuk konteks room proyek yang stabil
MATRIX_AUTO_THREAD=true
MATRIX_DM_MENTION_THREADS=false
MATRIX_REACTIONS=true          # default: true — reaksi emoji selama pemrosesan
MATRIX_ALLOW_ROOM_MENTIONS=false

Tips: MATRIX_REACTIONS=false mematikan reaksi emoji siklus pemrosesan (👀/✅/❌) yang diposting bot pada pesan masuk. Berguna untuk room yang event reaksinya berisik atau tidak didukung.

Tips lain: Hermes mengirim mention user Matrix terstruktur untuk ID eksplisit seperti @alice:example.org. Mention @room untuk seluruh room dikontrol secara terpisah.

Itulah gambaran lengkap Matrix. Baik kamu menjalankan homeserver sendiri atau hanya ingin chat terdesentralisasi yang menghormati privasimu, Hermes siap membantumu. Ayo undang bot kamu ke room dan lihat aksinya!