İş uzmanınız Amazon Q için bir Slack ağ geçidi dağıtın

Orijinal makale: Link (Gary Benattar ve Bob Strahan)

Amazon Q, kullanıcıların işlerini halletmelerine yardımcı olan yapay zeka destekli yeni bir uygulamadır. Amazon Q, size özel iş uzmanınız olabilir ve şirketinizin verilerini güvenli ve emniyetli bir şekilde kullanarak içerik keşfetmenize, fikirler üzerinde beyin fırtınası yapmanıza veya özetler oluşturmanıza olanak tanır. Amazon Q’yu şirketinizin bilgi havuzlarına, kodlarına, verilerine ve kurumsal sistemlerine bağlanarak konuşmalar yapmak, sorunları çözmek, içerik oluşturmak, içgörüler elde etmek ve harekete geçmek için kullanabilirsiniz. Daha fazla bilgi için Yapay zeka destekli yeni asistan Amazon Q ile tanışın (ön izleme) bölümüne bakın.

Bu yazıda, iş uzmanınız Amazon Q‘yu Slack’teki kullanıcılara nasıl getireceğinizi gösteriyoruz.

Amazon Q ile Slack doğrudan mesajlarını (DM’ler) kullanarak sohbet edebilir, şirket verilerine dayalı sorular sorabilir ve yanıtlar alabilir, e-posta taslakları gibi yeni içerikler oluşturma konusunda yardım alabilir, ekli dosyaları özetleyebilir ve görevleri yerine getirebilirsiniz.

Amazon Q’yu ekip kanallarınıza katılmaya da davet edebilirsiniz. Bir kanalda, kullanıcılar ek veri noktaları sağlamak, bir tartışmayı çözmek veya konuşmayı özetlemek ve sonraki adımları yakalamak için yeni bir mesajda soru sorabilir veya herhangi bir noktada mevcut bir konuya etiketleyebilir.

Çözüme genel bakış

Amazon Q inanılmaz derecede güçlü. Bu linkteki demoyu izleyin – görmek inanmaktır!

Demoda, Amazon Q uygulamamız bir dizi AWS whitepaper ile doldurulmuştur. Kendi Amazon Q iş uzmanı uygulamanızı kendi şirketinizin belgeleri ve bilgi tabanı makaleleri ile doldurabilirsiniz, böylece sorularınızı yanıtlayabilir!

İhtiyacınız olan her şey GitHub depomuzda açık kaynak olarak sağlanmaktadır.

Bu yazıda, AWS hesabınızda Amazon Q’yu dağıtma ve Slack çalışma alanınıza ekleme sürecinde size yol göstereceğiz. İşiniz bittiğinde, onsuz nasıl idare ettiğinizi merak edeceksiniz!

Aşağıdakiler yapabileceği şeylerden bazılarıdır:

• Mesajları yanıtlama – DM’lerde tüm mesajlara yanıt verir. Kanallarda, yalnızca @mentions yanıt verir ve bir konuşma dizisinde yanıt verir.
• Markdown içeren yanıtları işleyin – Buna başlıklar, listeler, kalın, italik yazılar, tablolar ve daha fazlası dahildir.
• Duyarlılığı izleyin – Kullanıcı duyarlılığını izlemek için beğenme ve beğenmeme düğmeleri sağlar.
• Kaynak atıfları sağlayın – Amazon Q tarafından kullanılan kaynaklara referanslar ve köprüler sağlar.
• Konuşma bağlamını anlayın – Konuşmayı izler ve bağlama göre yanıt verir.
• Birden fazla kullanıcının farkında olun – Bir ileti dizisinde etiketlendiğinde, kimin ne söylediğini ve ne zaman söylediğini bilir, böylece bağlam içinde katkıda bulunabilir ve sorulduğunda ileti dizisini doğru bir şekilde özetleyebilir.
• Ekli dosyaları işleyin – Belge sorusu yanıtlama, özetler ve daha fazlası için beş adede kadar ekli dosyayı işleyebilir.
• Yeni konuşmalar başlatın – DM kanallarında /new_conversation kullanarak sıfırlayabilir ve yeni konuşmalar başlatabilirsiniz.

Aşağıdaki bölümlerde, projeyi kendi AWS hesabınıza ve Slack çalışma alanınıza nasıl dağıtacağınızı gösteriyoruz ve denemeye başlıyoruz!

