jsonscraper
시장
저널로 돌아가기

GitHub Event Streams는 잦은 폴링 대신 pull request 이벤트로 에이전트를 깨운다

이벤트 스트림이 GitHub와 로컬 에이전트 간 통신을 바꾸는 방식과 현재 프리뷰에서 제공되는 이벤트

편집 정책 오류 제보

pull request에 새 리뷰가 달렸다는 사실을 매분 GitHub에 묻거나 사용자에게 공개 서버를 요구하지 않고 에이전트가 알아내려면 어떻게 해야 할까요? GitHub는 2026년 11월 17일 Event Streams를 프리뷰로 공개했습니다. 클라이언트는 pull request를 구독하고 GitHub와 연결을 열린 상태로 유지하며 이벤트가 발생할 때마다 받습니다.

기사: GitHub Event Streams는 잦은 폴링 대신 pull request 이벤트로 에이전트를 깨운다
요약: 2026년 11월 17일, GitHub가 Event Streams를 프리뷰로 공개했습니다. 에이전트는 일정에 따라 GitHub를 폴링하거나 공개 웹훅 서버를 운영하지 않고도 지속 연결을 통해 pull request 이벤트를 받을 수 있습니다.
이미지 역할: 표지 — 핵심 아이디어
섹션: 
시각적 주제: 로컬 소프트웨어 개발 워크스테이션이 가느다란 데이터 스트림을 통해 추상적인 pull request와 연결된 에디토리얼 사진 일러스트
이벤트 스트림은 공개 웹훅 서버 없이 pull request 업데이트를 로컬 에이전트에 전달합니다.© jsonscraper · AI 생성

실질적인 변화는 저장소 업데이트에 반응해야 하는 로컬 에이전트와 자동화에 있습니다. 자체 웹훅 수신기가 없다면 변경 사항을 확인하는 일반적인 방법은 API를 주기적으로 폴링하는 것입니다. 요청을 자주 보내면 사용량 한도를 소모하고, 드물게 보내면 반응이 늦어집니다. 이벤트 스트림을 이용하면 타이머에 따라 확인하는 대신 변경 신호를 받아 처리를 시작할 수 있습니다.

구독자가 받는 이벤트

Event Streams 문서에는 pull request와 관련된 이벤트가 나열되어 있습니다. 리뷰 제출, 새 커밋, 병합 충돌, 요청의 병합 또는 종료, 그리고 검사 세트 변경이나 개별 검사의 완료 등이 포함됩니다. 이벤트는 Server-Sent Events(SSE)로 전달되므로 클라이언트에 공개 웹훅 엔드포인트가 필요하지 않습니다. 예를 들어 개발자의 노트북에서 실행되며 새 리뷰나 커밋에 반응해야 하는 에이전트에 적합합니다.

이벤트는 변경을 알리는 신호 역할을 하고, 클라이언트는 이후 GitHub REST API를 통해 최신 데이터를 가져옵니다. 예를 들어 새 리뷰 알림은 해당 리뷰와 연결된 API 리소스를 가리킵니다. 이를 이용해 다음 작업을 시작하기 전에 리뷰나 pull request의 최신 상태를 가져올 수 있습니다.

스트림은 폴링 및 웹훅과 어떻게 다른가

폴링은 간단합니다. 클라이언트가 정해진 간격으로 요청을 보내고 응답을 비교합니다. 간격은 지연 시간과 요청 빈도 사이의 절충점을 결정합니다. 1분에 한 번 확인하면 다음 주기까지 반응이 늦어질 수 있고, 더 자주 확인하면 상당수 요청에서 변경 사항을 찾지 못할 수 있습니다. GitHub는 이벤트 기반 방식을 도입한 이유로 바로 이 절충을 들고 있습니다.

기사: GitHub Event Streams는 잦은 폴링 대신 pull request 이벤트로 에이전트를 깨운다
요약: 2026년 11월 17일, GitHub가 Event Streams를 프리뷰로 공개했습니다. 에이전트는 일정에 따라 GitHub를 폴링하거나 공개 웹훅 서버를 운영하지 않고도 지속 연결을 통해 pull request 이벤트를 받을 수 있습니다.
이미지 역할: 보조 일러스트 2 — 다른 구체적 측면
섹션: 스트림은 폴링 및 웹훅과 어떻게 다른가
시각적 주제: 러시아어 인포그래픽: pull 방식으로 업데이트를 받는 세 가지 방법
이 그림은 폴링, 웹훅, Event Streams에서 연결 방향과 업데이트 전달 방식을 보여줍니다.© jsonscraper · AI 생성 일러스트

