Atlassian'ın Teamwork Graph API'si üzerine kurulu bir Rovo agent, Jira içinde ekip iş yükü sorularını yanıtlıyor

Bir geliştirici, Atlassian'ın Teamwork Graph API'sini Jira içinde bir Rovo agent'ı çalıştıran eksiksiz bir örnek yayınladı. dev.to'daki bir gönderiye göre, agent'a "ekibim ne üzerinde çalışıyor?" diye sorduğunuzda, graph üzerinden bir Atlassian ekibinin tüm üyelerini ve kendilerine atanmış iş kalemlerini okuyor ve yanıtı Rovo oluşturuyor. Yazarın test sitesinde dört test sorusunun tamamını doğru yanıtladı ve her işlem 0,8 ile 2,6 saniye arasında çalıştı.

Agent ne yapıyor

Forge uygulaması, üç eylemli tek bir Rovo agent'ı ortaya koyuyor ve bunların tamamı GET istekleri. İlki, bir kişiye atanmış iş kalemlerini durumlarıyla ve o kişinin üyesi olduğu Atlassian ekipleriyle birlikte listeliyor. Bir diğeri, tek bir iş kalemi etrafındaki kişileri haritalıyor: atanan kişi, rapor eden kişi, son yorum yazanlar, atanan kişinin ekipleri ve bağlantılı hedefler. Üçüncüsü ise ekip iş yükü sorusunu yanıtlıyor. Tamamı 234 satır JavaScript, 81 satırlık bir manifest ve 11 satırlık bir prompt'tan oluşuyor ve depo herkese açık olmadığı için yazar gönderide her dosyayı birebir paylaşıyor.

Yalnızca GET kullanan tasarım bilinçli bir tercih. Gönderiye göre Atlassian'ın action dokümantasyonunda belirtildiği üzere, otomasyon kurallarıyla tetiklenen agent'lar CREATE, UPDATE, DELETE veya TRIGGER eylemlerini çağırmıyor; dolayısıyla salt okunur eylemler agent'ı daha fazla yerde kullanılabilir kılıyor.

Teamwork Graph API nasıl çalışıyor

Teamwork Graph, Atlassian'ın bir sitede ve bir kuruluş genelinde neler bulunduğunun bağlantılı modeli: kullanıcılar, ekipler, Jira iş kalemleri, yorumlar, hedefler, Confluence sayfaları ve üçüncü taraf connector'ların eklediği her şey. Uygulamalar ona site başına bir endpoint üzerinden GraphQL ile erişiyor. 15 Ekim 2026'dan beri Preview aşamasında; yazarın da belirttiği gibi bu durum, Early Access Program'a yapılan eski atıfları geçersiz kılıyor, hatta Atlassian'ın bazı sayfa başlıkları hâlâ EAP diyor.

Uygulamalar graph'a "curated" sorgularla erişiyor: Atlassian'ın tanımladığı, hazır ve tipli GraphQL operasyonları, örneğin atlassianUserAssignedJiraWorkItems. Bunlar kayıt gerektirmiyor ve first ile after argümanlarıyla sayfalanıyor. İzinler artık nesne türü başına tek bir scope kullanıyor, örneğin read:graph:issue:jira veya read:graph:team:atlassian; eski geniş kapsamlı read:graph:jira ve read:graph:confluence ise emekliye ayrılıyor.

Gönderide alıntılandığı haliyle Atlassian'ın curated queries sayfasındaki iki ayrıntı tasarımı şekillendirdi. Dönen her satır, kimliği doğrulanmış kullanıcı için izin filtresinden geçiyor; yani bir sorgu yalnızca o kullanıcının zaten görebileceği şeyleri döndürüyor — agent'ın bu yüzden sohbet eden kişi olarak çalışması bundan. Ve 25 olan sayfa boyutu sınırı aşıldığında hata fırlatıyor, dolayısıyla istemci her zaman sayfalama yapıyor. Atlassian ayrıca kırıcı değişikliklerden önce en az bir aylık bir deprecation bildirimi vaat ediyor ve tam şema site endpoint'inden indirilebiliyor; yazarın kopyası 172 KB'ydı.

Ön koşullar ve pürüzler

Çalıştırmak için Rovo'nun etkin olduğu, Standard, Premium veya Enterprise planlı bir Jira Cloud sitesi gerekiyor. Rovo yalnızca ücretli olduğu için ücretsiz bir sitede bulunmayabilir, ancak Standard veya Premium denemesi bunu içeriyor. Ayrıca uygulamayı kurmak ve graph scope'larını onaylamak için kuruluş yöneticisi hakları, Forge CLI (yazar 14.1.0 kullandı; güncel sürüm 15.0.0 ve Node.js 22.23.4 veya daha yenisini gerektiriyor) ve @forge/api 8.4.0 gerekiyor. Yazar, inşa süresinin büyük kısmının küçük sürprizlere gittiğini, bunlardan onunun gotcha olarak toplandığını söylüyor; bunlara HTTP 200 olarak gelen bir hata ve görünür bir başarısızlık yerine boş liste döndüren bir rate limit dahil.

Codegeist boyutu

Demo, Atlassian'ın hackathon'u Codegeist 2026 öncesinde API'leri öğrenmek için yazıldı; etkinlikte Teamwork Graph uygulamalarına özel bir bonus ödül var. Başvurular 27 Ekim 2026'da açıldı ve 22 Aralık 2026'da kapanıyor; kazananlar 15 Şubat 2027 civarında açıklanacak. Üç kategorinin her birinde birinciliğe 15.000 dolar ödül veriliyor ve 1.500 dolarlık dört bonus ödül, her biri altı projeye veriliyor. Bu uygulamadaki gibi bir uygulama iki bonus kategorisi için uygun: Best Agents ve Best Teamwork Graph integration; ancak tek bir başvuru bunlardan yalnızca birini kazanabiliyor.

Neden önemli

Preview durumu, herkesin bugün Teamwork Graph'a, genel kullanıma açılmış bir özellikle aynı destekle ve kırıcı değişiklikler için garantili bir deprecation penceresiyle inşa edebileceği anlamına geliyor. Demo, engelin düşük olduğunu gösteriyor: çalışan bir graph destekli asistan birkaç yüz satıra sığıyor. En az bunun kadar önemlisi, her satırın soran kullanıcıya göre filtrelenmesi şeklindeki izin modeli, yapay zeka agent'larının şirket verilerini okurken bir yetki yükseltme açığına dönüşmeden bunu yapmasını sağlayan desen. Ve Codegeist'e girecek herkes için gönderi, nitelikli bir uygulamanın ve yol boyunca karşılaşılacak tuhaflıkların somut bir haritası işlevi de görüyor.