Ön Koşullar

Bu uygulama için gerekli kaynakları ve bileşenleri oluşturmak ve yönetmek üzere bir AWS hesabınızın ve AWS Kimlik ve Erişim Yönetimi (IAM) rolünüzün ve izinlere sahip bir kullanıcınızın olması gerekir. AWS hesabınız yoksa Yeni bir Amazon Web Hizmetleri hesabını nasıl oluşturabilir ve etkinleştirebilirim? sayfasına bakın.

Ayrıca mevcut, çalışan bir Amazon Q iş uzmanı uygulamanızın olması gerekir. Henüz bir uygulama kurmadıysanız Amazon Q uygulaması oluşturma bölümüne bakın.

Son olarak, Slack organizasyonunuzda uygulama oluşturmak ve yayınlamak için bir Slack hesabına ve erişimine ihtiyacınız vardır. Eğer yoksa, şirketinizin denemeniz için bir Slack sandbox organizasyonu oluşturup oluşturamayacağına bakın veya ücretsiz bir Slack hesabı ve çalışma alanı oluşturmak için slack.com adresine gidin.

Çözüm kaynaklarını dağıtın

AWS hesabınızda ihtiyacınız olan her şeyi dağıtan önceden oluşturulmuş AWS CloudFormation şablonları sağladık.

Bir geliştiriciyseniz ve çözümü koddan oluşturmak, dağıtmak veya yayınlamak istiyorsanız Developer README‘sine bakın.

CloudFormation yığınını başlatmak için aşağıdaki adımları tamamlayın:

1. AWS Management Console‘da oturum açın.
2. AWS CloudFormation konsolunu açmak ve yeni bir yığın oluşturmak için istediğiniz AWS Bölgesi için aşağıdaki Launch Stack (Yığını Başlat) düğmelerinden birini seçin.

Bölge	Yığını Başlat
N. Virginia (us-east-1)
Oregon (us-west-2)

1. Stack name (Yığın adı) için uygulamanız için bir ad girin (örneğin, AMAZON-Q-SLACK-GATEWAY).
2. AmazonQAppId için mevcut Amazon Q uygulama kimliğinizi girin (örneğin, 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). Bunu Amazon Q konsolundan kopyalayabilirsiniz.
3. AmazonQRegion için Amazon Q uygulamanızı oluşturduğunuz Bölgeyi seçin (us-east-1 veya us-west-2).
4. AmazonQUserId için bir Amazon Q kullanıcı kimliği e-posta adresi girin (kullanıcı kimliği olarak bir Slack kullanıcı e-postası kullanmak için boş bırakın).
5. ContextDaysToLive için, Amazon DynamoDB’de önbelleğe alınan konuşma meta verilerinin tutulacağı süreyi girin (bunu varsayılan olarak bırakabilirsiniz).

CloudFormation yığınınızın durumu CREATE_COMPLETE olduğunda, Outputs (Çıktılar) sekmesini seçin ve açık tutun; sonraki adımlarda buna ihtiyacınız olacak.

Uygulamanızı oluşturun

Artık uygulamanızı Slack’te oluşturabilirsiniz. Aşağıdaki adımları tamamlayın:

1. Oluşturulan manifestodan https://api.slack.com/apps adresinde bir Slack uygulaması oluşturun – yığın çıktısından kopyalayın ve yapıştırın: SlackAppManifest.
2. Gezinti bölmesinde App Home (Uygulama Ana Sayfası) seçin ve Show Tabs (Sekmeleri Göster) bölümüne ilerleyin.
3. Messages Tab (Mesajlar Sekmesi) kısmını etkinleştirin.
4. Allow users to send Slash commands and messages from the messages tab (Mesajlar sekmesinden Kullanıcıların Slash komutları ve mesajları göndermesine izin ver) ögesini seçin.

Bu, kullanıcınızın uygulamanıza mesaj göndermesini sağlamak için gerekli bir adımdır.

Uygulamanızı çalışma alanınıza ekleyin

Şimdi uygulamanızı çalışma alanınıza ekleyebilirsiniz. Bu, bir sonraki adımda gerekli olan bot kullanıcısı OAuth token değerini oluşturmak için gereklidir.

