Agentes

GitHub Agent Merge: o Copilot consegue corrigir seus pull requests enquanto você trabalha?

O Agent Merge do GitHub monitora pull requests com workflows do Actions falhos e conflitos de merge. Como funciona, quanto custa e quais são os limites.

Por ·

Um pull request está pronto para revisão quando um workflow do GitHub Actions falha. Antes de você terminar de investigar, a branch base muda e surge um conflito de merge. O Agent Merge, do GitHub, foi pensado para monitorar esses bloqueios e começar a resolvê-los enquanto você passa para outra coisa.

Em 28 de outubro, o GitHub levou o Agent Merge diretamente para a caixa de merge do pull request no github.com. O Copilot pode monitorar workflows do Actions com falha, conflitos de merge ou ambos. Ele trabalha em segundo plano quando um dos bloqueios selecionados aparece; você ainda precisa revisar as alterações dele e cumprir os requisitos de merge do repositório (GitHub).

O que o Agent Merge faz

No GitHub, o Agent Merge faz parte do Copilot na nuvem. Ative-o em um pull request, selecione os bloqueios que deseja que ele trate, e o Copilot inicia uma tentativa de correção quando detecta um deles. O GitHub publica atualizações na linha do tempo do pull request explicando por que o agente foi iniciado (GitHub Docs).

O que o Agent Merge faz
BloqueioO que o Copilot pode fazer
Workflows do GitHub Actions com falhaInvestigar e tentar uma correção
Conflitos de mergeTentar resolver os conflitos entre a branch do pull request e a branch base

Uma tentativa de correção não é uma garantia. Um teste pode falhar por uma asserção incorreta, um problema de dependência ou uma regressão real; um conflito pode envolver duas alterações válidas cujo comportamento pretendido não é óbvio só pelo texto. Verifique o diff resultante e execute novamente ou inspecione as verificações relevantes antes de aceitar a alteração.

Como ativá-lo no GitHub

Você precisa de um plano pago do Copilot com acesso ao Copilot na nuvem. Se o seu acesso vem de uma organização ou empresa, as políticas dela precisam permitir o recurso na nuvem. A política do Copilot Enable automations do repositório também precisa estar ativada (GitHub Docs).

  1. Abra o pull request no GitHub.
  2. Na caixa de merge, selecione Watch and fix.
  3. Escolha Fix failed Actions workflows, Resolve merge conflicts ou ambos.
  4. Acompanhe as atualizações do Agent Merge na caixa de merge e na linha do tempo do pull request.
  5. Revise as alterações feitas pelo Copilot e confira os resultados dos workflows.

Você também pode ativá-lo por padrão nos pull requests que criar em Settings → Copilot → Cloud. Para interrompê-lo em um pull request específico, selecione Unassign Copilot na caixa de merge. O GitHub diz que o recurso não oferece suporte a pull requests empilhados nem a pull requests abertos a partir de forks.

O Agent Merge faz o merge do pull request?

O recurso em nuvem do GitHub prepara e mantém o pull request; ativá-lo não liga o merge automático. O recurso separado de merge automático do GitHub pode ser combinado com o Agent Merge e fará o merge assim que as revisões e verificações exigidas pelo repositório forem satisfeitas (GitHub Docs).

A distinção importa: se o merge automático estiver ativado, uma correção bem-sucedida pode ser seguida de um merge assim que os requisitos configurados forem atendidos. Revise as regras do repositório e as alterações propostas em vez de presumir que sempre haverá outra confirmação manual.

O aplicativo do Copilot tem uma experiência diferente. O GitHub diz que a versão do aplicativo também pode tratar comentários de revisão e pode fazer o merge do pull request assim que o GitHub permitir. O VS Code também documenta uma experiência experimental de Agent Merge, com opções próprias. Essas superfícies não devem ser tratadas como idênticas ao Watch and fix no GitHub (GitHub Docs; VS Code).

Quanto custa?

O recurso em nuvem do Agent Merge exige um plano pago do Copilot. O uso de créditos de IA é cobrado de quem o ativou no pull request, que pode não ser o autor dele. O GitHub não informa um custo fixo por correção na documentação do Agent Merge; o uso depende do trabalho e dos modelos envolvidos (GitHub Docs).

A documentação de cobrança individual do GitHub lista o Copilot Pro a US$ 10 por mês, o Pro+ a US$ 39 e o Max a US$ 100, com diferentes franquias de créditos de IA incluídos. São preços de plano, não cobranças do Agent Merge; o que uma correção consome é um uso à parte, dentro da franquia e das regras de cobrança aplicáveis (GitHub billing). Confira o seu painel de uso e os termos do seu plano antes de ativá-lo de forma ampla.

Onde as correções são executadas?

Embora o Agent Merge faça parte do Copilot na nuvem, o GitHub diz que suas correções são executadas em um ambiente de desenvolvimento baseado no GitHub Actions, não em um sandbox na nuvem. Ele pode usar instruções personalizadas do repositório, agent skills e etapas de configuração em .github/workflows/copilot-setup-steps.yml (GitHub Docs).

Isso torna a configuração do repositório relevante para o resultado. Uma dependência ausente ou uma instrução imprecisa pode afetar o que o agente enxerga. Preste atenção especial às alterações que afetam testes, permissões e a configuração de workflows: um check verde é útil, mas não prova que a intenção original ou a segurança do workflow foram preservadas.

Nossa avaliação

O Agent Merge ataca uma fonte familiar de atrito: esperar as verificações, notar uma falha e voltar a uma branch só para torná-la apta ao merge. Para um desenvolvedor solo ou uma equipe pequena, uma correção em segundo plano pode encurtar essa interrupção.

O valor dele dependerá da qualidade das correções propostas e do tempo necessário para verificá-las. Comece por um pull request com verificações claras, escolha apenas os tipos de bloqueio que deseja ver tratados e compare o diff do agente com o objetivo original. Acompanhe o uso de créditos junto com o tempo de revisão. O resultado que importa é uma alteração correta e de fácil manutenção que passe nas verificações certas, e não apenas uma caixa de merge verde.

Fontes

Encontrou um erro neste artigo? Avise-nos · Nossa política de correções

Ícone do Rekha: uma casa desenhada em um único traço

Do mesmo autor Autopromoção

Um caminho euleriano, desenhado com o dedo

Rekha, o jogo para iPhone do autor da OrigoTech: conecte todos os pontos em um único traço, sem percorrer duas vezes o mesma ligação, ao longo de 500 desenhos que têm solução.

A newsletter da OrigoTech

Um resumo semanal, com fontes, das novidades das ferramentas de IA.

Continue lendo