Event Streams를 사용하면 클라이언트는 pull request를 한 번 구독하고 GitHub에 연결한 뒤 열린 연결을 통해 이벤트를 기다립니다. 웹훅도 이벤트를 전달하지만, 보통 이를 사용하는 통합에는 공개적으로 접근 가능한 수신 엔드포인트가 필요합니다. 따라서 스트림은 대화형 클라이언트나 로컬 에이전트에 편리하고, 웹훅은 이미 수신 요청을 처리하는 서비스에 적합합니다. 빠른 반응이 필요하지 않은 드문 확인에는 폴링이 여전히 이해하기 쉬운 선택입니다.

구독 설정과 관련해 주목할 점은 특정 리소스를 대상으로 한다는 것입니다. GitHub 문서에는 저장소의 모든 업데이트를 아우르는 범용 피드가 아니라 단일 pull request를 구독하는 경로가 설명되어 있습니다. 필요한 이벤트 유형과 해당 pull request를 중심으로 핸들러를 설계하세요.

로컬 에이전트의 작동 방식

pull request 검토를 돕는 에이전트를 생각해 봅시다. 리뷰 이벤트가 발생하면 에이전트는 최신 데이터를 받아 의견을 검토할 수 있습니다. 새 커밋이 올라오면 검사를 다시 실행하고, 요청이 닫히거나 병합되면 관련 작업을 마칠 수 있습니다. 이는 GitHub가 나열한 이벤트 유형에 기반한 활용 예시이며, 회사가 이러한 시나리오를 테스트해 공개한 결과는 아닙니다.

정확한 처리 순서가 중요합니다. 이벤트는 변경이 발생했음을 알리고, 클라이언트는 이어서 지정된 API 리소스에서 현재 상태를 가져옵니다. 이벤트가 중복되거나 순서가 뒤바뀌어 도착할 수 있으므로, 핸들러는 재전달을 안전하게 처리하고 알림 순서를 변경 이력 전체로 간주하는 대신 API를 통해 상태를 대조해야 합니다.

GitHub가 열린 연결을 통해 이벤트를 전달하면 로컬 클라이언트는 pull request의 최신 상태를 가져와 적절한 핸들러를 실행합니다.

고려해야 할 제약

2026년 11월 18일 기준으로 Event Streams는 대기자 명단에서 신청이 승인된 뒤 모든 GitHub 요금제에서 프리뷰로 사용할 수 있습니다. 계정별로 기능을 활성화하므로 모든 사용자에게 자동으로 제공되지는 않습니다. 문서에 따르면 GitHub.com에서는 사용할 수 있지만 GHE.com에서는 아직 지원되지 않습니다.

구독은 단일 pull request를 대상으로 하며 생성 후 24시간이 지나면 만료됩니다. 스트림은 연결 전, 구독 생성 직후의 짧은 시간 동안 또는 연결이 끊긴 동안 발생한 이벤트를 재생하지 않습니다. GitHub는 구독 후 pull request의 최신 상태를 한 번 가져오고, 이벤트가 중복되거나 순서가 뒤바뀌면 API 데이터에 의존할 것을 권장합니다. 실무적으로는 에이전트가 열린 연결뿐 아니라 재연결 처리와 상태 대조도 구현해야 한다는 뜻입니다.

프리뷰에서는 pull request 이벤트를 사용할 수 있습니다. 문서에는 현재 이벤트 집합과 함께 API, 이벤트 유형, 한도가 변경될 수 있다는 내용도 나와 있습니다. 자동화에 다른 저장소 이벤트나 보장된 서버 측 전달이 필요하다면 스트림이 이를 지원하는지 확인하세요. 그렇지 않다면 웹훅이나 API 기반 확인을 사용하면 됩니다.

공개 서버 없이 pull request 이벤트에 반응해야 하는 로컬 에이전트에 Event Streams는 잦은 요청을 대신할 직접적인 이벤트 채널을 제공합니다. 다만 구독은 한 pull request에 한정되고, 누락 이후 최신 상태를 복구해야 합니다. 드문 확인에는 폴링을 사용하고, 자체 주소로 이벤트를 전달받아야 하는 서버 통합에는 웹훅을 이용하는 편이 좋습니다.

사람들

아직 이 기사에 등록된 사람이 없습니다.

계속 읽으세요GitHub, Copilot을 클라우드 샌드박스 및 Actions 공용 컴퓨팅 한도와 연결
다음 기사 읽기

읽은 내용을 실제 연동으로 구현하세요

jsonscraper 소셜 데이터 API를 살펴보고 요청을 테스트하여 다음 워크플로를 구축하세요.

API 둘러보기