LightVela

Kendur

Ringkasan

Saluran Slack bersambung dengan token bot dan token apl, yang sesuai membawa Hermes Agent anda ke dalam saluran pasukan, mesej langsung dan pemberitahuan tugas berjadual: buat apl dalam konsol pengurusan apl Slack, konfigurasikan kebenarannya, dapatkan kedua-dua token dan tampalkannya ke bahagian LightVela konsol. Anda memerlukan Slack ruang kerja tempat anda boleh memasang apl dan model yang dikonfigurasikan (atau hanya kredit model bulanan yang disertakan dengan pelan anda). Kedua-dua token adalah bukti kelayakan yang sensitif — jangan sekali-kali berkongsinya secara terbuka. Setelah disambungkan, ejen dalam Slack berkongsi persona dan ingatan jangka panjang yang sama seperti saluran anda yang lain.


Slack menggunakan Token Bot dan Token Apl untuk menyambungkan Hermes Agent kepada saluran pasukan, mesej langsung dan pemberitahuan tugas yang dijadualkan.

Halaman ini meliputi

  • Mencipta apl Slack dan mengkonfigurasi Mod Soket, kebenaran dan acara

  • Mengikat Slack Token Bot dan Token Apl dalam LightVela

  • Berbual dengan Hermes Agent melalui saluran Slack dan mesej langsung


Langkah

1. Buka tetapan saluran Slack dalam LightVela

Log masuk ke LightVela tapak antarabangsa, buka My Hermes → Channel, cari kad Slack dan klik + Connect. Anda akan kembali dengan dua bukti kelayakan:

  • Slack Token Bot: bermula dengan xoxb-.
  • Slack Token Apl: bermula dengan xapp-.

2. Cipta apl Slack

  1. Buka Slack API Apl dan log masuk.
  2. Klik Buat Apl Baharu.

Cipta aplikasi baharu daripada Slack API Apps

  1. Pilih Dari awal.

Pilih Dari awal untuk membuat aplikasi Slack

  1. Masukkan nama apl seperti Hermes Agent.
  2. Pilih ruang kerja di mana Hermes Agent harus dijalankan, kemudian klik Buat Apl.

Namakan aplikasi Slack dan pilih ruang kerja

Jika ruang kerja tiada, sahkan bahawa akaun Slack semasa adalah miliknya dan boleh membuat apl.

3. Cipta Token Apl

Token Apl mewujudkan sambungan WebSocket Mod Soket. Ia mesti termasuk skop connections:write.

  1. Dalam bar sisi aplikasi Slack, buka Tetapan → Maklumat Asas.

Buka Maklumat Asas dalam aplikasi Slack

  1. Tatal ke Token Tahap Apl dan klik Jana Token dan Skop.

Hasilkan token peringkat aplikasi

  1. Masukkan nama token yang boleh dikenali, seperti HermesSocket.
  2. Klik Tambah Skop.

Tambah skop kepada Token Aplikasi

  1. Cari dan pilih connections:write.

Pilih skop tulis sambungan

  1. Sahkan skop disenaraikan, kemudian klik Jana.

Jana Token Aplikasi dengan sambungan tulis

  1. Salin token xapp-... yang dihasilkan dan simpan dengan selamat. Klik Selesai selepas menyalinnya.

Salin Token Aplikasi Slack

Jangan tampal Token Apl ke dalam medan Token Bot. Rahsia Pelanggan atau Rahsia Menandatangani bukanlah pengganti untuk token ini.

4. Konfigurasikan Mod Soket, kebenaran dan acara

4.1 Dayakan Mod Soket

  1. Buka Tetapan → Mod Soket.
  2. Hidupkan Dayakan Mod Soket.

Aktifkan Mod Soket Slack

Mod Soket menghantar Slack acara kepada Hermes Agent melalui WebSocket. Persediaan ini tidak memerlukan URL Permintaan Langganan Acara atau URL Ubah Hala OAuth.

4.2 Tambah Skop Token Bot

  1. Buka Ciri → OAuth & Kebenaran.
  2. Tatal ke Skop → Skop Token Bot.
  3. Klik Tambah Skop OAuth.

Tambah skop bot dalam OAuth dan Kebenaran

Tambahkan skop untuk mod interaksi yang anda perlukan:

SkopDiperlukan untukTujuan
app_mentions:readPenggunaan saluranTerima mesej yang menyebut bot
channels:readSaluran awamBaca maklumat asas saluran awam
channels:historySaluran awamBaca mesej dalam saluran awam yang bot telah sertai
chat:writeSemua balasanHantar mesej sebagai bot
im:readMesej langsungBaca maklumat perbualan mesej langsung
im:historyMesej langsungBaca mesej langsung yang dihantar ke bot
im:writeMesej langsungBuka atau urus perbualan mesej langsung
groups:readSaluran peribadi pilihanBaca maklumat saluran peribadi
groups:historySaluran peribadi pilihanBaca mesej dalam saluran peribadi yang bot telah sertai

Semak Skop Token Bot Slack

Hanya tambahkan dua skop groups:* apabila akses saluran peribadi diperlukan. Apl itu masih mesti dijemput ke setiap saluran sasaran.

4.3 Dayakan mesej langsung dalam App Home

