Skąd agent ma wiedzieć, że w pull request pojawiła się nowa recenzja, bez pytania GitHuba co minutę i bez wymagania od użytkownika publicznego serwera? 17 listopada 2026 roku GitHub udostępnił Event Streams w wersji preview: klient subskrybuje pull request, utrzymuje otwarte połączenie z GitHubem i odbiera zdarzenia w miarę ich pojawiania się.

Praktyczna zmiana dotyczy lokalnych agentów i automatyzacji, które muszą reagować na aktualizacje repozytorium. Bez własnego odbiornika webhooków zwykłym sposobem śledzenia zmian jest okresowe odpytywanie API: częste żądania zużywają limit, a rzadkie opóźniają reakcję. Strumień zdarzeń pozwala uruchamiać obsługę po sygnale o zmianie zamiast sprawdzania jej według harmonogramu.
Jakie zdarzenia otrzymuje subskrybent
W dokumentacji Event Streams wymieniono zdarzenia dotyczące pull request: przesłanie recenzji, nowy commit, konflikt scalania, scalenie lub zamknięcie zgłoszenia, a także zmianę zestawu kontroli lub zakończenie pojedynczej kontroli. Zdarzenia są przesyłane przez Server-Sent Events (SSE); klient nie potrzebuje publicznego endpointu webhooków. Rozwiązanie sprawdzi się na przykład w przypadku agenta na laptopie programisty, który ma reagować na nową recenzję lub commit.
Zdarzenie sygnalizuje zmianę, a klient następnie pobiera aktualne dane przez GitHub REST API. Na przykład powiadomienie o nowej recenzji wskazuje powiązany z nią zasób API; można za jego pomocą pobrać aktualny stan recenzji lub pull request przed uruchomieniem kolejnego działania.
Czym strumień różni się od pollingu i webhooków
Polling jest prosty: klient wysyła żądania w określonych odstępach i porównuje odpowiedzi. Częstotliwość sprawdzania stanowi kompromis między opóźnieniem a liczbą żądań: przy sprawdzaniu raz na minutę reakcja może czekać do następnego cyklu, a częstsze sprawdzanie może generować wiele żądań, które nie wykryją żadnych zmian. GitHub wskazuje właśnie ten dylemat jako powód wprowadzenia wariantu opartego na zdarzeniach.

W Event Streams klient tworzy subskrypcję pull request, łączy się z GitHubem i oczekuje na zdarzenia przez otwarte połączenie. Webhook również przekazuje zdarzenia, ale integracja zwykle wymaga publicznie dostępnego endpointu odbierającego. Dlatego strumień jest wygodny dla interaktywnego klienta lub lokalnego agenta, a webhook — dla usługi, która już przyjmuje żądania przychodzące. Polling pozostaje zrozumiałym rozwiązaniem w przypadku rzadkich sprawdzeń, przy których szybka reakcja nie jest ważna.
Osobną praktyczną konsekwencją jest konfiguracja subskrypcji dla konkretnego zasobu. Dokumentacja GitHuba opisuje trasę subskrypcji jednego pull request, a nie uniwersalny strumień wszystkich aktualizacji repozytorium. Zaprojektuj obsługę wokół konkretnego pull request i tych typów zdarzeń, których potrzebujesz.
Jak może działać lokalny agent
Wyobraźmy sobie agenta, który pomaga analizować pull request. Gdy pojawi się zdarzenie dotyczące recenzji, agent pobiera aktualne dane i może przygotować analizę uwag; po nowym commicie — ponowić kontrole; po zamknięciu lub scaleniu — zakończyć powiązane zadanie. To przykład zastosowania oparty na wymienionych przez GitHub typach zdarzeń, a nie opublikowany przez firmę wynik testu takiego scenariusza.
Ważna jest kolejność: zdarzenie informuje o zmianie, po czym klient odpytuje wskazany zasób API o aktualny stan. Ponieważ zdarzenia mogą się powtarzać lub przychodzić w innej kolejności, obsługa powinna bezpiecznie tolerować ponowne dostarczenie i sprawdzać stan przez API, zamiast traktować kolejność powiadomień jako pełną historię zmian.
Jakie ograniczenia należy wziąć pod uwagę
Na dzień 18 listopada 2026 roku Event Streams jest dostępny w wersji preview we wszystkich planach GitHub po zatwierdzeniu zgłoszenia z listy oczekujących. Dostęp jest włączany dla konkretnego konta, więc nie pojawia się automatycznie u każdego użytkownika. Dokumentacja precyzuje również, że funkcja jest dostępna na GitHub.com, ale na razie nie na GHE.com.
Subskrypcja obejmuje jeden pull request i wygasa 24 godziny po utworzeniu. Strumień nie odtwarza zdarzeń, które wystąpiły przed połączeniem, w krótkim okresie po utworzeniu subskrypcji ani podczas przerwy w połączeniu. GitHub zaleca, by po subskrypcji jednorazowo pobrać aktualny stan pull request, a w przypadku powtórzeń i zdarzeń przychodzących w innej kolejności opierać się na danych z API. W praktyce oznacza to, że agent potrzebuje obsługi ponownych połączeń i synchronizacji stanu, a nie tylko otwartego połączenia.
W wersji preview dostępne są zdarzenia pull request; dokumentacja opisuje obecny zestaw oraz możliwe zmiany API, typów zdarzeń i limitów. Jeśli automatyzacja potrzebuje innych zdarzeń repozytorium lub gwarantowanego dostarczania po stronie serwera, sprawdź, czy strumień je obejmuje; w przeciwnym razie użyj webhooka albo sprawdzania przez API.
W przypadku lokalnego agenta, który ma reagować na zdarzenia pull request bez publicznego serwera, Event Streams zapewnia bezpośredni kanał zdarzeń zamiast częstych żądań. Ceną jest czasowa subskrypcja jednego zgłoszenia oraz konieczność odtworzenia aktualnego stanu po pominiętych zdarzeniach. Rzadkie sprawdzenia lepiej pozostawić przy pollingu, a integracje serwerowe oprzeć na webhookach, jeśli wymagają dostarczania na własny adres.