1. OAuth belirtecini oluşturmak için OAuth & Permissions (https://api.slack.com adresinde) bölümüne gidin ve Install to Workspace‘i seçin.
2. Slack’te çalışma alanınıza gidin.
3. Çalışma alanı adınızı, Settings & administration (Ayarlar ve yönetim) ve Manage apps (Uygulamaları yönet) ögelerini seçin.
4. Yeni oluşturduğunuz uygulamayı seçin.
5. Sağ bölmede Open in App Directory (Uygulama Dizininde Aç) ögesini seçin.
6. Open in Slack (Slack’te Aç) seçin.

AWS Secrets Manager’da Slack gizli dizilerini yapılandırma

Amazon Q botunuz adına her isteğin ve gönderinin imzasını doğrulamak için Slack gizli dizilerinizi yapılandıralım.

Bu örnekte Slack token rotasyonunu etkinleştirmiyoruz. AWS Secrets Manager aracılığıyla rotasyonu uygulayarak bunu bir üretim uygulaması için etkinleştirebilirsiniz. Bu özelliğin gelecekteki bir sürüme eklenmesini istiyorsanız GitHub deposunda bir sorun (veya daha iyisi bir çekme isteği) oluşturun.

Secrets Manager’da bir gizli diziyi yapılandırmak için aşağıdaki adımları tamamlayın:

1. AWS CloudFormation konsolunda, yığın Outputs (Çıktıları) sekmenize gidin ve Secrets Manager konsoluna yönlendirilmek için SlackSecretConsoleUrl bağlantısını seçin.
2. Retrieve secret value seçin.
3. Edit seçin.
4. SlackSigningSecret ve SlackBotUserOAuthToken değerlerini, Basic Information (Temel Bilgiler) ve OAuth & Permissions (OAuth & İzinler) altındaki Slack uygulama yapılandırmasındaki değerleri kullanarak değiştirin.

Signing Secret yerine yanlışlıkla Client Secret kopyalamamaya dikkat edin.

Amazon Q’yu kullanmaya başlayın

Slack’te Amazon Q’yu kullanmaya başlamak için aşağıdaki adımları tamamlayın:

1. Slack çalışma alanınızı açın.
2. Apps, Manage altında yeni Amazon Q uygulamanızı ekleyin.
3. İsteğe bağlı olarak, Amazon Q uygulamanızı ekip kanallarına ekleyin.
4. Uygulama DM kanalına Hello girin.

Artık sandbox Slack ortamınıza güçlü ve yeni bir yapay zeka asistanı yerleştirdiniz.

Onunla oynayın, bu yazıda tartışılan tüm özellikleri deneyin ve demo videosunda gördüğünüz şeyleri kopyalayın. En önemlisi, kendi Amazon Q iş uzmanı uygulamanıza aldığınız belgelerle ilgili konular hakkında soru sorabilirsiniz. Ancak burada durmayın. Uygulamayı kullanışlı hale getirmek için başka yollar da bulabilirsiniz ve bunu yaptığınızda yorum yazarak bize bildirin.

Ne kadar faydalı olduğuna ikna olduğunuzda, Slack yöneticilerinizle konuşun (ve onlara bu yazıyı gösterin) ve şirketinizin Slack çalışma alanlarına yerleştirmek için onlarla birlikte çalışın. Çalışan arkadaşlarınız size teşekkür edecek!

Temizlik

Bu çözümü denemeyi bitirdiğinizde, Slack’teki uygulamanızı silin (https://api.slack.com/apps) ve AWS CloudFormation konsolunu açıp dağıttığınız AMAZON-Q-SLACK-GATEWAY yığınını silerek AWS kaynaklarınızı temizleyin. Bu, çözümü dağıtarak oluşturduğunuz kaynakları siler.

Sonuç

Bu yazıda ele alınan örnek Amazon Q slack uygulaması açık kaynak olarak sunulmaktadır; kendi çözümünüz için bir başlangıç noktası olarak kullanabilir ve GitHub çekme istekleri aracılığıyla düzeltmelere ve özelliklere katkıda bulunarak daha iyi hale getirmemize yardımcı olabilirsiniz. Kodu keşfedin, yeni sürümlerden haberdar olmak için GitHub deposunda Watch (İzle) seçin ve en son güncellemeler için tekrar kontrol edin. İyileştirme ve özellik önerilerinizi de duymak isteriz.

Amazon Q hakkında daha fazla bilgi için Amazon Q (İş Kullanımı İçin) Nedir? sayfasına bakabilirsiniz.