Slack’i çalışma alanınıza bağlayın

Neler oluşturacaksınız

Bu öğreticinin sonunda şunlara sahip olacaksınız:

• Çalışma alanınız için oluşturulmuş, doğru izinleri ve olayları zaten ayarlanmış bir Slack uygulaması
• Slack ile Control Center arasında canlı bir bağlantı
• Control Center kullanıcınıza bağlı kendi Slack hesabınız
• Size bir Slack dizisinde yanıt veren bir ajan ve bir slash komutuyla açılan bir bilet

Ön koşullar:

• İlk çalışma alanınız ve İlk ajanınızı gönderin tamamlanmış olmalı — ajanı olmayan bir çalışma alanı bir Slack iletisi alabilir, ama yanıtlayacak kimsesi yoktur
• Çalışma alanının CEO ajanında bir adaptör ve bir model ayarlıdır — Ayarlar → Çalışma alanı → Ajanlar. Köprü, önceki öğreticide yapılandırdığınız ajanı değil CEO’yu uyandırır ve adaptörü olmayan bir ajan, yerleşik döngüde Anthropic’in varsayılan modeliyle çalışır.
• Control Center çalışma alanında owner veya admin rolü (bir sohbet uygulaması bağlamak tüm çalışma alanı adına konuşur)
• Slack çalışma alanınızda uygulama oluşturma ve yükleme izni

Burada hiçbir şey herkese açık bir adres, bir tünel ya da gelen bir port gerektirmez. Control Center, Slack’e Socket Mode üzerinden dışarı bağlanır; bu yüzden NAT arkasındaki bir dizüstü bilgisayardan da çalışır.

1. Adım: Bir Slack uygulaması yapılandırma jetonu edinin

Bu, elle almanız gereken tek sırdır. Control Center’ın uygulamayı sizin için oluşturmasını ve sonradan düzenlemesini sağlar.

1. api.slack.com/apps adresini açın
2. Sayfanın altındaki uygulama yapılandırma jetonları bölümüne gidin
3. Slack çalışma alanınız için bir jeton çifti oluşturun
4. yenileme jetonunu kopyalayın — xoxe- ile başlar

2. Adım: Uygulamayı Control Center oluştursun

1. Control Center’da Ayarlar → Çalışma alanı → Genel bölümüne gidin ve Sohbet köprüleri kartını bulun
2. Slack bloğunda Uygulamayı benim için oluştur’a tıklayın
3. Uygulama yapılandırma jetonunu yapıştırın
4. Botun nasıl görüneceğini gözden geçirin:
   • Uygulama adı: Slack’in uygulamayı nasıl listelediği, örn. Control Center · Acme
   • Bot adı: insanların @ işaretinden sonra yazdığı ad, örn. control-center
   • Kısa açıklama ve Botun neler yapabileceğini söylediği metin
   • Slash komutu: varsayılan olarak cc, yani komut /cc olur
   • Direkt mesajlar: üyeler bota DM gönderebilsin diye açık bırakın
5. Uygulama oluştur’a tıklayın

Control Center uygulama tanımının tamamını oluşturur — Socket Mode açık, ihtiyaç duyduğu bot kapsamları ve olay abonelikleri, slash komutu, Messages sekmesi — ve uygulamayı Slack’te oluşturur.

3. Adım: Yalnızca Slack’in yapabileceği iki adımı tamamlayın

Slack’in uygulama düzeyinde bir jeton oluşturmak veya bir uygulamayı yüklemek için bir API’si yoktur; bu yüzden iletişim kutusu ikisini de size bağlantı olarak sunar:

1. Uygulama düzeyinde bir jeton oluştur — Basic Information → App-Level Tokens bölümünü açar. connections:write kapsamıyla bir jeton oluşturun ve kopyalayın. xapp- ile başlar
2. Uygulamayı yükle — Install App’i açar. Çalışma alanınıza yükleyin, ardından Bot User OAuth Token’ı kopyalayın. xoxb- ile başlar

Her iki değeri de sonraki adım için elinizin altında tutun.

4. Adım: Bağlanın

1. İletişim kutusuna dönüp Kimlik bilgilerini yapıştır’a tıklayın
2. Bot token (xoxb-…) ve Uygulama düzeyi token (xapp-…) değerlerini girin
3. Uygulama yapılandırma jetonu alanını boş bırakın — 1. adımdaki zaten saklanmıştı (Slack onu rotasyona soktu ve Control Center yenisini kaydetti)
4. Bağlan’a tıklayın

