LightVela

Satu Agent di Banyak Aplikasi Chat

Ringkasan

Gateway menormalkan pesan platform, mengarahkannya ke Bot sesuai konfigurasi, lalu mengirim hasil ke percakapan asal. Setiap kanal tetap memiliki otorisasi, pengaturan grup, dan batas pengiriman sendiri. Kanal yang terhubung ke Bot yang sama berbagi persona dan memori jangka panjang Bot tersebut. Bot berbeda memiliki Profile terpisah dengan memori dan skill masing-masing. Pesan chat tidak otomatis menjadi memori jangka panjang hanya karena diterima Bot yang sama.


Skenario yang diselesaikannya

Misalkan Bot yang sama terhubung ke Telegram, WhatsApp, dan Discord. Pagi hari, minta melalui Telegram agar tenggat proyek disimpan. Siang hari, tanyakan tanggal tersimpan itu dalam sesi WhatsApp baru. Malam hari, tambahkan perubahan yang sudah dikonfirmasi melalui Discord. Kesinambungan berasal dari fakta tersimpan, bukan penggabungan otomatis semua riwayat chat.

Jika ketiga interaksi itu berperilaku seperti tiga bot yang tak berhubungan, akses multi-platform tidak akan berharga — Anda akan menjelaskan ulang konteksnya setiap kali. Bentuk yang berguna itu berbeda: tiga pintu masuk, satu asisten.

Kesulitan di sini umumnya disalahpahami sebagai "mengintegrasikan beberapa API lagi." Integrasi API hanyalah pekerjaan di permukaan. Masalah sesungguhnya adalah: membuat setiap pintu masuk mengarah ke identitas dan konteks yang sama, tanpa melanggar aturan milik masing-masing platform. Gateway pesan adalah lapisan yang menyelesaikan ketegangan itu.


1. Pertama, sebuah koreksi: kanal bukan Agent

Pembedaan ini adalah prasyarat bagi semua hal lainnya.

KonsepApa ituKardinalitas
KanalPintu masuk untuk pesan, misalnya Telegram, WhatsApp, Discord, Slack, WeChatSatu Agent dapat menghubungkan banyak
Bot / ProfileSubjek kerja yang bertahan, memegang identitas, memori, skill, tugasDibagikan dalam satu Bot; terpisah antar-Bot

Orang secara naluriah memperlakukan "bot Telegram saya" sebagai entitas mandiri, yang secara alami memunculkan pertanyaan "jadi apakah bot WhatsApp saya itu bot yang berbeda?" Begitu kanal dipahami sebagai pintu masuk, bukan subjek, pertanyaan itu larut sendiri.

Jalur lengkapnya tampak seperti ini:

Aplikasi pesan (banyak pintu masuk)
    ↓  pesan asli platform
Gateway pesan (normalkan / rutekan / antarkan)
    ↓  permintaan terpadu
Hermes Agent yang sama
    ↓
inferensi model + eksekusi tool + pemanggilan memori + pemuatan skill
    ↓  hasil eksekusi
Gateway pesan
    ↓  dikirim dalam format platform
Percakapan asal di kanal asal

Perhatikan langkah terakhir itu — percakapan asal di kanal asal. Itu bukan catatan kaki; itu salah satu masalah inti yang harus dituntaskan gateway dengan tepat, dibahas di bawah.


2. Tugas gateway satu: menerima dan menormalkan

Platform berbeda di nyaris setiap dimensi:

  • Pengenal pengguna berbeda — ID numerik, nomor telepon, atau username internal platform.
  • Pengenal percakapan berbeda — pesan langsung, grup, channel, dan thread masing-masing direpresentasikan berbeda.
  • Struktur pesan berbeda — teks, gambar, suara, file, balasan berkutipan, dan reaksi semuanya punya desain kolomnya sendiri.
  • Model event berbeda — sebagian mendorong lewat webhook, sebagian butuh koneksi persisten atau polling.

Jika Agent menghadapi perbedaan ini secara langsung, percabangan khusus platform akan menyebar ke intinya, dan setiap platform baru berarti menyentuh logika inti. Normalisasi mengurung perbedaan itu di gateway: pesan asli platform menjadi satu permintaan yang seragam, sehingga Agent hanya perlu memahami satu bentuk input.

Manfaat praktisnya: menambahkan kanal seharusnya tidak menuntut perubahan pada logika identitas, memori, atau skill. Agent peduli pada apa yang ditanyakan, bukan tata letak kolom aplikasi mana yang membawanya.


3. Tugas gateway dua: merutekan ke Agent yang sama

Inilah langkah yang membuat "satu kepribadian lintas platform" menjadi mungkin.

Begitu sebuah permintaan dinormalkan, gateway memakai konfigurasi koneksi Anda untuk menentukan permintaan itu milik Agent yang mana, lalu menyerahkan permintaan tersebut kepada Agent itu. Ia tidak memunculkan kepribadian atau penyimpanan memori baru hanya karena pesannya datang dari platform yang baru dihubungkan.

