如果不想每分钟都向 GitHub 查询,也不想要求用户搭建公开服务器,智能体怎样才能知道拉取请求中出现了新评审?2026年11月17日,GitHub 开放了 Event Streams 预览版:客户端订阅某个拉取请求,与 GitHub 保持连接,并在事件出现时接收通知。

这项变化对需要响应代码仓库更新的本地智能体和自动化流程尤为实用。没有自己的 webhook 接收端时,常见的跟踪方式是定期轮询 API:请求过于频繁会消耗限额,间隔太长则会延迟响应。事件流可以在收到变更信号时启动处理,而不是按计时器检查。
订阅者可以接收哪些事件
Event Streams 文档列出了拉取请求相关事件:提交评审、新提交、合并冲突、合并或关闭请求、检查项集合发生变化,以及单项检查完成。事件通过服务器发送事件(SSE)传递;客户端不需要公开的 webhook endpoint。例如,开发者笔记本上的智能体可以借此响应新评审或新提交。
事件只是变更信号,客户端随后会通过 GitHub REST API 获取最新数据。例如,新评审通知会指向与之关联的 API 资源;客户端可以通过该资源加载评审或拉取请求的当前状态,再执行下一步操作。
事件流与轮询、webhook 有何不同
轮询很简单:客户端按设定的间隔发送请求,并比较响应。轮询间隔需要在延迟和请求频率之间权衡:每分钟检查一次,响应可能要等到下一轮;检查得更频繁,则大量请求可能都发现不了任何变化。GitHub 正是以这种权衡说明了采用事件驱动方案的理由。

使用 Event Streams 时,客户端只需为某个拉取请求创建一次订阅,连接到 GitHub,然后通过保持开放的连接等待事件。Webhook 同样会传递事件,但集成通常需要一个可从公网访问的接收 endpoint。因此,事件流适合交互式客户端或本地智能体;webhook 则适合已经能够接收传入请求的服务。对于不常执行、且不要求快速响应的检查,轮询仍然是直接易懂的选择。
另一个实际影响是,订阅需要针对特定资源进行配置。GitHub 文档介绍的是订阅单个拉取请求的路由,而不是涵盖代码仓库所有更新的通用信息流。设计处理程序时,应围绕具体的拉取请求及其所需的事件类型进行构建。
本地智能体可以如何工作
设想一个帮助处理拉取请求的智能体。出现评审事件时,它获取最新数据并准备整理意见;有新提交时,它重新运行检查;请求关闭或合并后,它结束相关任务。这只是根据 GitHub 列出的事件类型构想的一种应用,并非该公司公布的场景测试结果。
操作顺序很重要:事件通知变更已经发生,客户端随后通过指定的 API 资源获取当前状态。事件可能重复或乱序到达,因此处理程序应能够安全地应对重复投递,并通过 API 核对状态,而不是把通知顺序视为完整的变更历史。
需要注意的限制
截至2026年11月18日,Event Streams 已在所有 GitHub 套餐中开放预览版,但需先提交 waitlist 申请并获批准。该功能按具体账户启用,因此不会自动向每位用户开放。文档还说明,此功能目前可在 GitHub.com 上使用,但尚未支持 GHE.com。
每个订阅仅涵盖一个拉取请求,并会在创建24小时后过期。该事件流不会补发连接前发生的事件、订阅创建后短暂间隔期间发生的事件,或连接中断期间发生的事件。GitHub 建议在订阅后立即获取一次拉取请求的最新状态;遇到重复或乱序事件时,应以 API 数据为准。实际而言,智能体需要处理重连并核对状态,而不能只依赖保持开放的连接。
预览版目前支持拉取请求事件;文档介绍了现有事件类型,也说明 API、事件类型和限额可能发生变化。如果自动化流程还需要其他代码仓库事件,或需要保证服务端投递,请确认事件流是否满足要求;否则应使用 webhook 或 API 检查。
对于需要响应拉取请求事件、但不想搭建公开服务器的本地智能体,Event Streams 提供了直接的事件通道,替代频繁请求。代价是订阅仅对单个请求有效且有时限,并且发生事件遗漏后需要恢复最新状态。低频检查继续使用轮询更合适;如果服务端集成需要接收事件并处理自己的地址,则可围绕 webhook 构建。