Wie kann ein Agent erfahren, dass es in einem Pull Request eine neue Bewertung gibt, ohne GitHub jede Minute abzufragen und vom Nutzer einen öffentlichen Server zu verlangen? Am 17. November 2026 stellte GitHub Event Streams als Preview bereit: Ein Client abonniert einen Pull Request, hält die Verbindung zu GitHub offen und empfängt Ereignisse, sobald sie auftreten.

Die praktische Neuerung betrifft lokale Agenten und Automatisierungen, die auf Repository-Aktualisierungen reagieren müssen. Ohne eigenen Webhook-Empfänger ist das regelmäßige Abfragen der API die übliche Methode, Änderungen zu verfolgen: Häufige Anfragen verbrauchen das Kontingent, seltene verzögern die Reaktion. Ein Ereignisstrom ermöglicht es, die Verarbeitung durch ein Änderungssignal statt durch eine zeitgesteuerte Prüfung auszulösen.
Welche Ereignisse ein Abonnent empfängt
Die Dokumentation zu Event Streams führt Ereignisse für Pull Requests auf: das Einreichen einer Bewertung, einen neuen Commit, einen Merge-Konflikt, das Zusammenführen oder Schließen eines Pull Requests sowie Änderungen an der Prüfungsgruppe oder den Abschluss einer einzelnen Prüfung. Die Ereignisse werden über Server-Sent Events (SSE) übertragen; ein öffentlicher Webhook-Endpunkt ist für den Client nicht nötig. Das eignet sich beispielsweise für einen Agenten auf dem Laptop einer Entwicklerin oder eines Entwicklers, der auf eine neue Bewertung oder einen Commit reagieren soll.
Ein Ereignis signalisiert eine Änderung; anschließend ruft der Client die aktuellen Daten über die GitHub-REST-API ab. Eine Benachrichtigung über eine neue Bewertung verweist beispielsweise auf die zugehörige API-Ressource. Über sie lassen sich der aktuelle Stand der Bewertung oder des Pull Requests abrufen, bevor die nächste Aktion gestartet wird.
Wie sich der Ereignisstrom von Polling und Webhooks unterscheidet
Polling ist einfach: Der Client sendet in einem festgelegten Intervall Anfragen und vergleicht die Antworten. Das Intervall bestimmt den Kompromiss zwischen Verzögerung und Anfragehäufigkeit: Bei einer Prüfung pro Minute kann die Reaktion bis zum nächsten Durchlauf warten; bei häufigeren Prüfungen findet ein erheblicher Teil der Anfragen möglicherweise keine Änderungen. GitHub nennt genau diesen Zielkonflikt als Grund für die ereignisbasierte Alternative.

Bei Event Streams erstellt der Client einmalig ein Abonnement für einen Pull Request, verbindet sich mit GitHub und wartet über die offene Verbindung auf Ereignisse. Auch Webhooks übertragen Ereignisse, doch dafür benötigt eine Integration üblicherweise einen öffentlich erreichbaren Empfangs-Endpunkt. Der Ereignisstrom eignet sich daher für einen interaktiven Client oder lokalen Agenten, während Webhooks zu einem Dienst passen, der bereits eingehende Anfragen entgegennimmt. Polling bleibt eine verständliche Option für seltene Prüfungen, bei denen eine schnelle Reaktion nicht wichtig ist.
Eine weitere praktische Konsequenz ist, dass das Abonnement für eine bestimmte Ressource eingerichtet wird. In der GitHub-Dokumentation wird eine Route zum Abonnieren eines einzelnen Pull Requests beschrieben, nicht ein universeller Stream aller Repository-Aktualisierungen. Richten Sie den Handler auf einen konkreten Pull Request und die dafür benötigten Ereignistypen aus.
So könnte ein lokaler Agent funktionieren
Stellen wir uns einen Agenten vor, der bei der Prüfung eines Pull Requests hilft. Tritt ein Ereignis zu einer Bewertung auf, ruft der Agent die aktuellen Daten ab und kann eine Analyse der Anmerkungen vorbereiten; nach einem neuen Commit kann er die Prüfungen erneut ausführen; nach dem Schließen oder Zusammenführen kann er die zugehörige Aufgabe abschließen. Das ist ein Anwendungsbeispiel, das auf den von GitHub aufgeführten Ereignistypen beruht, und kein von GitHub veröffentlichtes Testergebnis für dieses Szenario.
Die genaue Reihenfolge ist wichtig: Das Ereignis meldet, dass eine Änderung stattgefunden hat; anschließend fragt der Client den aktuellen Stand über die angegebene API-Ressource ab. Da Ereignisse wiederholt oder in anderer Reihenfolge eintreffen können, sollte der Handler Wiederholungszustellungen sicher verarbeiten und den Status über die API abgleichen, statt die Reihenfolge der Benachrichtigungen als vollständigen Änderungsverlauf zu behandeln.
Welche Einschränkungen zu beachten sind
Stand 18. November 2026 ist Event Streams nach Genehmigung eines Antrags auf der Warteliste in allen GitHub-Tarifen als Preview verfügbar. Der Zugriff wird für ein bestimmtes Konto aktiviert und steht daher nicht automatisch allen Nutzern zur Verfügung. Laut Dokumentation ist die Funktion auf GitHub.com verfügbar, bislang aber nicht auf GHE.com.
Ein Abonnement gilt für einen einzelnen Pull Request und läuft 24 Stunden nach seiner Erstellung ab. Der Stream gibt keine Ereignisse wieder, die vor dem Verbindungsaufbau, während eines kurzen Zeitraums nach Erstellung des Abonnements oder bei einer Verbindungsunterbrechung aufgetreten sind. GitHub empfiehlt, nach dem Abonnieren einmal den aktuellen Stand des Pull Requests abzurufen und sich bei Wiederholungen und Ereignissen in falscher Reihenfolge auf die API-Daten zu stützen. Praktisch bedeutet das: Der Agent benötigt eine Behandlung von Verbindungsabbrüchen und einen Statusabgleich, nicht nur eine offene Verbindung.
In der Preview sind Pull-Request-Ereignisse verfügbar. Die Dokumentation beschreibt den aktuellen Umfang und weist auf mögliche Änderungen an API, Ereignistypen und Limits hin. Wenn Ihre Automatisierung andere Repository-Ereignisse oder eine garantierte Zustellung an einen Server benötigt, prüfen Sie, ob der Stream diese abdeckt; andernfalls verwenden Sie einen Webhook oder eine API-Abfrage.
Für einen lokalen Agenten, der auf Pull-Request-Ereignisse reagieren muss, ohne einen öffentlichen Server zu betreiben, bietet Event Streams einen direkten Ereigniskanal anstelle häufiger Anfragen. Dafür ist das Abonnement auf einen einzelnen Pull Request beschränkt und der aktuelle Stand muss nach Lücken wiederhergestellt werden. Seltene Prüfungen lassen sich besser mit Polling erledigen; für Serverintegrationen eignen sich Webhooks, wenn die Zustellung an eine eigene Adresse erforderlich ist.