pull requestに新しいレビューが付いたことを、毎分GitHubに問い合わせたり、ユーザーに公開サーバーを用意してもらったりせずに、エージェントが知るにはどうすればよいでしょうか。GitHubは2026年11月17日にEvent Streamsをプレビュー公開しました。クライアントがpull requestを購読し、GitHubとの接続を開いたままにすると、イベントの発生に応じて通知を受け取れます。

実用面での変化は、リポジトリの更新に反応する必要があるローカルエージェントや自動化に関わります。独自のWebhook受信先を持たない場合、変更を追う一般的な方法はAPIを定期的にポーリングすることです。頻繁なリクエストはレート制限を消費し、間隔が長いと反応が遅れます。イベントストリームなら、タイマーによる確認ではなく、変更の通知をきっかけに処理を開始できます。
購読者が受け取るイベント
Event Streamsのドキュメントには、pull requestに関するイベントとして、レビューの送信、新しいコミット、マージコンフリクト、pull requestのマージまたはクローズ、チェック群の変更、個別チェックの完了が挙げられています。イベントはServer-Sent Events(SSE)で送られるため、クライアント用の公開Webhookエンドポイントは不要です。たとえば、開発者のノートPC上で、新しいレビューやコミットに反応するエージェントに適しています。
イベントは変更の通知として機能し、その後クライアントがGitHub REST APIから最新のデータを取得します。たとえば、新しいレビューの通知には関連するAPIリソースが示されます。そのリソースを使ってレビューまたはpull requestの最新状態を読み込み、次の処理を開始できます。
ポーリングやWebhookとの違い
ポーリングは単純です。クライアントが一定間隔でリクエストを送り、応答を比較します。間隔によって遅延とリクエスト頻度のバランスが決まります。1分ごとの確認では次のサイクルまで反応が遅れる可能性があり、より頻繁に確認すると、変更を検出しないリクエストが多くなることがあります。GitHubは、このトレードオフをイベント方式を設けた理由として挙げています。

Event Streamsでは、クライアントがpull requestの購読を一度設定してGitHubに接続し、開いた接続上でイベントを待ちます。Webhookもイベントを配信しますが、通常、連携には公開アクセス可能な受信エンドポイントが必要です。そのため、対話型クライアントやローカルエージェントにはストリームが便利で、Webhookは受信リクエストを処理する既存のサービスに適しています。すぐに反応する必要のない低頻度の確認には、ポーリングが分かりやすい選択肢です。
もう一つの実用上のポイントは、特定のリソースへの購読を設定することです。GitHubのドキュメントで説明されているのは、リポジトリ全体の更新を網羅する汎用フィードではなく、1つのpull requestに対する購読経路です。対象のpull requestと、必要なイベントの種類を中心にハンドラーを設計してください。
ローカルエージェントの動作例
pull requestのレビューを支援するエージェントを考えてみましょう。レビューイベントが発生したら最新データを取得して指摘の整理を準備し、新しいコミットがあればチェックを再実行できます。pull requestがクローズまたはマージされたら、関連タスクを完了できます。これはGitHubが挙げるイベントの種類をもとにした利用例であり、同社がこのシナリオをテストしたと公表しているわけではありません。
処理の順序が重要です。イベントは変更が起きたことを知らせ、その後クライアントが指定されたAPIリソースにアクセスして現在の状態を取得します。イベントが重複したり順不同で届いたりする可能性があるため、ハンドラーは再配信に耐えられるようにし、通知の順序を完全な変更履歴とみなさず、APIで状態を照合するのが望ましいでしょう。
考慮すべき制限
2026年11月18日時点で、Event Streamsはウェイトリストから申請して承認されれば、GitHubのすべてのプランでプレビュー利用できます。アクセスはアカウント単位で有効化されるため、すべてのユーザーに自動で提供されるわけではありません。ドキュメントによると、利用できるのはGitHub.comで、現時点ではGHE.comには対応していません。
購読できるのは1つのpull requestで、作成から24時間後に期限切れとなります。接続前、購読を作成してから接続するまでの短い間隔、または接続が切れている間に発生したイベントは、ストリームから再生されません。GitHubは、購読後にpull requestの最新状態を一度取得し、重複や順不同のイベントにはAPIのデータをもとに対処するよう推奨しています。つまり、エージェントには開いた接続だけでなく、再接続処理と状態の照合も必要です。
プレビューではpull requestのイベントを利用できます。ドキュメントには現行のイベント一覧が記載されている一方、API、イベントの種類、制限が変更される可能性も示されています。自動化に別のリポジトリイベントや、サーバーへの確実な配信が必要なら、ストリームで対応できるか確認してください。対応できない場合は、WebhookまたはAPIによる確認を利用します。
公開サーバーなしでpull requestのイベントに反応したいローカルエージェントにとって、Event Streamsは頻繁なリクエストに代わる直接的なイベント経路です。その代わり、購読は1つのpull requestに対する一時的なものであり、イベントを取りこぼした後は最新状態を復元する必要があります。低頻度の確認にはポーリングを使い続け、独自の受信先への配信が必要なサーバー連携にはWebhookを使うのが適しています。