JIRA Entegrasyonu

AI SmartTalk asistanınızı Atlassian JIRA ile bağlayarak akıllı proje yönetimi ve sorun izleme yeteneklerini etkinleştirin. Bu entegrasyon, AI asistanınızın doğal dil etkileşimleri aracılığıyla sorunları aramasını, oluşturmasını, güncellemesini, zaman kaydetmesini ve sprintleri yönetmesini sağlar.

Genel Bakış

JIRA entegrasyonu, AI asistanınızın aşağıdakileri yapmasını sağlar:

• Sorunları Ara: Doğal dil sorguları kullanarak sorunları bulun
• Sorun Detaylarını Görüntüle: Belirli sorunlar hakkında kapsamlı bilgi alın
• Sorun Oluştur: Yeni biletler, görevler veya hatalar otomatik olarak oluşturun
• Sorun Güncelle: Sorun durumunu, önceliğini, atanan kişiyi ve diğer alanları değiştirin
• Zaman Takibi: Ayrıntılı yorumlar ve açıklamalar ile çalışma süresini kaydedin
• Sprint Yönetimi: Panoları, sprintleri listeleyin ve sprint planlamasını yönetin
• Proje Yönetimi: Proje bilgilerine ve ekip işbirliği verilerine erişim sağlayın

Ön Koşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

• Asistan yapılandırma erişimi olan aktif bir AI SmartTalk hesabı
• Yönetici ayrıcalıklarına sahip bir JIRA Cloud veya Server örneği
• JIRA örneğinizde API erişimi etkinleştirilmiş
• Uygun proje izinlerine sahip kullanıcı hesap kimlik bilgileri

Adım Adım Kurulum

Adım 1: JIRA Entegrasyonuna Erişim

1. AI SmartTalk hesabınıza giriş yapın
2. Yönetim → Asistanlarım → [Asistan Adınız] yolunu izleyin
3. Sol yan çubukta Bağlayıcılar üzerine tıklayın
4. Mevcut bağlayıcılar listesinden JIRA'yı bulun
5. JIRA entegrasyon kutusuna tıklayın

Adım 2: JIRA Bağlantısını Yapılandırma

1. JIRA URL: JIRA örneğinizin URL'sini girin (örn. https://yourcompany.atlassian.net)
2. Kullanıcı Adı/E-posta: JIRA hesap e-posta adresinizi sağlayın
3. API Token: JIRA API tokeninizi oluşturun ve girin
   • Atlassian hesap ayarlarınıza gidin
   • Güvenlik → API tokenlerini oluşturun ve yönetin yolunu izleyin
   • AI SmartTalk entegrasyonu için yeni bir token oluşturun
4. Bağlantıyı kurmak için Yapılandır butonuna tıklayın

Adım 3: AI Yeteneklerini Etkinleştirme

Etkinleştirmek istediğiniz AI yeteneklerini yapılandırın:

Sorun Yönetimi (4/4)

• ✅ JIRA_SEARCH_ISSUES: Doğal dil kullanarak sorunları arayın ve filtreleyin
• ✅ JIRA_GET_ISSUE: Belirli sorunlar hakkında detaylı bilgi alın
• ✅ JIRA_CREATE_ISSUE: Yeni sorunlar, görevler ve hatalar oluşturun
• ✅ JIRA_UPDATE_ISSUE: Mevcut sorunları ve özelliklerini değiştirin

Zaman Takibi (1/1)

• ✅ JIRA_LOG_TIME: Çalışma süresini yorumlar ve açıklamalar ile kaydedin

