Comment un agent peut-il savoir qu’un nouvel avis a été ajouté à une pull request sans interroger GitHub chaque minute ni demander à l’utilisateur de disposer d’un serveur public ? Le 17 novembre 2026, GitHub a lancé Event Streams en préversion : le client s’abonne à une pull request, maintient une connexion ouverte avec GitHub et reçoit les événements au fur et à mesure qu’ils surviennent.

Ce changement concerne concrètement les agents locaux et les automatisations qui doivent réagir aux mises à jour d’un dépôt. Sans récepteur webhook propriétaire, la méthode habituelle pour suivre les changements consiste à interroger périodiquement l’API : des requêtes fréquentes consomment le quota, tandis que des requêtes espacées retardent la réaction. Un flux d’événements permet de déclencher le traitement à la suite d’un signal de changement, plutôt que de vérifier selon un calendrier.
Quels événements l’abonné reçoit-il ?
La documentation d’Event Streams répertorie les événements liés aux pull requests : soumission d’un avis, nouveau commit, conflit de fusion, fusion ou fermeture de la demande, ainsi que modification de l’ensemble des vérifications ou fin d’une vérification individuelle. Les événements sont transmis par Server-Sent Events (SSE) ; le client n’a pas besoin d’un endpoint webhook public. Cette solution convient, par exemple, à un agent sur l’ordinateur portable d’un développeur qui doit réagir à un nouvel avis ou à un nouveau commit.
L’événement signale un changement, puis le client récupère les données à jour via l’API REST de GitHub. Ainsi, une notification concernant un nouvel avis pointe vers la ressource API associée ; le client peut s’en servir pour charger l’état actuel de l’avis ou de la pull request avant de lancer l’action suivante.
Différences entre flux, polling et webhook
Le polling est simple : le client envoie des requêtes à intervalles définis et compare les réponses. L’intervalle impose un compromis entre délai et fréquence des requêtes : avec une vérification chaque minute, la réaction peut attendre le cycle suivant, tandis qu’une vérification plus fréquente peut produire de nombreuses requêtes sans détecter de changement. GitHub présente précisément ce dilemme comme une raison d’opter pour une approche événementielle.

Avec Event Streams, le client crée une fois un abonnement à une pull request, se connecte à GitHub et attend les événements sur une connexion ouverte. Un webhook transmet lui aussi des événements, mais les intégrations nécessitent généralement un endpoint de réception accessible publiquement. Le flux est donc pratique pour un client interactif ou un agent local, tandis que le webhook convient à un service qui reçoit déjà des requêtes entrantes. Le polling reste une option simple pour les vérifications peu fréquentes qui ne nécessitent pas de réaction rapide.
Autre conséquence pratique : l’abonnement porte sur une ressource précise. La documentation GitHub décrit un parcours d’abonnement à une seule pull request, et non un flux universel de toutes les mises à jour du dépôt. Concevez le gestionnaire autour d’une demande de fusion précise et des types d’événements dont il a besoin.
Comment un agent local peut fonctionner
Imaginons un agent qui aide à examiner les pull requests. Lorsqu’un événement signale un avis, l’agent récupère les données à jour et peut préparer l’analyse des remarques ; après un nouveau commit, il peut relancer les vérifications ; après la fermeture ou la fusion, il peut terminer la tâche associée. Il s’agit d’un exemple d’utilisation fondé sur les types d’événements répertoriés par GitHub, et non du résultat publié par l’entreprise d’un test de ce scénario.
L’ordre des opérations est important : l’événement signale qu’un changement s’est produit, puis le client consulte la ressource API indiquée pour obtenir l’état actuel. Comme les événements peuvent être répétés ou arriver dans le désordre, le gestionnaire devrait tolérer les livraisons répétées et vérifier l’état via l’API, plutôt que de considérer l’ordre des notifications comme un historique complet des changements.
Quelles limites faut-il prendre en compte ?
Au 18 novembre 2026, Event Streams est disponible en préversion sur tous les forfaits GitHub, après approbation d’une demande inscrite sur la liste d’attente. L’accès est activé pour un compte précis et n’apparaît donc pas automatiquement pour tous les utilisateurs. La documentation précise également que la fonctionnalité est disponible sur GitHub.com, mais pas encore sur GHE.com.
L’abonnement couvre une seule pull request et expire 24 heures après sa création. Le flux ne rejoue pas les événements survenus avant la connexion, pendant un court intervalle suivant la création de l’abonnement ou lors d’une interruption de connexion. GitHub recommande de récupérer une fois l’état actuel de la pull request après l’abonnement et, en cas d’événements répétés ou reçus dans le désordre, de s’appuyer sur les données de l’API. En pratique, l’agent doit donc gérer les reconnexions et vérifier l’état, plutôt que de se contenter de maintenir une connexion ouverte.
La préversion propose des événements de pull request ; la documentation décrit l’ensemble actuellement disponible et signale que l’API, les types d’événements et les limites peuvent évoluer. Si l’automatisation a besoin d’autres événements du dépôt ou d’une livraison garantie côté serveur, vérifiez si le flux les couvre ; sinon, utilisez un webhook ou des vérifications via l’API.
Pour un agent local qui doit réagir aux événements d’une pull request sans serveur public, Event Streams fournit un canal événementiel direct, au lieu de requêtes fréquentes. En contrepartie, l’abonnement temporaire porte sur une seule demande et il faut rétablir l’état à jour après des événements manqués. Le polling convient mieux aux vérifications peu fréquentes, tandis que les intégrations côté serveur peuvent s’appuyer sur des webhooks lorsqu’elles doivent recevoir les événements à leur propre adresse.