Copilot Usage Metrics API’ye Ajan Bazlı Aktivite Kırılımı
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.
Yorum gönder