Kodlama Ajanları için Slack Botu: Sharkly Agent'ınızı Slack'e Bağlayın

TL;DR

Kodlama ajanları için bir Slack botu, tek bir AI ajanına bağlanan bir Slack uygulamasıdır; böylece doğrudan mesajlar ve bahsetmeler ajan sohbetlerine dönüşür ve her yanıt aynı başlıkta toplanır. Sharkly'de her bot tam olarak bir Ajana bağlanır ve o Ajan, onun için yapılandırdığınız talimatlar, model, beceriler ve depolar ile yanıt verir.

1. api.slack.com/apps adresini açın ve bir App Configuration Token oluşturun, ardından Refresh Token'ını kopyalayın.
2. Sharkly'de Integrations bölümünü açın, Slack'i seçin ve Connect Agent'ı seçin.
3. Bağlanacak Ajanı seçin ve isterseniz uygulamaya bir ad verin (Slack uygulama adlarını 35 karakterle sınırlar).
4. Refresh Token'ı yapıştırın ve Create & Install'ı seçin.
5. Slack'in açtığı pencerede OAuth istemini onaylayın.
6. Botun durumu Installing'den Connected'a geçene kadar bekleyin, ardından ona doğrudan bir mesaj gönderin.

Kodlama ajanlarınız neden Slack'te yanıt vermeli

Ekibiniz hâlihazırda kodlama ajanları kullanıyor. Birinin terminalinde Claude Code açık, bir başkası Codex çalıştırmalarını betikliyor ve çıktı her kişinin shell geçmişinde kalıyor. Öte yandan, bu ajanların yanıtlayabileceği sorular Slack'te soruluyor, çünkü ekip Slack'te konuşuyor.

Bu boşluğun bir maliyeti var. Bir ürün yöneticisi export endpoint'inin neden hata vermeye başladığını sorduğunda, soru bir geliştiriciye gidiyor, o da bir ajana sorup yanıtı geri iletiyor. Bu aracılık, ajanın doksan saniyede yanıtladığı bir soruya bir saat ekliyor.

Sharkly bu boşluğu platform tarafından kapatıyor. Sharkly, Claude Code, Codex veya diğer yürütme araçlarının yerini almaz; onların etrafına paylaşılan görev, bağlam, kontrol ve inceleme katmanını ekler. Slack entegrasyonu bu katmanı çalışma alanınıza taşır, böylece ekip arkadaşlarınız yanıtı sorunun sorulduğu yerde alır.

İki bağlantı, iki iş

Entegrasyon birbirinden bağımsız iki bağlantı türü sunar ve bunları karıştırmak en yaygın kafa karışıklığı kaynağıdır:

Bunlar ayrı Slack uygulamaları tarafından desteklenen ayrı kurulumlardır ve her biri diğeri olmadan çalışır. İki sınır daha: bir Slack workspace aynı anda yalnızca bir Sharkly Organizasyonuna bağlanır ve Space otomasyonları içindeki Slack eylemleri, Slack'in bir eylem olarak çalıştığı ancak bu sürümde bir iş akışı başlatamadığı üçüncü bir bağlantı kullanır. Bu kılavuz Ajan bot bağlamayı ele alır.

Sharkly Ajan Slack botu nedir?

Bir Ajan botu, bir Sharkly Ajanını bir Slack uygulamasına bağlar. Mesajlar bir Ajan sohbetine dönüşür ve yanıt aynı DM'e veya başlığa döner. Yanıt veren Ajan, Sharkly'nin her yerinde olduğu gibi aynı yapılandırılmış ekip arkadaşıdır: aynı talimatlar, model, beceriler ve depo bilgisi.

Bağlama kesinlikle bire birdir ve kendi Kişisel Ajanlarınızın yanı sıra kullanmanıza izin verilen Space ile paylaşılan Ajanları da bağlayabilirsiniz.

Kurulumla birlikte iki yüzey gelir. Doğrudan mesajlar, o DM kanalı için bir sohbet oturumu oluşturur ve sonraki mesajlar bunu sürdürür; böylece Ajan sıfırdan başlamak yerine bağlamı korur. Kanal bahsetmeleri bahsetmeyi çıkarır, geri kalanı Ajana gönderir ve mesajınızı kök alan bir başlıkta yanıtlar.

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

Sharkly diğer botlardan gelen mesajları, düzenlenmiş mesaj olaylarını ve katılma olaylarını yok sayar; bu da bir kanalı birkaç uygulama paylaştığında yanıt döngülerini önler.

