Jambatkan Slack ke ruang kerja anda

Apa yang akan anda bina

Menjelang akhir tutorial ini, anda akan mempunyai:

• Apl Slack yang dicipta untuk ruang kerja anda, dengan kebenaran dan peristiwa yang betul sudah ditetapkan
• Sambungan hidup antara Slack dan Control Center
• Akaun Slack anda sendiri dipautkan kepada pengguna Control Center anda
• Ejen yang menjawab anda dalam utas Slack dan tiket yang difailkan daripada perintah slash

Prasyarat:

• Ruang kerja pertama anda dan Hantar ejen pertama anda telah selesai — ruang kerja tanpa ejen boleh menerima mesej Slack tetapi tiada sesiapa untuk menjawabnya
• Ejen CEO ruang kerja itu mempunyai penyesuai dan model yang ditetapkan di Tetapan → Ruang kerja → Ejen. Jambatan itu membangunkan ejen CEO, bukan ejen yang anda konfigurasikan dalam tutorial sebelumnya, dan ejen tanpa penyesuai berjalan pada gelung terbina dengan model lalai Anthropic.
• Peranan owner atau admin dalam ruang kerja Control Center (menyambungkan apl sembang mewakili seluruh ruang kerja)
• Kebenaran untuk mencipta dan memasang apl dalam ruang kerja Slack anda

Tiada apa di sini memerlukan alamat awam, terowong atau port masuk. Control Center menghubungi keluar ke Slack melalui Socket Mode, jadi ini berfungsi daripada komputer riba di belakang NAT.

Langkah 1: Dapatkan token konfigurasi apl Slack

Ini satu-satunya rahsia yang perlu anda peroleh sendiri. Ia membolehkan Control Center mencipta dan kemudian menyunting apl itu untuk anda.

1. Buka api.slack.com/apps
2. Tatal ke bahagian token konfigurasi apl di bahagian bawah halaman
3. Jana sepasang token untuk ruang kerja Slack anda
4. Salin token penyegaran — ia bermula dengan xoxe-

Langkah 2: Biarkan Control Center mencipta apl itu

1. Dalam Control Center, pergi ke Tetapan → Ruang kerja → Umum dan cari kad Jambatan sembang
2. Pada blok Slack, klik Cipta apl untuk saya
3. Tampal token konfigurasi apl
4. Semak rupa bot itu nanti:
   • Nama apl: cara Slack menyenaraikan apl itu, contohnya Control Center · Acme
   • Nama bot: apa yang orang taip selepas @, contohnya control-center
   • Perihalan ringkas dan Apa yang bot kata ia boleh lakukan
   • Perintah slash: cc secara lalai, jadi perintahnya ialah /cc
   • Mesej terus: biarkan hidup supaya ahli boleh menghantar DM kepada bot
5. Klik Cipta apl

Control Center menyusun keseluruhan definisi apl itu — Socket Mode dihidupkan, skop bot dan langganan peristiwa yang diperlukannya, perintah slash, tab Mesej — dan menciptanya dalam Slack.

Langkah 3: Selesaikan dua langkah yang hanya boleh dilakukan oleh Slack

Slack tiada API untuk menjana token peringkat apl atau memasang apl, jadi dialog itu memberikan kedua-duanya sebagai pautan:

1. Jana token peringkat apl — membuka Basic Information → App-Level Tokens. Cipta token dengan skop connections:write dan salinnya. Ia bermula dengan xapp-
2. Pasang apl — membuka Install App. Pasang ke ruang kerja anda, kemudian salin Bot User OAuth Token. Ia bermula dengan xoxb-

Simpan kedua-dua nilai itu untuk langkah seterusnya.

Langkah 4: Sambung

1. Kembali dalam dialog, klik Tampal kelayakan
2. Masukkan Token bot (xoxb-…) dan Token peringkat apl (xapp-…)
3. Biarkan Token konfigurasi apl kosong — yang dari langkah 1 sudah disimpan (Slack memutarkannya dan Control Center menyimpan yang baharu)
4. Klik Sambung

Control Center mengesahkan token bot dengan Slack sebelum ia menyimpan apa-apa, kemudian membuka soket. Baris itu kini memaparkan nama bot dan nama ruang kerja Slack anda dengan teg Langsung.