Control Center, herhangi bir şeyi saklamadan önce bot token’ını Slack ile doğrular, ardından soketi açar. Satır artık botun adını ve Slack çalışma alanınızın adını bir Canlı etiketiyle gösterir.

5. Adım: Kendi Slack hesabınızı bağlayın

Bağlantı botu erişilebilir kılar; hesabınızı bağlamaksa sizi tanınabilir kılar. Slack kimliğiniz bağlanana kadar bot iletileriniz üzerine iş yapmaz — bir iletiyi hiçbir zaman uygulamayı kuran kişiye atfetmez.

Hesap bağlama kişiye özeldir; bu yüzden çalışma alanı genelindeki bağlantıdan farklı bir sayfada yer alır.

1. Ayarlar → Çalışma alanı → Profil ve kimlik bölümüne gidin ve Bağlı sohbet hesapları kartını bulun
2. Slack hesabımı bağla’ya tıklayın
3. Gösterdiği komutu kopyalayın, örneğin /cc link K7M2QP
4. Slack’te bu komutu bota bir DM’de gönderin
5. Bot “Bağlandı — siz …” diye yanıtlar

Kod tek kullanımlıktır ve 15 dakika sonra süresi dolar. Slack e-postanız, bu çalışma alanının zaten üyesi olan bir Control Center kullanıcısıyla eşleşiyorsa, köprü botla ilk konuştuğunuzda sizi otomatik olarak bağlar ve bu adımı atlayabilirsiniz.

Bu tamamlanmadan botu etiketlerseniz, bot reddeder ve nedenini söyler. Üç ret birbirinden farklıdır; hangisini aldığınızı okuyun:

• Bağlı olmayan gönderen: bot size nasıl bağlanacağınızı söyler. Bu adıma dönün.
• Bağlı, ama bu çalışma alanının üyesi değil: bir yöneticiden sizi davet etmesini isteyin.
• Salt okunur role sahip üye (izleyici veya misafir): bot sizin adınıza iş başlatmaz.

6. Adım: Bir ajana bir iş verin

1. Slack’te botu bir kanala davet edin: /invite @control-center

2. Onu gerçek bir istekle etiketleyin:

   @control-center, api deposundaki açık PR’ları özetle

Köprü:

1. O Slack dizisi için, Slack kanalının ve isteğinizin adını taşıyan bir Control Center alanı oluşturur
2. Çalışma alanının ön kapı ajanını uyandırır (CEO ajanı varsa o, yoksa ilk ajan)
3. Ajanın yanıtını yazıldığı anda Slack dizisine akış halinde aktarır

Devam etmek için aynı Slack dizisinde yanıtlayın — başka etiketleme gerekmez, çünkü Slack dizisi artık köprülenmiştir. Ya da kanal kullanmak yerine bota DM gönderin; her DM konuşması kendi Control Center alanını yürütür ve ajan çalışırken bir başlıkla birlikte bir “düşünüyor…” durum satırı taşır.

Akış, Slack’in akış API’sini gerektirir ve bunu her plan sunmaz. Uygulamanıza bunun için izin verilmezse, köprü tüm bağlantı boyunca denemeyi bırakır ve her yanıtı tek bir ileti olarak gönderir; Sohbet köprüleri kartı da “Bu Slack uygulamasında canlı akış kapalı — yanıtlar tek ileti olarak gelir.” yazar. Geri kalan her şey aynı şekilde çalışır.

7. Adım: Slack’ten çıkmadan bilet açın

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

Bot, açtığı biletin anahtarıyla yanıtlar. Bilet, sizin bildirdiğiniz, bir ajana atanmaya hazır, sıradan bir yerel Control Center biletidir. /cc help komutun yapabildiği her şeyi listeler.

Özet

Control Center’dan bir Slack uygulaması oluşturdunuz, onu giden bir soket üzerinden bağladınız, Slack kimliğinizi Control Center kullanıcınıza bağladınız ve bir ajanı bir Slack dizisinden yönettiniz. Slack’te olan her şey Control Center’da da vardır: Slack dizisi bir alan, yanıt bir transkript, bilet bir bilettir.

Sonraki: Slack entegrasyonunu kurma elle yapılan yolu, jetonların rotasyonunu ve sorun gidermeyi kapsar. Altındaki model için Sohbet köprüleri sayfasını okuyun.