Discord — AI di Server Anda

Discord — AI di Server Anda

Jadi, Anda ingin menempatkan Hermes Agent di server Discord Anda? Pilihan yang bagus. Panduan ini akan membawa Anda melewati semua yang perlu Anda ketahui — mulai dari bagaimana Hermes berperilaku setelah diundang, hingga proses pengaturan lengkap, sampai beberapa fitur pemeriksaan kesehatan baru yang penting.

Mari kita mulai dengan bagian yang menyenangkan: bagaimana rasanya mengobrol dengan Hermes di Discord.

Bagaimana Hermes Berperilaku di Server Anda

Hermes bukan sekadar bot polos yang membalas semua pesan. Ia cukup cerdas dalam menentukan kapan dan di mana ia berbicara. Berikut rinciannya:

Konteks	Perilaku
Pesan Langsung (DM)	Hermes membalas setiap pesan. Tidak perlu @mention. Setiap DM mendapatkan sesi privatnya sendiri.
Kanal server	Secara default, Hermes hanya merespons ketika Anda @mention dirinya. Jika tidak, ia tetap diam.
Kanal respons bebas	Ingin kanal di mana orang bisa mengobrol tanpa menandai? Tambahkan ke DISCORD_FREE_RESPONSE_CHANNELS dan Hermes akan menjawab setiap pesan secara langsung.
Thread	Hermes membalas di thread yang sama. Aturan mention tetap berlaku kecuali thread atau kanal induknya adalah kanal respons bebas.
Kanal bersama	Secara default, Hermes menjaga riwayat percakapan setiap pengguna tetap terpisah — bahkan di kanal yang sama. Alice dan Bob yang mengobrol di #research mendapatkan dua sesi independen.
Pesan yang menyebut orang lain	Jika seseorang @mention pengguna lain tetapi bukan Hermes, bot tetap diam secara default. Tidak ikut campur dalam percakapan yang tidak ditujukan padanya.

Tips pro: Ingin kanal bantuan bot khusus di mana orang bisa langsung mengetik dan mendapatkan jawaban? Tambahkan kanal tersebut ke DISCORD_FREE_RESPONSE_CHANNELS dan selesai.

Model Gateway: Lebih dari Sekadar Webhook

Ini hal yang penting: Hermes di Discord bukanlah webhook sederhana yang mengirim balasan otomatis. Setiap pesan melewati alur pemrosesan lengkap:

1. Pemeriksaan otorisasi (DISCORD_ALLOWED_USERS)
2. Pemeriksaan mention / respons bebas
3. Pencarian sesi
4. Pemuatan transkrip sesi
5. Eksekusi agen penuh — alat, memori, perintah slash
6. Pengiriman respons kembali ke Discord

Artinya, setiap balasan didukung oleh kecerdasan penuh Hermes, bukan sekadar respons yang diprogram.

Sesi: Siapa yang Berbagi Apa?

Secara default, Hermes mengisolasi percakapan:

• Setiap DM mendapatkan sesinya sendiri
• Setiap thread mendapatkan namespace sesinya sendiri
• Setiap pengguna di kanal bersama mendapatkan sesinya sendiri

Ini dikontrol di config.yaml:

group_sessions_per_user: true

Jika Anda ingin satu percakapan bersama untuk seluruh ruangan (berguna untuk ruang kolaboratif), atur menjadi false:

group_sessions_per_user: false

Tapi waspadalah: sesi bersama berarti konteks bersama dan biaya token bersama. Tugas panjang yang berat menggunakan alat dari satu orang bisa membengkakkan konteks semua orang. Dan jika seseorang menyela di tengah proses, itu bisa mengganggu seluruh ruangan.

Interupsi dan Konkurensi

Dengan sesi per pengguna (default), Alice dapat menginterupsi permintaannya sendiri tanpa memengaruhi percakapan Bob di kanal yang sama. Bob tetap memiliki riwayatnya, Alice tetap memiliki riwayatnya, dan tidak ada yang saling mengganggu.

Dengan sesi bersama, seluruh ruangan berbagi satu slot “agen yang berjalan”. Pesan lanjutan dari orang yang berbeda bisa saling menginterupsi atau mengantre di belakang satu sama lain. Menyenangkan untuk kolaborasi, tetapi berpotensi kacau.

Baru: Pemeriksaan Kesehatan WebSocket Gateway

Ini adalah peningkatan terbaru yang perlu Anda ketahui. Discord memiliki dua transport terpisah: REST dan Gateway WebSocket. Panggilan REST yang berhasil tidak membuktikan bahwa bot masih bisa menerima event real-time.

Hermes sekarang memantau kesehatan gateway dengan memeriksa:

• Status siap (ready state)
• Status penutupan klien/soket
• Keterbukaan soket
• Usia ACK heartbeat
• Latensi heartbeat

Setelah sejumlah sampel tidak sehat yang dikonfigurasi, adapter mengeluarkan event fatal yang dapat dicoba ulang dan terhubung kembali dengan bersih. Tidak ada loop koneksi ulang tanpa batas.

Konfigurasikan ambang batas di config.yaml:

discord:
  websocket_liveness_interval_seconds: 15
  websocket_liveness_failure_threshold: 2
  websocket_heartbeat_ack_max_age_seconds: 60
  websocket_max_latency_seconds: 30

Catatan: nama lama liveness_interval_seconds dan liveness_failure_threshold masih berfungsi sebagai alias kompatibilitas, tetapi keduanya tidak lagi berarti pemeriksaan REST.

Langkah 1: Buat Aplikasi Discord

1. Buka Discord Developer Portal dan masuk.
2. Klik New Application di pojok kanan atas.
3. Beri nama aplikasi Anda (misalnya, “Hermes Agent”) dan setujui Persyaratan Layanan Developer.
4. Klik Create.

Anda akan diarahkan ke halaman General Information. Catat Application ID Anda — Anda akan membutuhkannya untuk membuat URL undangan.

Langkah 2: Buat Bot

1. Di sidebar kiri, klik Bot.
2. Discord otomatis membuat pengguna bot untuk aplikasi Anda. Sesuaikan nama pengguna jika Anda mau.
3. Di bawah Authorization Flow, atur Public Bot menjadi ON — diperlukan untuk tautan undangan yang disediakan Discord.

Itu adalah fondasinya. Dari sini, Anda akan mengambil token bot, mengatur variabel lingkungan, dan mengundang Hermes ke server Anda. Sebelum Anda menyadarinya, asisten AI Anda sudah ada di Discord — siap mengobrol, menggunakan alat, dan mengingat konteks, semuanya secara real-time.