Langkah 5: Pautkan akaun Slack anda sendiri

Sambungan itu menjadikan bot boleh dihubungi; memautkan menjadikan anda boleh dikenali. Sehingga identiti Slack anda dipautkan, bot itu tidak akan bertindak atas mesej anda — ia tidak pernah mengatribusikan mesej kepada sesiapa yang memasang apl itu.

Memautkan bersifat peribadi, jadi ia terletak pada halaman yang berbeza daripada sambungan seluruh ruang kerja.

1. Pergi ke Tetapan → Ruang kerja → Profil & identiti dan cari kad Akaun sembang dipautkan
2. Klik Pautkan akaun Slack saya
3. Salin perintah yang ditunjukkannya, contohnya /cc link K7M2QP
4. Dalam Slack, hantar perintah itu kepada bot dalam DM
5. Bot menjawab “Dipautkan — anda ialah …”

Kod itu sekali guna dan tamat tempoh dalam 15 minit. Jika e-mel Slack anda sepadan dengan pengguna Control Center yang sudah menjadi ahli ruang kerja ini, jambatan itu memautkan anda secara automatik kali pertama anda bercakap dengannya dan anda boleh langkau langkah ini.

Jika anda menyebut bot itu sebelum ini selesai, ia menolak dan menyatakan sebabnya. Ketiga-tiga penolakan itu berbeza, jadi baca yang mana satu anda terima:

• Penghantar belum dipautkan: bot memberitahu anda cara memautkannya. Kembali ke langkah ini.
• Dipautkan, tetapi bukan ahli ruang kerja ini: minta pentadbir menjemput anda.
• Ahli dengan peranan hanya baca (viewer atau guest): bot tidak akan memulakan kerja bagi pihak anda.

Langkah 6: Serahkan sesuatu kepada ejen

1. Dalam Slack, jemput bot itu ke dalam saluran: /invite @control-center

2. Sebut bot itu dengan permintaan sebenar:

   @control-center rumuskan PR terbuka pada repo api

Jambatan itu:

1. Mencipta ruang Control Center untuk utas Slack itu, dinamakan sempena saluran Slack dan permintaan anda
2. Membangunkan ejen pintu depan ruang kerja itu (ejen CEO apabila ada, jika tidak ejen pertama)
3. Menstrim jawapan ejen itu kembali ke dalam utas Slack semasa ia ditulis

Balas dalam utas Slack yang sama untuk teruskan — tidak perlu sebut lagi, kerana utas Slack itu kini dijambatkan. Atau hantar DM kepada bot dan bukan menggunakan saluran; setiap perbualan DM memandu ruang Control Center tersendiri, dengan tajuk dan baris status “is thinking…” semasa ejen bekerja.

Penstriman memerlukan API penstriman Slack, yang tidak dimiliki oleh setiap pelan. Jika apl anda ditolak aksesnya, jambatan itu berhenti mencuba untuk keseluruhan sambungan itu dan menyiarkan setiap balasan sebagai satu mesej, dan kad Jambatan sembang memaparkan “Penstriman langsung dimatikan untuk apl Slack ini — balasan tiba sebagai satu mesej.” Segala-galanya yang lain berfungsi sama.

Langkah 7: Failkan tiket tanpa meninggalkan Slack

/cc ticket Fix the flaky login test | It fails on CI about once a day.

Bot menjawab dengan kunci tiket yang difailkannya. Tiket itu ialah tiket Control Center tempatan biasa, dilaporkan oleh anda, sedia untuk diberikan kepada ejen. /cc help menyenaraikan segala yang boleh dilakukan oleh perintah itu.

Ringkasan

Anda mencipta apl Slack daripada Control Center, menyambungkannya melalui soket keluar, memautkan identiti Slack anda kepada pengguna Control Center anda dan memandu ejen daripada utas Slack. Segala yang berlaku dalam Slack juga wujud dalam Control Center: utas Slack ialah ruang, balasan itu ialah transkrip, tiket itu ialah tiket.

Seterusnya: Sediakan integrasi Slack merangkumi laluan manual, memutar token dan penyelesaian masalah. Untuk model di sebaliknya, baca Jambatan sembang.