Bir AI ajanı Slack'e nasıl bağlanır

Yapılandırabileceğiniz bir Ajana (bkz. başlangıç kılavuzu) ve bir Slack App Configuration Token oluşturma ile hedef ekip için bir uygulama kurma iznine ihtiyacınız vardır.

1. api.slack.com/apps adresini açın ve Your App Configuration Tokens bölümünü bulun.
2. Bir App Configuration Token oluşturun ve Refresh Token'ını kopyalayın (Slack'in belgeleri). Bunu bir sır olarak saklayın ve yalnızca Sharkly'nin bağlantı formu üzerinden gönderin.
3. Sharkly'de Integrations bölümünü açın ve Slack'i seçin.
4. Connect Agent'ı seçin ve bağlanacak Ajanı belirleyin.
5. İsteğe bağlı olarak bir uygulama adı girin. Boş bırakılırsa Ajanın adı kullanılır.
6. Refresh Token'ı yapıştırın ve Create & Install'ı seçin.
7. Açılan pencerede Slack OAuth yetkilendirmesini tamamlayın. Hiçbir şey görünmezse açılır pencerelere izin verin ve yeniden deneyin.
8. Botun durumu Installing'den Connected'a geçene kadar bekleyin.

Sharkly, refresh token'ı kısa ömürlü bir configuration access token ile değiştirir; bot kimliğini, Slack Assistant görünümünü, OAuth yönlendirmesini, Events API callback'ini ve scope'ları kapsayan bir manifest'ten uygulamayı oluşturur, ardından kurmak için Slack'i açar.

Bota bir DM göndererek doğrulayın. Bir yanıt tüm yolu doğrular: olay alındı, oturum oluşturuldu, çalıştırma tamamlandı, yanıt iletildi. Bot Installing'de kalırsa, OAuth callback'i henüz bot token'ını kaydetmemiştir; bu durumda kurulum penceresini yeniden açın ve istemi tamamlayın. Ajan seçilemiyorsa, zaten başka bir uygulamaya bağlıdır.

Slack bot tetikleyicileri: bahsetme, emoji tepkisi, her mesaj

Varsayılan olarak bot doğrudan mesajlara ve kanal bahsetmelerine yanıt verir, başka hiçbir şeye değil. Ajanın Slack ayarlarında her tetikleyici açıp kapatabileceğiniz bir satırdır:

• Bir kanalda bahsedilme varsayılandır. Ajan yalnızca biri botun adını söylediğinde çalışır ve yanıt bahsetmenin altındaki bir başlıkta toplanır.
• Bir kanalda emoji tepkisi bir tepkiyi tetikleyiciye dönüştürür. Yapılandırılmış emojiyle tepki verin ve bot yakındaki bağlamla bir başlık açar.
• Her kanal mesajı Ajanı, açıkça seçtiğiniz kanallardaki sıradan mesajlarda çalıştırır. Her kanala uygulanamaz ve oraya mesaj gönderen diğer uygulamalar bunu tetikleyebilir.

Bunu akılda tutmayı sağlayan karar ikilisi: paylaşılan kanallarda yalnızca bahsetme modunu koruyun; çünkü geniş tetikleme gürültü yaratır ve ilgisiz bağlamı Ajana açar. Her kanal mesajı seçeneğini yalnızca herkesin mesajların Ajana ulaşmasını beklediği özel bir kanalda açın. Emoji tetikleyicisi bu iki uç arasında yer alır, çünkü bir kişi bilinçli olarak tepki vermedikçe Ajana hiçbir şey ulaşmaz.

Her kanal başlığı kendi Ajan sohbetidir; yani bir kanaldaki iki başlık, ayrı bağlama sahip iki oturumdur ve kişiler bottan yeniden bahsetmeden bir başlığı sürdürebilir. Uygulama ayrıca Slack'in AI uygulamaları için sunduğu panel olan Slack Assistant'ı etkinleştirir.

Bir Slack sohbeti Task değildir

Ajan bot sohbetleri kendi başlarına asla Task oluşturmaz ve bu sınır bilinçlidir. sohbet ile görev atama karşılaştırmasından çıkan kural aynen geçerlidir: bir yanıta ihtiyaç duyduğunuzda sohbet edin, birinin inceleyeceği bir sonuca ihtiyaç duyduğunuzda bir Task atayın.