Jika pengguna boleh menghantar mesej terus kepada Hermes Agent:

  1. Buka Ciri → Laman Utama Apl.
  2. Tatal ke Tunjukkan Tab.
  3. Dayakan Tab Mesej.
  4. Dayakan pilihan yang membenarkan pengguna menghantar mesej daripada tab Mesej.

Jika anda hanya menggunakan sebutan saluran, anda boleh melangkau bahagian ini dan meninggalkan acara im:* skop dan message.im.

4.4 Langgan acara bot

  1. Buka Ciri → Langganan Acara.
  2. Hidupkan Dayakan Acara.
  3. Di bawah Langgan acara bot, klik Tambah Acara Pengguna Bot.
  4. Tambahkan app_mention untuk sebutan saluran.
  5. Tambahkan message.im jika mesej langsung didayakan.
  6. Klik Simpan Perubahan.

Konfigurasikan langganan acara bot Slack

Jika anda menukar skop atau acara selepas pemasangan, kembali ke OAuth & Permissions dan klik Reinstall to Workspace. Kebenaran baharu tidak berkuat kuasa sehingga apl dipasang semula.

5. Pasang apl dan salin Token Bot

  1. Kembali ke Ciri → OAuth & Kebenaran.
  2. Klik Pasang ke Ruang Kerja. Jika apl sudah dipasang, klik Pasang Semula ke Ruang Kerja.

Pasang aplikasi Slack ke ruang kerja

  1. Semak kebenaran yang diminta dan klik Benarkan.

Benarkan kebenaran aplikasi Slack

  1. Selepas Slack kembali ke OAuth & Permissions, cari Token OAuth untuk Ruang Kerja Anda.
  2. Salin Token OAuth Pengguna Bot yang bermula dengan xoxb-.

Salin Token OAuth Pengguna Bot Slack

Jangan gunakan Rahsia Tandatangan, Rahsia Pelanggan, Token Pengesahan atau xoxp-... Token OAuth Pengguna. LightVela memerlukan satu xapp-... Token Apl dan satu xoxb-... Token Bot.

6. Ikat Slack dalam LightVela

  1. Kembali ke Saya Hermes → Saluran → Slack.
  2. Tampalkan token xoxb-... ke dalam Slack Token Bot.
  3. Tampalkan token xapp-... ke dalam Slack Token Aplikasi.
  4. Sahkan bahawa token berada dalam medan yang betul, kemudian serahkan sambungan.
  5. Tunggu sehingga kad Slack ditunjukkan sebagai disambungkan.

7. Ujian Hermes Agent dalam Slack

7.1 Uji sebutan saluran

  1. Buka saluran Slack di mana anda ingin menggunakan Hermes Agent.
  2. Jemput apl:
/invite @Hermes Agent
  1. Hantar mesej yang menyebut bot:
@Hermes Agent Summarize the key points discussed in this channel today.

Bot hanya menerima mesej saluran selepas ia menyertai saluran itu.

7.2 Uji mesej langsung

  1. Buka apl baharu daripada bahagian Apl dalam Slack.
  2. Pilih tab Mesej.
  3. Hantar mesej ringkas seperti Hello.

Uji mesej langsung di App Home Slack


Keadaan kejayaan

Persediaan selesai apabila semua semakan yang berkenaan lulus:

  • Kad Slack dalam LightVela menunjukkan sebagai disambungkan.
  • Apl Slack dipasang dalam ruang kerja sasaran.
  • Hermes Agent membalas sebutan dalam saluran yang telah disertai oleh apl.
  • Apabila kebenaran App Home dan IM didayakan, Hermes Agent membalas mesej langsung.

Jenis mesej yang disokong

Selepas Slack disambungkan, saluran menyokong senario pemesejan ini:

Slack jenis mesejDisokong
Terima sebutan teks dalam saluran✅ Disokong
Terima teks mesej terus dalam App Home✅ Disokong
Balas dengan teks dalam saluran dan mesej langsung✅ Disokong
Hantar mesej proaktif, seperti pemberitahuan tugas berjadual✅ Disokong

Soalan Lazim

IsuKemungkinan puncaResolusi
Token Apl ditolakJenis token yang salah atau tiada connections:writeJana token xapp-... baharu di bawah Maklumat Asas → Token Tahap Apl
Token Bot ditolakToken OAuth Pengguna atau bukti kelayakan lain telah disalinSalin xoxb-... Token OAuth Pengguna Bot daripada OAuth & Permissions
Langganan Acara meminta URL PermintaanMod Soket dilumpuhkanDayakan Tetapan → Mod Soket, kemudian kembali ke Langganan Acara
Sebutan saluran tidak diterimaApl tiada dalam saluran, skop tiada atau app_mention tiadaJemput apl, tambahkan skop saluran dan app_mention, kemudian pasang semula apl
Mesej langsung tidak diterimaTab Messages dilumpuhkan, skop IM tiada atau message.im tiadaDayakan Tab Mesej, tambah im:* dan message.im, kemudian pasang semula apl
Keizinan baharu tidak berfungsiApl tidak dipasang semula selepas perubahanKlik Pasang Semula ke Ruang Kerja di bawah OAuth & Kebenaran
Saluran disambungkan tetapi tiada balasanModel tidak tersedia, kredit tidak mencukupi atau isu status EjenSemak Konfigurasikan Model, status contoh dan kredit tersedia

Langkah seterusnya

Dikemas kini pada 2026-10-08