Ini penting karena ia menentukan apakah aset jangka panjang dibagikan atau terfragmentasi:

AsetTempatnyaPerilaku lintas kanal
Identitas dan aturan perilakuSOUL.mdDibagikan dalam satu Bot; terpisah antar-Bot
Profil penggunaUSER.mdDibagikan dalam satu Bot; terpisah antar-Bot
Fakta lintas sesiMEMORY.md / memories/Dibagikan dalam satu Bot; terpisah antar-Bot
Metode yang tertangkapskills/Dibagikan dalam satu Bot; terpisah antar-Bot
Tugas TerjadwalKonfigurasi lapisan AgentMilik Bot saat ini; kanal pengiriman dan percakapan tujuan dapat dipilih

Berbagi dalam tabel berlaku di dalam satu Bot. Aset tersimpan dapat digunakan melalui kanalnya, tetapi konteks chat tidak otomatis digabungkan. Bot lain mengelola kontennya sendiri.

Ini logika pemisahan yang sama dengan "mengganti model tidak menghilangkan memori": pisahkan lapisan akses yang mudah berubah dari lapisan aset yang stabil. Untuk versi argumen ini di sisi model, lihat "Bisakah Otak Hermes Agent Diganti? Lapisan Model vs Lapisan Agent."


4. Tugas gateway tiga: mengantar kembali ke tempat yang benar

Begitu Agent selesai, gateway mengirimkan hasilnya kembali. "Mengirimkannya kembali" lebih sulit dari kedengarannya, karena ia harus menjawab tiga pertanyaan dengan benar sekaligus:

  1. Platform mana — pesan dari Telegram harus kembali ke Telegram, bukan WhatsApp.
  2. Percakapan mana — di satu platform Anda mungkin punya pesan langsung plus beberapa grup dan channel. Membalas ke percakapan yang salah bukan sekadar memalukan; dalam konteks grup, itu dapat membocorkan informasi.
  3. Format mana — platform berbeda dalam batas panjang pesan, dukungan Markdown, cara gambar dan file dikirim, serta ada tidaknya balasan berkutipan. Konten yang sama memerlukan penyajian berbeda per platform.

Poin kedua patut ditegaskan. Target pengiriman yang salah adalah kelas masalah paling berat dalam penyiapan multi-kanal: konten privat diposting ke grup, atau kesimpulan satu tim dikirim ke channel tim lain. Justru itulah sebabnya setiap kanal yang baru dihubungkan sebaiknya diverifikasi dulu dengan pesan uji di percakapan yang aman.


5. Terpadu tidak berarti tanpa batas

"Satu Agent, banyak pintu masuk" mudah dibaca berlebihan sebagai "semua platform berperilaku identik." Kenyataannya setiap kanal mempertahankan batasannya sendiri, dan berbagi satu Agent tidak menghapusnya.

5.1 Otorisasinya berbeda

Setiap platform punya alur koneksi dan bentuk kredensial sendiri: sebagian menuntut pembuatan bot di developer portal lalu menyalin token, sebagian menuntut pemindaian kode QR, sebagian menuntut AppID dan AppSecret. Dengan kata lain, menghubungkan setiap kanal adalah langkah otorisasi yang independen — satu penyiapan tidak mencakup semuanya.

5.2 Kanal yang didukung berbeda per region

Ini jebakan yang mudah ditemui saat membaca dokumentasi: region global dan Tiongkok pada LightVela tidak mendukung kumpulan kanal yang sama. Urutan kanal global adalah Telegram, WhatsApp, Discord, Slack, WeChat, QQ, WeCom, Lark. Region Tiongkok mendukung WeChat, QQ, WeCom, Lark, dan DingTalk.

Jadi ketika Anda melihat klaim seperti "Telegram didukung", pastikan itu berlaku untuk region yang mana alih-alih mengasumsikannya berlaku lintas region.

5.3 Konteks grup berbeda dari pesan langsung

Dalam pesan langsung Agent menghadapi satu orang; di grup ia menghadapi banyak. Grup menambah pertanyaan: kapan ia harus merespons, kapan harus diam, konten apa yang tidak pantas diuraikan secara publik, dan siapa yang boleh memicu tindakan sensitif. Ini termasuk aturan perilaku dan desain izin — gateway tidak dapat memutuskannya secara otomatis.

5.4 Kemampuan pengirimannya berbeda

Batas panjang pesan, dukungan rich text, pengiriman file, dan kemampuan mengutip pesan tertentu semuanya membentuk keluarannya. Balasan panjang yang tampil bersih di Discord mungkin perlu dipecah atau disederhanakan di tempat lain.


6. Urutan praktis untuk menghubungkan kanal baru

