Bot Slack untuk Agen Coding: Hubungkan Sharkly Agent ke Slack

TL;DR

Bot Slack untuk coding agent adalah aplikasi Slack yang terikat pada satu AI agent, sehingga pesan langsung dan mention berubah menjadi percakapan agent dan setiap balasan masuk ke thread yang sama. Di Sharkly, setiap bot terikat pada tepat satu Agent, dan Agent tersebut menjawab dengan instruksi, model, skill, dan repo yang Anda konfigurasikan untuknya.

1. Buka api.slack.com/apps dan buat App Configuration Token, lalu salin Refresh Token-nya.
2. Di Sharkly, buka Integrations, pilih Slack, lalu pilih Connect Agent.
3. Pilih Agent yang akan diikat dan, jika mau, beri nama aplikasinya (Slack membatasi nama aplikasi maksimal 35 karakter).
4. Tempel Refresh Token dan pilih Create & Install.
5. Setujui permintaan OAuth di jendela yang dibuka Slack.
6. Tunggu status bot berubah dari Installing ke Connected, lalu kirim pesan langsung ke bot.

Mengapa coding agent Anda sebaiknya menjawab di Slack

Tim Anda sudah menjalankan coding agent. Ada yang membuka Claude Code di terminal, ada yang membuat skrip untuk menjalankan Codex, dan hasilnya tersimpan di riwayat shell masing-masing orang. Sementara itu, pertanyaan-pertanyaan yang bisa dijawab agent tersebut justru diajukan di Slack, karena Slack adalah tempat tim berbicara.

Kesenjangan itu ada harganya. Ketika seorang product manager bertanya mengapa endpoint export mulai gagal, pertanyaan itu diteruskan ke developer, yang lalu bertanya ke agent dan menyampaikan jawabannya kembali. Proses perantara ini menambah satu jam untuk pertanyaan yang sebenarnya dijawab agent dalam sembilan puluh detik.

Sharkly menutup kesenjangan itu dari sisi platform. Sharkly bukan pengganti Claude Code, Codex, atau alat eksekusi lain; Sharkly menambahkan lapisan Task, konteks, kontrol, dan review bersama di sekelilingnya. Integrasi Slack-nya memperluas lapisan itu ke workspace Anda, sehingga rekan tim mendapatkan jawaban di tempat pertanyaannya diajukan.

Dua koneksi, dua fungsi

Integrasi ini menyediakan dua jenis koneksi yang independen, dan mencampuradukkannya adalah sumber kebingungan yang paling umum:

Keduanya adalah pemasangan terpisah yang didukung aplikasi Slack terpisah, dan masing-masing bisa berfungsi tanpa yang lain. Ada dua batasan lagi: satu workspace Slack hanya terhubung ke satu Organisasi Sharkly pada satu waktu, dan aksi Slack di dalam otomasi Space menggunakan koneksi ketiga, di mana Slack berfungsi sebagai aksi tetapi belum bisa memulai workflow pada rilis ini. Panduan ini membahas pengikatan bot Agent.

Apa itu bot Slack Agent Sharkly?

Bot Agent menghubungkan satu Agent Sharkly ke satu aplikasi Slack. Pesan berubah menjadi percakapan Agent, dan balasannya kembali ke DM atau thread yang sama. Agent yang menjawab adalah rekan tim yang dikonfigurasi yang sama seperti di tempat lain di Sharkly: instruksi, model, skill, dan pengetahuan repositori yang sama.

Pengikatan ini benar-benar satu banding satu, dan Anda dapat mengikat Personal Agent milik Anda sendiri plus Agent yang dibagikan di Space yang boleh Anda gunakan.

Ada dua antarmuka yang menyertai pemasangan ini. Pesan langsung membuat sesi obrolan untuk channel DM tersebut, dan pesan berikutnya melanjutkan sesi itu, sehingga Agent mempertahankan konteks alih-alih memulai dari nol. Mention di channel menghapus mention, mengirim sisanya ke Agent, dan membalas dalam thread yang berakar pada pesan Anda.

@ReleaseShark summarize the decision in this thread and list the next steps

