Ajan, GitHub’a her dakika sormadan ve kullanıcıdan herkese açık bir sunucu kurmasını istemeden bir pull request’e yeni bir inceleme yorumu eklendiğini nasıl öğrenebilir? GitHub, 17 Kasım 2026’da Event Streams’i preview olarak kullanıma açtı: istemci bir pull request’e abone oluyor, GitHub’la bağlantısını açık tutuyor ve olayları oluştukça alıyor.

Bu değişiklik, depo güncellemelerine tepki vermesi gereken yerel ajanlar ve otomasyonlar açısından pratik önem taşıyor. Kendi webhook alıcısı olmayanlar için değişiklikleri izlemenin alışıldık yolu API’yi belirli aralıklarla sorgulamaktır: sık sorgular istek kotasını tüketirken seyrek sorgular tepkiyi geciktirir. Olay akışı, zamanlayıcıyla kontrol etmek yerine değişiklik sinyali geldiğinde işlem başlatmayı sağlar.
Abone hangi olayları alıyor?
Event Streams belgelerinde pull request olayları listeleniyor: inceleme yorumu gönderilmesi, yeni commit, birleştirme çakışması, isteğin birleştirilmesi veya kapatılması, ayrıca denetim kümesinin değişmesi ya da tek bir denetimin tamamlanması. Olaylar Server-Sent Events (SSE) üzerinden iletiliyor; istemcinin herkese açık bir webhook uç noktası kurması gerekmiyor. Bu yöntem, örneğin yeni bir inceleme yorumuna veya commit’e tepki vermesi gereken geliştirici dizüstü bilgisayarındaki bir ajan için uygun.
Olay, bir değişiklik olduğuna dair sinyal görevi görüyor; ardından istemci GitHub REST API üzerinden güncel verileri alıyor. Örneğin yeni bir inceleme yorumuna ilişkin bildirim, onunla bağlantılı bir API kaynağına işaret ediyor; sonraki işlemi başlatmadan önce incelemenin veya pull request’in güncel durumu bu kaynaktan yüklenebiliyor.
Akış, polling ve webhook’tan nasıl ayrılıyor?
Polling basittir: istemci belirlenen aralıklarla istek gönderir ve yanıtları karşılaştırır. Aralık, gecikme ile istek sıklığı arasında bir denge kurar: dakikada bir kontrol edildiğinde tepki bir sonraki döngüyü bekleyebilir; daha sık kontrol edildiğinde ise isteklerin önemli bir bölümü değişiklik bulamayabilir. GitHub, olay tabanlı seçeneğin gerekçesi olarak tam da bu ikilemi gösteriyor.

Event Streams’te istemci bir pull request’e bir kez abone olur, GitHub’a bağlanır ve açık bağlantı üzerinden olayları bekler. Webhook da olayları iletir; ancak entegrasyonun genellikle herkese açık, gelen istekleri kabul edebilen bir uç noktaya ihtiyacı vardır. Bu nedenle akış, etkileşimli bir istemci veya yerel ajan için; webhook ise gelen istekleri zaten kabul eden bir hizmet için elverişlidir. Hızlı tepkinin önemli olmadığı seyrek kontrollerde polling anlaşılır bir seçenek olmaya devam eder.
Aboneliğin belirli bir kaynağa göre yapılandırılması da pratik açıdan önemlidir. GitHub belgelerinde, depodaki tüm güncellemeleri içeren genel bir akış değil, tek bir pull request’e abone olma rotası açıklanıyor. İşleyicinizi belirli bir pull request’i ve ihtiyaç duyduğu olay türlerini temel alarak tasarlayın.
Yerel bir ajan nasıl çalışabilir?
Pull request’leri incelemeye yardımcı olan bir ajan düşünelim. İnceleme yorumuna ilişkin bir olay geldiğinde ajan güncel verileri alıp geri bildirimleri özetleyebilir; yeni bir commit’ten sonra kontrolleri yeniden çalıştırabilir; istek kapatıldığında veya birleştirildiğinde ise ilişkili görevi tamamlayabilir. Bu, GitHub’ın listelediği olay türlerine dayanan bir kullanım örneğidir; şirketin bu senaryoda test yayımladığı anlamına gelmez.
İşlem sırası önemlidir: olay, bir değişiklik gerçekleştiğini bildirir; ardından istemci güncel durumu almak için belirtilen API kaynağına başvurur. Olaylar yinelenebileceği veya sıraları karışık gelebileceği için işleyicinin yinelenen iletileri güvenle karşılaması ve bildirim sırasını değişikliklerin eksiksiz geçmişi saymak yerine API üzerinden durumu doğrulaması gerekir.
Hangi sınırlamalar göz önünde bulundurulmalı?
18 Kasım 2026 itibarıyla Event Streams, waitlist üzerinden yapılan başvuru onaylandıktan sonra tüm GitHub planlarında preview olarak kullanılabiliyor. Erişim belirli bir hesap için etkinleştiriliyor; dolayısıyla her kullanıcıda otomatik olarak açılmıyor. Belgelerde ayrıca özelliğin GitHub.com’da kullanılabildiği, ancak şimdilik GHE.com’da kullanılamadığı belirtiliyor.
Abonelik tek bir pull request’i kapsıyor ve oluşturulduktan 24 saat sonra sona eriyor. Akış; bağlantı kurulmadan önce, abonelik oluşturulduktan sonraki kısa aralıkta veya bağlantı koptuğunda gerçekleşen olayları yeniden oynatmıyor. GitHub, abonelikten sonra pull request’in güncel durumunun bir kez alınmasını; yinelenen ve sırası karışık olaylarda ise API verilerinin esas alınmasını öneriyor. Pratikte bu, ajanın yalnızca açık bir bağlantıya güvenmemesi; yeniden bağlanma ve durumu eşitleme işlemlerini de yapması gerektiği anlamına geliyor.
Preview sürümünde pull request olayları kullanılabiliyor; belgeler mevcut olay kümesini ve API’de, olay türlerinde ya da limitlerde olası değişiklikleri açıklıyor. Otomasyonunuz başka depo olaylarına veya garantili sunucu tarafı teslimata ihtiyaç duyuyorsa akışın bunları kapsayıp kapsamadığını kontrol edin; aksi durumda webhook ya da API üzerinden kontrol kullanın.
Herkese açık sunucu kurmadan pull request olaylarına tepki vermesi gereken yerel bir ajan için Event Streams, sık istekler yerine doğrudan bir olay kanalı sunuyor. Bunun karşılığında tek bir istek için geçici abonelik kullanmak ve kaçırılan olaylardan sonra güncel durumu yeniden eşitlemek gerekiyor. Seyrek kontroller için polling kullanışlı olmaya devam eder; kendi adreslerine teslimat gereken sunucu entegrasyonları ise webhook üzerine kurulabilir.