Mengubah prinsip di atas menjadi langkah, urutan ini menghindari sebagian besar masalah.

  1. Pastikan dukungan regional — verifikasi kanal tersebut tersedia di region Anda, sehingga Anda tidak mengikuti dokumentasi yang ditulis untuk region lain.
  2. Selesaikan otorisasi di sisi platform — ikuti panduan kanal tersebut untuk membuat bot atau memberi akses lalu memperoleh kredensialnya. Kredensial bersifat sensitif: jangan pernah menuliskannya ke file konteks jangka panjang atau menempelkannya ke chat.
  3. Hubungkan di sisi produk — masukkan kredensialnya, simpan, lalu pastikan statusnya tampil sebagai terhubung.
  4. Kirim pesan uji — pakai percakapan yang aman (pesan langsung atau grup uji) lalu pastikan Agent membalas.
  5. Verifikasi target pengiriman — periksa secara khusus bahwa balasannya mendarat di percakapan yang sama dengan tempat Anda mengirim pesan, bukan percakapan lain.
  6. Periksa Bot dan memori tersimpan — pastikan kedua koneksi milik Bot yang sama, lalu tanyakan fakta tersimpan dalam sesi baru.
  7. Baru setelah itu tambahkan akses grup — setelah pesan langsung lolos, bergabunglah ke grup lalu pastikan batas respons di dalam grup berperilaku seperti yang diharapkan.

Langkah 6 memerlukan pemeriksaan konfigurasi koneksi dan isi tersimpan. Jawaban benar di chat lama mungkin berasal dari konteks chat itu; sesi yang berjalan juga belum tentu langsung memuat perubahan memori.


7. Gejala umum dan cara membacanya

GejalaPenyebab yang lebih mungkinTindakan yang disarankan
Tidak ada balasan sama sekali di kanal baruOtorisasi belum lengkap atau kredensial salahPeriksa status koneksi dan kredensial, ulangi otorisasi
Balasan muncul di percakapan berbedaResolusi target pengiriman atau error konfigurasiBerhenti memakainya di grup; pindah ke pesan langsung untuk mengisolasi
Membalas, tetapi "tidak mengenal saya"Kemungkinan terhubung ke Agent yang berbedaVerifikasi dengan fakta yang sudah diketahui lalu periksa koneksi itu mengarah ke Agent mana
Grup diam, pesan langsung normalAturan pemicu atau izin di dalam grupTinjau aturan respons grup dan izin yang dibutuhkan
Balasan panjang terpotong atau formatnya rusakBatas pengiriman platformSesuaikan panjang dan format keluaran untuk platform tersebut

Baris ketiga patut diperhatikan: "tidak mengenal saya" di sini bermakna berbeda dibandingkan setelah penggantian model. Setelah mengganti model, itu biasanya perbedaan gaya; pada kanal yang baru dihubungkan, itu lebih mungkin berarti kanal ini tidak mengarah ke Agent yang Anda asumsikan. Diagnostiknya sama — tanyakan satu fakta yang Anda yakin seharusnya ia ketahui.


8. Pendekatan LightVela: kanal sebagai pintu masuk yang dapat dipasang-lepas

Hermes memisahkan kanal dari Agent pada tingkat mekanisme, tetapi menghubungkan setiap platform tetap berarti menangani kredensial, callback, dan runtime sendiri. Arah LightVela adalah menjadikan lapisan itu sebagai pintu masuk yang terproduktisasi dan dapat dipasang-lepas:

  • Kanal adalah pengaturan — hubungkan atau lepaskan di bawah satu Agent, tanpa perlu membuat Agent terpisah per platform.
  • Konsisten dalam satu Bot — kanal yang terhubung memakai persona dan memori Bot tersebut. Setelah beralih Bot, periksa isi yang disimpan oleh Bot yang dipilih.
  • Status koneksi terlihat — konsol menampilkan apakah sebuah kanal terhubung, memudahkan Anda membedakan "belum pernah berhasil terhubung" dari "terhubung tetapi tidak membalas."
  • Perbedaan regional bersifat eksplisit — region global dan Tiongkok masing-masing mencantumkan kanal yang didukungnya, mencegah kekeliruan lintas region.
  • Masalah dapat dilacak — log terbaru di Diagnostik membantu memisahkan masalah otorisasi dari masalah pengiriman dan masalah tugas.

Poin penting

  • Gateway menormalkan pesan platform, mengarahkannya ke Bot sesuai konfigurasi, lalu mengirim hasil ke percakapan asal. Setiap kanal tetap memiliki otorisasi, pengaturan grup, dan batas pengiriman sendiri.
  • Gateway melakukan tiga hal: menormalkan perbedaan platform, merutekan ke Agent yang sama, dan mengantarkan kembali ke percakapan asal.
  • Identitas, memori, skill, dan tugas terjadwal hidup di luar lapisan kanal, sehingga kesinambungan lintas kanal adalah konsekuensi arsitektural, bukan fitur sinkronisasi tambahan.
  • Terpadu tidak berarti tanpa batas: otorisasi, dukungan regional, konteks grup, dan batas pengiriman berbeda per kanal.
  • Setelah terhubung, periksa Bot tujuan, lokasi balasan, dan fakta tersimpan dalam sesi baru.

Terakhir diperbarui 2026-11-15