Sharkly mengabaikan pesan dari bot lain, event pesan yang diedit, dan event join, yang mencegah loop balasan saat beberapa aplikasi berbagi satu channel.

Cara menghubungkan AI agent ke Slack

Anda memerlukan Agent yang bisa dikonfigurasi (lihat panduan memulai) dan izin untuk membuat Slack App Configuration Token serta memasang aplikasi untuk tim tujuan.

1. Buka api.slack.com/apps dan temukan Your App Configuration Tokens.
2. Buat App Configuration Token dan salin Refresh Token-nya (dokumentasi Slack). Perlakukan sebagai rahasia dan kirimkan hanya melalui formulir koneksi Sharkly.
3. Di Sharkly, buka Integrations dan pilih Slack.
4. Pilih Connect Agent dan pilih Agent yang akan diikat.
5. Jika mau, masukkan nama aplikasi. Jika dibiarkan kosong, nama Agent yang digunakan.
6. Tempel Refresh Token dan pilih Create & Install.
7. Selesaikan otorisasi OAuth Slack di jendela yang terbuka. Jika tidak ada yang muncul, izinkan pop-up lalu coba lagi.
8. Tunggu status bot berubah dari Installing ke Connected.

Sharkly menukar refresh token dengan configuration access token berdurasi singkat, membuat aplikasi dari manifest yang mencakup identitas bot, tampilan Slack Assistant, redirect OAuth, callback dan scope Events API, lalu membuka Slack untuk memasangnya.

Verifikasi dengan mengirim DM ke bot. Balasan menandakan seluruh alur berhasil: event diterima, sesi dibuat, eksekusi selesai, respons terkirim. Jika bot tetap berstatus Installing, callback OAuth belum menyimpan token bot, jadi buka kembali jendela pemasangan dan selesaikan prompt-nya. Jika Agent tidak bisa dipilih, berarti Agent tersebut sudah terikat pada aplikasi lain.

Pemicu bot Slack: mention, reaksi emoji, pesan apa pun

Secara default, bot merespons pesan langsung dan mention di channel, tidak yang lain. Di pengaturan Slack milik Agent, tiap pemicu adalah baris yang bisa Anda aktifkan atau nonaktifkan:

• Di-mention di channel adalah pengaturan default. Agent hanya berjalan saat seseorang menyebut bot, dan balasannya masuk ke thread di bawah mention tersebut.
• Reaksi emoji di channel mengubah reaksi menjadi pemicu. Bereaksi dengan emoji yang dikonfigurasi, dan bot akan membuka thread dengan konteks di sekitarnya.
• Pesan apa pun di channel menjalankan Agent pada pesan biasa di channel yang Anda pilih secara eksplisit. Ini tidak bisa diterapkan ke semua channel, dan aplikasi lain yang memposting di sana bisa memicunya.

Pasangan keputusan yang menjaga ini tetap masuk akal: pertahankan mode hanya-mention di channel bersama, karena pemicu yang luas menimbulkan kebisingan dan mengekspos konteks yang tidak relevan ke Agent. Aktifkan Pesan apa pun di channel hanya di channel khusus yang semua orang memang mengharapkan pesannya sampai ke Agent. Pemicu emoji berada di antara kedua ekstrem itu, karena tidak ada yang sampai ke Agent kecuali seseorang sengaja bereaksi.

Setiap thread di channel adalah percakapan Agent tersendiri, jadi dua thread di satu channel berarti dua sesi dengan konteks terpisah, dan orang bisa melanjutkan thread tanpa menyebut bot lagi. Aplikasi ini juga mengaktifkan Slack Assistant, panel yang disediakan Slack untuk aplikasi AI.

Percakapan Slack bukanlah sebuah Task

Percakapan bot Agent tidak pernah membuat Task sendiri, dan batasan itu memang disengaja. Aturan dari chat versus penugasan Task berlaku tanpa perubahan: gunakan chat saat Anda butuh jawaban, tugaskan Task saat Anda butuh hasil yang akan ditinjau seseorang.

