Proje yönetimi
Jira'yı Otonom Bir Yapay Zeka Ajanına Bağlamak
Jira'ya bağlı bir Atako ajanı, iş akışlarınızda issue'lar arayabilir, oluşturabilir ve ilerletebilir; token'ı oluşturan hesapla aynı haklarla.
Olası iş akışları
Gelen ticket'ların triyajı ve önceliklendirilmesi
Bir destek kanalından veya bir formdan alınan bir sinyalden yola çıkarak, ajan issue'yu doğru tür ve öncelikle oluşturur (create_issue), iş kurallarınıza göre atar (assign_issue) ve alınan bağlamı yorum olarak ekler (add_comment). Ekip, gerçek işe başlamadan önce triyaj etmek için bir kez okumak zorunda kalmadan, zaten sınıflandırılmış bir ticket bulur.
Haftalık sprint ilerleme raporu
Ajan, mevcut sprint'in issue'larını bir JQL sorgusuyla sorgular (search_issues), üzerlerine loglanan zamanı alır (list_worklogs) ve son değişiklikleri (get_issue_changelog), ardından epic veya üst ticket üzerinde yorum olarak bir özet yayımlar (add_comment). Rapor, önceden bir durum toplantısı olmadan, engellenmiş ticket'lar sprint'in tam listesinde boğulmak yerine öne çıkarılmış şekilde her pazartesi sabahı hazır olur.
Bir olayla ilgili ticket'ların takibi ve kapatılması
Başka bir kanal tarafından bir düzeltme onaylanır onaylanmaz, ajan mevcut iş akışı geçişlerini kontrol eder (list_transitions), ticket'ı ilerletir (transition_issue), onu kaynak olayla ilişkilendirir (create_issue_link) ve ilgili izleyicileri bilgilendirir. Ticket, kronolojiyi dağınık Slack mesajlarından veya herkesin hafızasından sonradan yeniden oluşturmak zorunda kalmadan, yazılı bir post-mortem için faydalı, eksiksiz bir izleme kaydı taşır.
Bağlayıcı eylemleri
search_issues (okuma, JQL)
Bir JQL sorgusuyla issue'lar arar.
get_issue (okuma)
Bir issue'yu kimliğine veya anahtarına göre alır.
get_issue_changelog (okuma)
Bir issue'nun değişiklik geçmişini alır.
list_worklogs (okuma)
Bir issue üzerinde loglanan zamanı listeler.
list_transitions (okuma)
Bir issue için mevcut iş akışı geçişlerini listeler.
list_projects (okuma)
Hesabın görebildiği projeleri listeler.
create_issue (yazma)
Bir projede bir issue oluşturur.
update_issue (yazma)
Mevcut bir issue'nun alanlarını günceller.
transition_issue (yazma)
Bir issue'yu iş akışında ilerletir.
add_comment (yazma)
Bir issue'ya bir yorum ekler.
assign_issue (yazma)
Bir issue'yu bir kullanıcıya atar.
add_worklog (yazma)
Bir issue üzerinde geçirilen zamanı kaydeder.
create_issue_link (yazma)
İki issue'yu birbirine bağlar (engelliyor, ilgili).
Ön koşullar
- Hedeflenen projelerde browse, create ve edit haklarına sahip bir Jira hesabı (Jira admin hakkı zorunlu değildir).
- id.atlassian.com üzerinde, Security ardından API tokens bölümünde bir API token oluşturmak.
- Jira site adını bilmek (yourcompany.atlassian.net'in yourcompany kısmı).
- Kimlik doğrulaması için email:token biçiminde bir tanımlayıcı oluşturmak.
- Atako'da, ajana grant'i vermek için entegrasyon yönetimi hakkı.
Nasıl bağlanılır
- 1
Bir Atlassian API token'ı oluşturun
id.atlassian.com'da, Security ardından API tokens'a gidin, bir token oluşturun, adlandırın ve kopyalayın.
- 2
Bağlantı tanımlayıcısını oluşturun
Jira hesabının e-postasını ve API token'ını email:token biçiminde birleştirin.
- 3
Jira'yı Atako'ya bağlayın
Ayarlar, ardından Entegrasyonlar'ta, Jira site adını girin ve tanımlayıcıyı yapıştırın.
- 4
Ajana grant'i verin
Ajanın sayfasından veya bağlantıdan, izin verilen kesin eylemleri ve kapsamlarını seçin.
Neden otonom bir ajanı Jira'ya bağlamalı
Jira, teknik bir ekibin issue'larını takip ettiği yer olmaya devam ediyor, ama bu issue'lar etrafındaki triyaj, hatırlatma ve raporlama, gerçek geliştirme işine kıyasla orantısız bir zaman alıyor. Jira'ya tool calling üzerinden bağlı bir Atako ajanı, haftalık bir durum toplantısını beklemeden, kendi ortamında sürekli olarak bu işin bir kısmını yapabilir.
Klasik bir webhook veya planlanmış bir betikle fark şu: ajan sürekli çalışır ve hareket etmeden önce bir durumu yorumlar. Başka bir kanaldan (e-posta, Slack) bir sinyal alabilir, bağlamı bulmak için bir JQL sorgusuyla Jira'yı sorgulayabilir, ardından kendisine verilen eylemlere göre bir issue oluşturmaya, yorumlamaya veya iş akışında ilerletmeye karar verebilir.
Jira konektörü, Atako belgelerine göre 39 eylemi kapsar (24 okuma, 15 yazma), JQL aramadan worklog takibine kadar. Somut bir ürün kullanım örneği: ajanın bir Jira ticket'ı açmadan önce, zaten belgelenmiş şekilde bir pipeline başarısızlığını son commit'lerle ilişkilendirdiği CI/CD olay triyajı.
Limitler ve iyi uygulamalar
Atlassian, Jira Cloud API'sindeki hız limitlerini, her isteğin karmaşıklığına göre değişken bir maliyet tükettiği bir puan modeline doğru geliştiriyor; saatlik tavana ek olarak saniye başına bir patlama tavanı da var. Bu yüzden bir kerede çok fazla issue sorgulayan bir ajan, hepsini tek bir istekte yüklemek yerine çağrılarını sayfalamalıdır.
API token'ı, onu oluşturan Jira hesabının izinlerini sıkı biçimde devralır: bu hesabın bir projeye erişimi yoksa, Atako tarafında yapılandırılan grant ne olursa olsun ajanın da erişimi olmayacaktır.
Her entegrasyonda olduğu gibi, tek başına bağlantı hiçbir erişim vermez: kesin bir grant (ajan, eylem, kapsam) gerekir. Ajanı Jira projelerinize bağlamadan önce izin modeline ve planlara bakın.
İlgili kullanım örnekleri
İlgili entegrasyonlar
Sık sorulan sorular
Ajan bir Jira ticket'ını tek başına kapatabilir mi?
Evet, yazma kapsamında transition_issue eylemine sahipse ve projenin iş akışı istenen geçişe izin veriyorsa. Bu açık grant olmadan, ajan bir issue'nun durumunu okuyup yorumlayabilir ama ilerletemez.
Ajanı bağlamak için Jira yöneticisi olmak gerekir mi?
Hayır. API token'ı, onu oluşturan hesabın haklarını devralır: hedeflenen projelerde browse, create ve edit erişimi olan bir hesap yeterlidir, tam Jira yönetimi gerekli değildir.
Ajanın Jira erişimi nasıl iptal edilir?
API token'ı id.atlassian.com'dan silin veya Atako tarafında bağlantıyı iptal edin. Her iki durumda da, bu bağlantıyı kullanan tüm ajanlar erişimi hemen kaybeder.
Ajan bir Jira issue'sunu kalıcı olarak silebilir mi?
delete_issue eylemi konektörde mevcuttur, ilişkili alt görevleri silmek dahil, ama yalnızca ajanın grant'i yazma kapsamında bunu açıkça yetkilendiriyorsa kullanılabilir.
Sırada ne okumalı
Kaynaklar
- Atlassian, Manage API tokens for your Atlassian account · erişim tarihi 4 Eylül 2026
- Atlassian Developer, Rate limiting, Jira Cloud platform · erişim tarihi 4 Eylül 2026
Atako CTO'su
Bu içerik Atako'nun yapay zeka ajanları tarafından yazılmış, ardından Atako CTO'su Romain Laodicina tarafından gözden geçirilmiş, düzeltilmiş ve onaylanmıştır.