Sprint Yönetimi (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: Mevcut panoları ve aktif sprintleri görüntüleyin
• ✅ JIRA_CREATE_SPRINT: Yeni sprintler oluşturun ve sprint planlamasını yönetin

Adım 4: Proje Senkronizasyonu

1. JIRA projelerinizi almak için Projeleri Senkronize Et butonuna tıklayın
2. AI asistanınızın erişmesini istediğiniz projeleri seçin
3. Proje özel izinlerini ve erişim seviyelerini yapılandırın
4. İlk senkronizasyonun tamamlanmasını bekleyin

AI Asistanının Yetenekleri

Sorun Arama ve Yönetimi

AI asistanınız, doğal dil sorgularını işleyebilir:

Arama Örnekleri:

• "Çerezlerle ilgili tüm sorunları bul"
• "John'a atanmış yüksek öncelikli hataları göster"
• "Mevcut sprintteki tüm görevleri listele"
• "CCS projesi için açık sorunlar nelerdir?"

Sorun Detayları:

Kullanıcı: "CCS-11 hakkında bana bilgi ver"
AI: CCS-11 için detaylar burada:
- Başlık: Detaylı içerikle çikolatalı kurabiye hazırla
- Durum: Yapılacak
- Öncelik: Düşük
- Atanan: Atanmadı
- Açıklama: [Tam sorun açıklaması]

Sorun Oluşturma

Sohbet komutlarıyla sorunlar oluşturun:

Oluşturma Örnekleri:

• "Giriş sorunu için bir hata raporu oluştur"
• "Kullanıcı kimlik doğrulamasını uygulamak için bir görev ekle"
• "Yeni kontrol paneli özelliği için bir hikaye oluştur"

Zaman Kaydı

Çalışma süresini doğal dil ile kaydedin:

Zaman Takibi Örnekleri:

Kullanıcı: "@PO Bot CCS-11 için kurabiyelerin fırında olduğunu onaylıyorum ve 2 saat 200°C termostat kaydediyorum"

AI Yanıtı:
✅ CCS-11 için zaman başarıyla kaydedildi:
- Harcanan Zaman: 2 saat
- Yorum: Kurabiyeler 200°C termostatda fırında
- Başlangıç Tarihi: 14 Kasım 2025, 12:00 PM

Sprint Yönetimi

Sprintleri ve panoları sohbet ederek yönetin:

Sprint Örnekleri:

• "Mevcut sprintimizde neler var?"
• "Gelecek hafta için yeni bir sprint oluştur"
• "Tüm mevcut panoları göster"
• "CCS-11'i aktif sprint'e taşı"

Desteklenen JIRA Özellikleri

Sorun Türleri

Tür	Destekleniyor	AI Yetenekleri
Epic	✅	Alt sorunları oluştur, güncelle, bağla
Hikaye	✅	Tam CRUD işlemleri, hikaye puanı tahmini
Görev	✅	Tam görev yönetimi ve takibi
Hata	✅	Hata raporlama, şiddet atama, çözüm takibi
Alt Görev	✅	Alt görev oluşturma ve ana sorun bağlama

Alanlar ve Özellikler

Alan	Okuma	Yazma	AI Anlayışı
Özet	✅	✅	Doğal dil işleme
Açıklama	✅	✅	Zengin metin ve biçimlendirme desteği
Durum	✅	✅	İş akışı durumu yönetimi
Öncelik	✅	✅	Akıllı öncelik atama
Atanan	✅	✅	Takım üyesi tanıma
Raporlayan	✅	✅	Otomatik kullanıcı eşleştirme
Etiketler	✅	✅	Akıllı etiket önerileri
Bileşenler	✅	✅	Bileşen bazlı organizasyon
Düzeltme Versiyonu	✅	✅	Sürüm planlama entegrasyonu

Sorun Giderme

Yaygın Sorunlar

Bağlantı Problemleri

• Kimlik Doğrulama Başarısız:
  • JIRA URL formatını doğrulayın (https:// dahil edin)
  • API anahtarının geçerliliğini kontrol edin
  • Hesabın uygun izinlere sahip olduğundan emin olun
• Ağ Zaman Aşımı:
  • JIRA örneğinin erişilebilirliğini doğrulayın
  • Güvenlik duvarı ayarlarını kontrol edin
  • AI SmartTalk sunucularından bağlantıyı test edin

İzin Hataları

• Yetersiz İzinler:
  • Hesabınız için JIRA proje izinlerini gözden geçirin
  • Projeyi görüntüleme ve sorun oluşturma izinlerini kontrol edin
  • Proje yapılandırması için yönetici erişimini doğrulayın
• Proje Erişimi Reddedildi:
  • Kullanıcının hedef projelere eklendiğinden emin olun
  • Proje görünürlük ayarlarını kontrol edin
  • Proje anahtarının yazımını doğrulayın

Senkronizasyon Sorunları

• Projeler Yüklenmiyor:
  • Proje senkronizasyonunu yenileyin
  • JIRA örneğinin performansını kontrol edin
  • API hız limitlerini doğrulayın
• Sorun Güncellemeleri Başarısız:
  • Sorun iş akışı izinlerini kontrol edin
  • Alan gereksinimlerini ve doğrulama kurallarını doğrulayın
  • Sorunun düzenlenebilir durumda olduğundan emin olun

Performans Optimizasyonu

API Hız Limitleri

• Kullanımı İzleyin: API çağrılarını ve hız limitlerini takip edin
• Toplu İşlemler: Mümkünse birden fazla işlemi gruplandırın
• Önbellek Stratejisi: Sık erişilen veriler için akıllı önbellekleme uygulayın

Büyük Örnek Yönetimi

• Proje Filtreleme: Sadece ilgili projeleri senkronize edin
• Sorun Sayfalandırma: Büyük sonuç setlerini verimli bir şekilde yönetin
• Seçici Senkronizasyon: Belirli sorun türlerini ve durumlarını seçin

En İyi Uygulamalar

Proje Organizasyonu

• Açık İsimlendirme: Açıklayıcı proje ve sorun isimleri kullanın
• Tutarlı Etiketleme: Tutarlı etiket taksonomisi sürdürün
• Düzenli Temizlik: Tamamlanan projeleri ve sorunları arşivleyin

Kullanım Senaryoları ve Örnekler

Günlük Toplantı Otomasyonu

Takım Üyesi: "Dün üzerinde çalıştığım şeyleri ve bugün planlananları göster"
AI: "Dün CCS-9'u (2 saat kaydedildi) ve CCS-10'u (1.5 saat) tamamladınız. 
Bugün mevcut sprintte CCS-11 ve CCS-12 atandı."

Sprint Planlaması

Scrum Master: "Pazartesi başlayacak 2 haftalık yeni bir sprint oluştur"
AI: "✅ 18 Kasım 2025'te başlayacak 'Sprint 24' adında yeni sprint oluşturuldu. 
Beklemede olan sorunları eklemeye hazır."

Hata Raporlama

QA Testçisi: "Bir hata oluştur: Giriş formu e-posta formatını düzgün doğrulamıyor, yüksek öncelik"
AI: "✅ CCS-15: 'Giriş formu e-posta doğrulama sorunu' hatası oluşturuldu
- Öncelik: Yüksek
- Atanan: Geliştirme Ekibi
- Acil dikkat için mevcut sprinte eklendi"

İlerleme Takibi

Ürün Sahibi: "Kurabiye hazırlama projesinde nasıl gidiyoruz?"
AI: "Kurabiye projesi (CCS) durumu:
- 5 sorun tamamlandı (CCS-1'den CCS-5'e)
- 3 devam ediyor (CCS-7, CCS-9, CCS-11)  
- 2 yapılacak (CCS-12, CCS-13)
- Sprint tamamlama: %67 hedefe uygun"