Saat Agent membuat Task dari Slack, Anda bisa sekaligus mengikat thread yang sedang berjalan. Setelah diikat, komentar task dan pesan thread tetap sinkron. Pengikatan thread inilah yang membuat integrasi ini bernilai: sebuah diskusi dimulai di Slack, berubah menjadi Task, dan sejak itu progres, hambatan, dan hasil kembali ke Task sementara thread tetap mutakhir bagi orang-orang yang ada dalam percakapan tersebut.

Kapan bot Slack bukan alat yang tepat

Anda hanya ingin pembuatan Task dan pratinjau tautan. Cukup gunakan koneksi workspace saja. Slash command, shortcut, linkback, dan unfurl semuanya berasal dari aplikasi bersama.

Anda ingin pesan channel terjadwal atau digerakkan event. Itu adalah aksi Slack di dalam workflow otomasi, bukan percakapan. Karena event Slack belum bisa memicu workflow pada rilis ini, mulailah dari jadwal, perubahan status, kata kunci komentar, atau webhook.

Pekerjaannya butuh eksekusi terhadap repositori dengan review di akhir. Tugaskan Task. Gunakan bot untuk bertanya; gunakan Task untuk membangun.

Anda ingin satu bot mewakili seluruh daftar Agent Anda. Pengikatan seperti itu tidak ada. Beberapa spesialis yang berkoordinasi dalam pekerjaan nyata seharusnya berada dalam sebuah Crew yang mengerjakan Task, bukan channel yang penuh bot.

Keamanan dan izin

• App Configuration Refresh Token ditukar selama penyiapan dan tidak digunakan sebagai token bot yang terpasang. Client secret, signing secret, dan token bot OAuth yang dihasilkan dienkripsi saat disimpan.
• Callback Events API diverifikasi dengan signing secret yang tersimpan; tanda tangan yang tidak valid ditolak dan ukuran body event dibatasi.
• Tinjau scope yang diminta sebelum mengotorisasi: mention, pesan langsung, riwayat thread channel dan channel privat, pengiriman pesan, pembukaan DM, dan pembaruan status Assistant.
• Owner dan Admin mengelola workspace bersama dan semua pengikatan; member mengelola pengikatan untuk Agent yang boleh mereka gunakan.

Memutuskan koneksi tidak bersifat destruktif: Agent berhenti menerima pesan melalui bot tersebut, tetapi riwayat Slack tidak tersentuh dan tidak ada pesan lama yang berubah menjadi Task.

Kesimpulan

Bot Slack untuk coding agent layak digunakan ketika ia mengubah tempat percakapan berlangsung tanpa mengubah tempat pekerjaannya berada. Ikat satu Agent yang sudah Anda percayai, pertahankan default hanya-mention sampai ada channel yang menuntut lebih, dan gunakan pengikatan thread begitu obrolan berubah menjadi pekerjaan. Jika Anda belum punya Agent, buat dulu satu.

Pertanyaan yang sering diajukan

Apakah saya perlu menghubungkan workspace Slack sebelum mengikat bot Agent?

Tidak. Kedua jenis koneksi itu independen. Koneksi workspace hanya Anda perlukan untuk pembuatan Task dari Slack, linkback, pratinjau tautan, dan DM notifikasi Inbox.

Bisakah satu bot Slack melayani beberapa Agent Sharkly?

Tidak. Setiap bot terikat pada tepat satu Agent, dan satu Agent hanya menyimpan satu pengikatan pada satu waktu. Untuk menempatkan beberapa Agent di Slack, buat bot terpisah untuk masing-masing.

Apakah mengobrol dengan bot otomatis membuat Task?

Tidak. Saat percakapan berubah menjadi pekerjaan yang membutuhkan penanggung jawab, status, atau review, buat Task secara sengaja. Jika Agent yang membuatnya dari Slack, Anda bisa mengikat thread agar komentar dan pesan tetap sinkron.

Bisakah pesan Slack memulai workflow otomasi Sharkly?

Belum pada rilis ini. Slack tersedia di workflow sebagai aksi, tetapi pemicu Slack melalui Events API belum terhubung.