Bir Ajan Slack'ten bir Task oluşturduğunda mevcut başlığı aynı anda bağlayabilirsiniz. Bağladıktan sonra görev yorumları ve başlık mesajları senkronize kalır. Başlık bağlama, bu entegrasyona değerini kazandıran şeydir: bir tartışma Slack'te başlar, bir Task'a dönüşür ve sonrasında ilerleme, engeller ve sonuçlar Task'a dönerken başlık, konuşmada yer alan kişiler için güncel kalır.

Slack botu ne zaman yanlış araçtır

Yalnızca Task oluşturma ve bağlantı önizlemeleri istiyorsunuz. Tek başına workspace bağlantısını kullanın. Slash komutları, kısayollar, linkback'ler ve unfurl'lerin tümü paylaşılan uygulamadan gelir.

Zamanlanmış veya olay güdümlü kanal mesajları istiyorsunuz. Bu bir otomasyon iş akışı içindeki Slack eylemidir, bir sohbet değil. Slack olayları bu sürümde iş akışlarını tetikleyemediğinden bir zamanlamadan, durum değişikliğinden, bir yorum anahtar sözcüğünden veya bir webhook'tan başlayın.

İş, sonunda inceleme olan bir depoya karşı yürütme gerektiriyor. Bir Task atayın. Sormak için botu kullanın; inşa etmek için Task'ları kullanın.

Tüm kadronuzun önünde tek bir bot istiyorsunuz. Böyle bir bağlama yok. Gerçek iş üzerinde koordine olan birkaç uzman, botlarla dolu bir kanalda değil, bir Task üzerinde çalışan bir Crew içinde yer alır.

Güvenlik ve izinler

• App Configuration Refresh Token kurulum sırasında değiştirilir ve kurulu bot token'ı olarak kullanılmaz. Oluşturulan client secret, signing secret ve OAuth bot token'ı bekleme durumunda şifrelenir.
• Events API callback'leri saklanan signing secret ile doğrulanır; geçersiz imzalar reddedilir ve olay gövdeleri boyutla sınırlandırılır.
• Yetkilendirmeden önce istenen scope'ları inceleyin: bahsetmeler, doğrudan mesajlar, kanal ve özel kanal başlık geçmişi, mesaj gönderme, DM açma ve Assistant durum güncellemeleri.
• Paylaşılan workspace'i ve tüm bağlamaları Sahipler ve Yöneticiler yönetir; üyeler kullanabildikleri Ajanlar için bağlamaları yönetir.

Bağlantıyı kesmek yıkıcı değildir: Ajan o bot üzerinden mesaj almayı durdurur, ancak Slack geçmişi dokunulmamış kalır ve geçmişteki hiçbir mesaj Task'a dönüşmez.

Sonuç

Kodlama ajanları için bir Slack botu, işin yaşadığı yeri değiştirmeden sohbetin gerçekleştiği yeri değiştirdiğinde değer kazanır. Zaten güvendiğiniz bir Ajanı bağlayın, bir kanal daha fazlasını isteyene kadar yalnızca bahsetme varsayılanını koruyun ve bir sohbet işe dönüştüğü anda başlık bağlamayı kullanın. Henüz bir Ajanınız yoksa önce bir tane oluşturun.

Sıkça sorulan sorular

Bir Ajan botu bağlamadan önce bir Slack workspace bağlamam gerekiyor mu?

Hayır. İki bağlantı türü birbirinden bağımsızdır. Workspace bağlantısına yalnızca Slack'ten Task oluşturma, linkback'ler, bağlantı önizlemeleri ve Inbox bildirim DM'leri için ihtiyacınız vardır.

Bir Slack botu birden fazla Sharkly Ajanına hizmet edebilir mi?

Hayır. Her bot tam olarak bir Ajana bağlanır ve bir Ajan aynı anda yalnızca bir bağlama sahiptir. Slack'e birkaç Ajan koymak için her biri için ayrı bir bot oluşturun.

Botla sohbet etmek otomatik olarak Task oluşturur mu?

Hayır. Bir sohbet; sahibi, durumu veya incelemesi gereken bir işe dönüştüğünde Task'ı bilinçli olarak oluşturun. Ajan bunu Slack'ten oluşturursa, yorumlar ve mesajlar senkronize kalsın diye başlığı bağlayabilirsiniz.

Bir Slack mesajı bir Sharkly otomasyon iş akışını başlatabilir mi?

Bu sürümde hayır. Slack, iş akışlarında bir eylem olarak kullanılabilir, ancak Events API üzerinden Slack tetikleyicileri henüz bağlanmamıştır.