GitHub, Copilot usage metrics API’sine agent app (ajan uygulaması) aktivitesini ayrı ayrı raporlayan yeni bir alan ekledi. Bu güncellemeyle ekipler, Copilot coding agent dışında Claude veya Codex gibi iş ortağı ajanlarının GitHub iş akışlarındaki kullanımını her bir ajan bazında görebilecek. Kırılım; enterprise, organization, enterprise-user ve organization-user düzeyindeki 1 günlük ve 28 günlük raporlarda geçerli.
Ne değişti?
Rapor yanıtına totals_by_3rd_party_agent adıyla opsiyonel yeni bir dizi eklendi. Bu dizide tanınan her ajan uygulaması için bir kayıt yer alıyor. Her kayıt şu alanları içeriyor:
agent_name: Ajanın görünen adı. Görünen adlar zaman içinde değişebildiği için raporlama dönemleri arasında birleştirme yaparken bu alan yerineagent_idüzerinden gruplama öneriliyor.agent_id: Ajanın kararlı (stable) tanımlayıcısı. Dönemler arası join işlemlerinde kullanılması gereken anahtar bu alandır.user_initiated_interaction_count: Kullanıcı tarafından başlatılan ajan uygulaması iş (job) başlatma sayısı.session_count: Ajan uygulaması oturum sayısı. Bu alan yalnızca toplulaştırılmış enterprise ve organization raporlarında yer alıyor; kullanıcı başına raporlarda (per-user) bulunmuyor.
Bu ayrım neden önemli?
Değişiklikten önce ajan aktivitesi kullanım metriklerinde tek bir kova içinde toplanıyordu. Copilot coding agent üzerinden yapılan çalışma ile diğer ajanlar üzerinden yürütülen çalışma birbirinden ayrıştırılamıyordu. Birden fazla ajanı benimseyen ekipler için bu durum temel soruların yanıtsız kalmasına yol açıyordu: Hangi ajanlar gerçekten kullanılıyor? Kaç kişi kullanıyor? Yeni devreye alınan bir ajanın benimsenmesi, tamamlayıcısı olarak konumlandırılan ajana kıyasla nasıl gidiyor?
Aktivitenin ajan bazında ayrılması; her bir ajan uygulamasını ayrı takip etmeyi, benimseme oranlarını karşılaştırmayı, dağıtım (rollout) ve lisanslama kararlarını varsayım yerine gerçek kullanım verisine dayandırmayı kolaylaştırıyor.
Dikkat edilmesi gereken noktalar
Yeni alan yapısında bazı incelikler var; özellikle raporlama araçlarını veya BI panolarını API’ye bağlayan ekiplerin gözünden kaçmamalı:
- Aynı isim, farklı anlam: Yeni dizinin içindeki
user_initiated_interaction_countalanı, ajan uygulaması iş başlatma sayısını sayıyor. Bu alan, yanıtın üst seviyesindeki aynı isimli alandan farklıdır; üst seviyedeki alan diğer desteklenen telemetri kaynaklarından gelen açık kullanıcı istemlerini (prompt) sayıyor. İki değer toplanmamalı veya birbirinin yerine kullanılmamalı. - Ajan bazında toplulaştırma: Aktivite ajan başına toplulaştırılıyor, yani aynı ajana ait birden fazla uygulama tek bir kayıt altında birleşiyor. Tanımlanamayan ajanlardan gelen aktivite raporun dışında bırakılıyor.
- Geriye dönük uyumluluk: Değişiklik geriye dönük uyumlu, mevcut alanlar aynı yapıda kalıyor. İlgili raporlama döneminde tanınan bir ajan uygulaması aktivitesi yoksa
totals_by_3rd_party_agentalanı yanıta hiç eklenmiyor. Bu davranış, ajan verisi beklerken boş dizi yerine alanın hiç gelmeyebileceğini göz önünde bulunduran bir istemci kodu yazmayı gerektiriyor.
Erişim ve ön koşullar
Bu metriklere enterprise sahipleri (owner), faturalandırma yöneticileri (billing manager), organizasyon sahipleri ve View Copilot Metrics iznini tanıyan özel bir organizasyon veya enterprise rolüne sahip kişiler erişebiliyor. Metriklerin görünmesi için ayrıca Copilot usage metrics politikasının etkinleştirilmiş olması gerekiyor.
Panolar ve entegrasyonlar için pratik sonuçlar
Ajan bazlı kırılımın API tarafında sunulması, özellikle çok sayıda ajan uygulamasını paralel deneyen kurumlar için raporlama tarafında birkaç mimari kararı beraberinde getiriyor. Dönemler arası karşılaştırmalarda ajanın görünen adı değişebildiği için veri ambarında birincil anahtar olarak agent_id alanını tutmak ve agent_name‘i yalnızca sunum katmanında kullanmak mantıklı bir yaklaşım. Aynı ajana bağlı birden fazla uygulamanın tek satırda birleştiği de düşünüldüğünde, uygulama düzeyinde daha ince bir kırılım bekleyen panoların bu davranışa göre yeniden düzenlenmesi gerekebilir.
Öte yandan aynı isimli iki farklı user_initiated_interaction_count alanının bulunması, ETL süreçlerinde alan adı çakışması riskini artırıyor. İki sayacın anlamsal olarak farklı şeyleri ölçtüğü net biçimde belgelenmediği sürece raporlarda yanlış toplam üretmek kolay bir hataya dönüşebilir. Bu yüzden nested alanların taşındığı hedef tablolarda ayrı sütun adları kullanmak, üst seviye sayacın “prompt tabanlı”, nested sayacın ise “job başlatma tabanlı” olduğunu meta veri olarak korumak işe yarar.
Kaynaklar ve İleri Okuma
- Copilot usage metrics API adds agent app activity — GitHub Changelog
- Copilot usage metrics REST API — GitHub Docs
- Copilot usage metrics alan tanımları — GitHub Docs
- Copilot Usage Metrics API ile Kullanıcı Bazlı AI Kredisi
- GitHub Copilot app now available in the usage metrics API
- Copilot Cloud Agent Metriği: Kullanımı Ölçmek Kolaylaştı
20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.
Ajan bazlı kırılım gerçekten eksik bir özellikti, hangi ajanın ne kadar kullanıldığını görmek enterprise tarafında maliyet takibi açısından çok işe yarayacak. 28 günlük pencere de güzel, tek günlük veriye bakıp karar vermek yanıltıcı olabiliyordu.
Copilot’un hangi ajan üzerinden ne kadar kullanıldığını görmek güzel bir şeffaflık adımı, özellikle kurumsal tarafta maliyet analizi yapanlar için bayağı işe yarayacak. Acaba bu kırılımı ileride custom agentlar için de genişletecekler mi? Bu arada şu yazınız da güzeldi: Azure App Service Linux’ta FastAPI Dağıtımı Sadeleşti — https://www.askinkilic.com.tr/azure-app-service-linuxta-fastapi-dagitimi-sadelesti/
Sonunda hangi ajanın ne kadar kullanıldığını görebileceğiz, bu gerçekten eksik bir şeydi. Özellikle birden fazla üçüncü parti araç kullanan ekiplerde maliyet takibi yapmak çok zordu.
Tam zamanında geldi bu özellik, hangi ajanın ne kadar kullanıldığını görmek enterprise ortamlarda gerçekten kritikti. 28 günlük kırılım özellikle maliyet analizi yaparken işe yarayacak gibi görünüyor.