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 edinin
• 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: Detaylı yorumlar ve açıklamalarla çalışma süresini kaydedin
• Sprint Yönetimi: Tahtaları, sprintleri listeleyin ve sprint planlamasını yönetin
• Proje Yönetimi: Proje bilgilerine ve ekip işbirliği verilerine erişin

Ö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] bölümüne gidin
3. Sol kenar çubuğunda Bağlayıcılar üzerine tıklayın
4. Mevcut bağlayıcılar listesinden JIRA'yı bulun
5. JIRA entegrasyon kutucuğuna tıklayın

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

1. JIRA URL: JIRA örneğinizin URL'sini girin (örneğin, https://yourcompany.atlassian.net)
2. Kullanıcı Adı/E-posta: JIRA hesap e-posta adresinizi sağlayın
3. API Token: JIRA API token'ınızı oluşturun ve girin
   • Atlassian hesap ayarlarınıza gidin
   • Güvenlik → API token'ları oluşturun ve yönetin bölümüne gidin
   • 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 Yetkinliklerini Etkinleştirme

Etkinleştirmek istediğiniz AI yetkinliklerini 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 ayrıntılı 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ı 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 atanan 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:
- 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ı aracılığıyla sorunlar oluşturun:

Oluşturma Örnekleri:

• "Giriş sorununa bir hata raporu oluştur"
• "Kullanıcı kimlik doğrulaması 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 çerezlerin 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: Fırında 200°C termostatda çerezler
- 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 sprinte taşı"

Desteklenen JIRA Özellikleri

Sorun Türleri

Tür	Destekleniyor	AI Yetenekleri
Epic	✅	Çocuk sorunları oluşturma, güncelleme, bağlama
Hikaye	✅	Tam CRUD işlemleri, hikaye puanı tahmini
Görev	✅	Tam görev yönetimi ve takibi
Hata	✅	Hata raporlama, ciddiyet 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 token 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
  • proje 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
• Önbellekleme 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şlayan 2 haftalık yeni bir sprint oluştur"
AI: "✅ 18 Kasım 2025'te başlayacak 'Sprint 24' adlı yeni sprint oluşturuldu. 
Geri plandan sorun 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: "✅ Hata CCS-15 oluşturuldu: 'Giriş formu e-posta doğrulama sorunu'
- Öncelik: Yüksek
- Atanan: Geliştirme Takımı
- Acil müdahale için mevcut sprinte eklendi"

İlerleme Takibi

Ürün Sahibi: "Kurabiye hazırlama projesinde durumumuz nasıl?"
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 tamamlanması: %67 yolda"