Miten agentti voi saada tiedon uudesta pull request -arviosta kysymättä GitHubilta minuutin välein tai vaatimatta käyttäjältä julkista palvelinta? GitHub avasi Event Streams -palvelun esikatseluun 17. marraskuuta 2026: asiakasohjelma tilaa pull requestin tapahtumat, pitää yhteyden GitHubiin auki ja vastaanottaa tapahtumat niiden ilmetessä.

Käytännön muutos koskee paikallisia agentteja ja automaatioita, joiden on reagoitava tietovaraston päivityksiin. Ilman omaa webhook-vastaanotinta tavallinen tapa seurata muutoksia on API:n säännöllinen kysely: tiheät pyynnöt kuluttavat kyselykiintiötä, harvat taas viivästyttävät reagointia. Tapahtumavirta käynnistää käsittelyn muutosilmoituksesta ajastetun tarkistuksen sijaan.
Mitä tapahtumia tilaaja vastaanottaa
Event Streams -dokumentaatiossa luetellaan pull requesteihin liittyvät tapahtumat: arvion lähettäminen, uusi commit, yhdistämisristiriita, pyynnön yhdistäminen tai sulkeminen sekä tarkistusten joukon muuttuminen tai yksittäisen tarkistuksen valmistuminen. Tapahtumat välitetään Server-Sent Events (SSE) -tekniikalla; asiakasohjelma ei tarvitse julkista webhook-rajapintaa. Tämä sopii esimerkiksi kehittäjän kannettavassa tietokoneessa toimivalle agentille, jonka on reagoitava uuteen arvioon tai commitiin.
Tapahtuma ilmoittaa muutoksesta, minkä jälkeen asiakasohjelma hakee ajantasaiset tiedot GitHub REST APIsta. Uutta arviota koskeva ilmoitus viittaa esimerkiksi siihen liittyvään API-resurssiin; sen avulla voidaan hakea arvion tai pull requestin ajantasainen tila ennen seuraavan toiminnon käynnistämistä.
Miten tapahtumavirta eroaa pollingista ja webhookista
Polling on yksinkertainen: asiakasohjelma lähettää pyyntöjä määrätyin väliajoin ja vertaa vastauksia. Aikaväli määrittää viiveen ja pyyntötiheyden välisen kompromissin: kerran minuutissa tehtävässä tarkistuksessa reaktio voi odottaa seuraavaa kierrosta, kun taas tiheämmässä tarkistuksessa suuri osa pyynnöistä ei välttämättä löydä muutoksia. GitHub mainitsee juuri tämän tasapainottelun syyksi tapahtumapohjaisen vaihtoehdon tarjoamiseen.

Event Streamsissä asiakasohjelma luo kerran pull request -tilauksen, muodostaa yhteyden GitHubiin ja odottaa tapahtumia avoimen yhteyden kautta. Myös webhook välittää tapahtumia, mutta integraatio tarvitsee yleensä julkisesti saavutettavan vastaanottavan rajapinnan. Siksi tapahtumavirta sopii interaktiiviseen asiakasohjelmaan tai paikalliseen agenttiin, kun taas webhook sopii palveluun, joka ottaa jo vastaan saapuvia pyyntöjä. Polling on edelleen selkeä vaihtoehto harvoihin tarkistuksiin, joissa nopealla reagoinnilla ei ole merkitystä.
Yksi käytännön seuraus on tilauksen rajaaminen tiettyyn resurssiin. GitHubin dokumentaatiossa kuvataan reitti yhden pull requestin tilaamiseen, ei yleistä tietovaraston kaikkien päivitysten syötettä. Suunnittele käsittelijä tietyn pull requestin ja sille tarvittavien tapahtumatyyppien ympärille.
Miten paikallinen agentti voisi toimia
Kuvitellaan agentti, joka auttaa pull requestien käsittelyssä. Kun arviointia koskeva tapahtuma saapuu, agentti hakee ajantasaiset tiedot ja voi valmistella huomioiden analyysin; uuden commitin jälkeen se voi suorittaa tarkistukset uudelleen; sulkemisen tai yhdistämisen jälkeen se voi päättää siihen liittyvän tehtävän. Tämä on esimerkki mahdollisesta käyttötavasta, joka perustuu GitHubin luettelemiin tapahtumatyyppeihin, ei yrityksen julkaisemaan testitulokseen tällaisesta tilanteesta.
Tarkalla järjestyksellä on merkitystä: tapahtuma kertoo, että muutos on tapahtunut, minkä jälkeen asiakasohjelma hakee nykyisen tilan ilmoitetusta API-resurssista. Koska tapahtumat voivat toistua tai saapua väärässä järjestyksessä, käsittelijän kannattaa sietää uudelleenlähetyksiä turvallisesti ja tarkistaa tila APIsta sen sijaan, että ilmoitusten järjestystä pidettäisiin täydellisenä muutoshistoriana.
Huomioitavat rajoitukset
18. marraskuuta 2026 Event Streams on esikatselussa saatavilla kaikilla GitHub-tilauspaketeilla odotuslistalta saadun hyväksynnän jälkeen. Käyttöoikeus otetaan käyttöön tietylle tilille, joten ominaisuus ei ilmesty automaattisesti kaikille käyttäjille. Dokumentaatiossa täsmennetään myös, että ominaisuus on saatavilla GitHub.comissa mutta ei vielä GHE.comissa.
Tilaus kattaa yhden pull requestin ja vanhenee 24 tuntia luomisen jälkeen. Tapahtumavirta ei toista tapahtumia, jotka ovat syntyneet ennen yhteyden muodostamista, lyhyen tilauksen luomisen jälkeisen ajan kuluessa tai yhteyden katketessa. GitHub suosittelee hakemaan pull requestin ajantasaisen tilan kerran tilauksen jälkeen ja tukeutumaan API-tietoihin, jos tapahtumia toistuu tai ne saapuvat väärässä järjestyksessä. Käytännössä agentti tarvitsee siis uudelleenyhdistämisen käsittelyn ja tilan täsmäytyksen, ei vain avointa yhteyttä.
Esikatselussa käytettävissä ovat pull request -tapahtumat; dokumentaatiossa kuvataan nykyinen valikoima sekä mahdolliset muutokset APIin, tapahtumatyyppeihin ja rajoihin. Jos automaatio tarvitsee muita tietovaraston tapahtumia tai taatun palvelinpuolen toimituksen, tarkista, kattaako tapahtumavirta tarpeen; muussa tapauksessa käytä webhookia tai API-tarkistusta.
Paikalliselle agentille, jonka on reagoitava pull request -tapahtumiin ilman julkista palvelinta, Event Streams tarjoaa suoran tapahtumakanavan tiheiden pyyntöjen sijaan. Vastapainona on määräaikainen, yhteen pyyntöön rajattu tilaus ja tarve palauttaa ajantasainen tila, jos tapahtumia jää väliin. Harvat tarkistukset kannattaa jättää pollingille, ja palvelinintegraatiot rakentaa webhookien varaan, jos ne tarvitsevat toimituksen omaan osoitteeseen.