jsonscraper
Mercados
Voltar ao jornal

GitHub Event Streams desperta agentes com eventos de pull request, sem consultas frequentes

Como o fluxo de eventos transforma a comunicação entre o GitHub e agentes locais — e quais eventos estão disponíveis na prévia

Política editorial Comunique um erro

Como um agente pode saber que surgiu uma nova avaliação em um pull request sem consultar o GitHub a cada minuto nem exigir que o usuário mantenha um servidor público? Em 17 de novembro de 2026, o GitHub abriu o Event Streams em prévia: o cliente se inscreve em um pull request, mantém uma conexão aberta com o GitHub e recebe eventos à medida que ocorrem.

Artigo: GitHub Event Streams desperta agentes com eventos de pull request, sem consultas frequentes
Resumo: Em 17 de novembro de 2026, o GitHub abriu o Event Streams em prévia: agentes podem receber eventos de pull request por uma conexão persistente, sem consultar o GitHub periodicamente nem manter um servidor público de webhook.
Função da imagem: capa — a ideia central
Seção: 
Tema visual: Ilustração fotográfica editorial de uma estação de desenvolvimento de software local conectada por um fluxo de dados fino e visível a pull requests abstratos
O fluxo de eventos envia atualizações de pull request a um agente local sem servidor público de webhook.© jsonscraper · criado com IA

A mudança prática diz respeito a agentes locais e automações que precisam reagir a atualizações do repositório. Sem um receptor próprio de webhooks, a forma habitual de acompanhar mudanças é consultar a API periodicamente: consultas frequentes consomem a cota, enquanto consultas espaçadas atrasam a reação. O fluxo de eventos permite iniciar o processamento ao receber um sinal de mudança, em vez de verificar com base em um cronômetro.

Quais eventos o assinante recebe

A documentação do Event Streams lista eventos de pull request: envio de uma avaliação, novo commit, conflito de mesclagem, mesclagem ou fechamento da solicitação, além de alterações no conjunto de verificações ou da conclusão de uma verificação específica. Os eventos são transmitidos por Server-Sent Events (SSE); o cliente não precisa de um endpoint público de webhook. Isso é útil, por exemplo, para um agente no notebook de um desenvolvedor que precisa reagir a uma nova avaliação ou a um commit.

O evento funciona como um sinal de que algo mudou; em seguida, o cliente obtém os dados atualizados pela API REST do GitHub. Por exemplo, uma notificação sobre uma nova avaliação aponta para o recurso de API associado; o cliente pode usá-lo para buscar o estado atual da avaliação ou do pull request antes de iniciar a próxima ação.

Como o fluxo difere de polling e webhook

O polling é simples: o cliente envia solicitações em intervalos definidos e compara as respostas. O intervalo estabelece um equilíbrio entre latência e frequência de solicitações: com verificações a cada minuto, a reação pode esperar pelo ciclo seguinte; com verificações mais frequentes, uma parte considerável das solicitações pode não detectar mudanças. O GitHub apresenta justamente essa escolha como motivo para uma alternativa baseada em eventos.

Artigo: GitHub Event Streams desperta agentes com eventos de pull request, sem consultas frequentes
Resumo: Em 17 de novembro de 2026, o GitHub abriu o Event Streams em prévia: agentes podem receber eventos de pull request por uma conexão persistente, sem consultar o GitHub periodicamente nem manter um servidor público de webhook.
Função da imagem: ilustração complementar 2 — um aspecto específico diferente
Seção: Como o fluxo difere de polling e webhook
Tema visual: Infográfico em russo: três maneiras de receber atualizações de pull requests
O diagrama mostra a direção da conexão e como as atualizações são entregues por polling, webhook e Event Streams.© jsonscraper · ilustração gerada por IA

Com o Event Streams, o cliente cria uma assinatura para um pull request, conecta-se ao GitHub e aguarda eventos pela conexão aberta. O webhook também transmite eventos, mas as integrações geralmente precisam de um endpoint de recebimento acessível publicamente. Por isso, o fluxo é conveniente para um cliente interativo ou agente local, enquanto o webhook atende a um serviço que já recebe solicitações de entrada. O polling continua sendo uma opção simples para verificações pouco frequentes, quando uma reação rápida não é importante.

Outra consequência prática é configurar a assinatura para um recurso específico. A documentação do GitHub descreve uma rota de assinatura para um único pull request, não um feed universal com todas as atualizações do repositório. Projete o processador em torno de um pull request específico e dos tipos de evento de que ele precisa.

Como um agente local pode funcionar

Imagine um agente que ajuda a analisar pull requests. Quando ocorre um evento de avaliação, o agente obtém os dados atualizados e pode preparar uma análise dos comentários; após um novo commit, pode repetir as verificações; após o fechamento ou a mesclagem, pode concluir a tarefa relacionada. Este é um exemplo de uso baseado nos tipos de evento listados pelo GitHub, não um resultado publicado pela empresa de testes desse cenário.

A ordem exata é importante: o evento informa que houve uma mudança e, em seguida, o cliente consulta o recurso de API indicado para obter o estado atual. Como os eventos podem se repetir ou chegar fora de ordem, o processador deve tolerar a repetição da entrega e conferir o estado pela API, em vez de considerar a sequência de notificações um histórico completo das mudanças.

O GitHub transmite o evento pela conexão aberta; em seguida, o cliente local carrega o estado atual do pull request e inicia o processador adequado.

Limitações a considerar

Em 18 de novembro de 2026, o Event Streams está disponível em prévia em todos os planos do GitHub, após a aprovação de uma solicitação enviada pela lista de espera. O acesso é habilitado para uma conta específica, portanto não aparece automaticamente para todos os usuários. A documentação também esclarece que o recurso está disponível no GitHub.com, mas ainda não no GHE.com.

A assinatura abrange um único pull request e expira 24 horas após ser criada. O fluxo não reproduz eventos que ocorreram antes da conexão, durante um breve intervalo após a criação da assinatura ou durante uma interrupção da conexão. O GitHub recomenda obter uma vez o estado atual do pull request após a assinatura e, em caso de eventos repetidos ou fora de ordem, basear-se nos dados da API. Na prática, isso significa que o agente precisa tratar reconexões e conferir o estado, em vez de depender apenas da conexão aberta.

A prévia oferece eventos de pull request; a documentação descreve o conjunto atual e também possíveis mudanças na API, nos tipos de evento e nos limites. Se a automação precisar de outros eventos do repositório ou de entrega garantida pelo servidor, verifique se o fluxo os cobre; caso contrário, use um webhook ou uma verificação pela API.

Para um agente local que precisa reagir a eventos de pull request sem um servidor público, o Event Streams oferece um canal direto de eventos no lugar de solicitações frequentes. O custo dessa escolha é uma assinatura temporária para uma única solicitação e a necessidade de recuperar o estado atual após lacunas. Verificações pouco frequentes podem continuar usando polling; para integrações de servidor que precisam receber eventos em um endereço próprio, o webhook é a alternativa adequada.

Pessoas

Nenhuma pessoa listada para este artigo ainda.

Continue lendoGitHub vincula o Copilot a sandboxes na nuvem e a um limite compartilhado de computação do Actions
Leia o próximo artigo

Transforme o que lê numa integração funcional

Explore as APIs de dados sociais da jsonscraper, teste pedidos e crie o seu próximo fluxo de trabalho.

Explorar APIs