Preparando pull requests prontos para mesclagem com Agent Merge

Deixe Copilot observar seus pull requests e corrigir fluxos de trabalho com falha e conflitos de mesclagem, enquanto você se concentra em outros trabalhos.

Neste artigo

Sobre Agent Merge

Agent Merge faz parte de Copilot in the cloud. Ele observa uma pull request em busca dos impedimentos que você escolher e inicia o trabalho automaticamente quando encontra um. Você pode permitir que Copilot corrija fluxos de trabalho com falha GitHub Actions, resolva conflitos de mesclagem ou ambos.

Agent Merge ajuda a deixar um pull request pronto para mesclar e mantê-lo assim. Ele não substitui sua revisão das alterações ou dos requisitos de mesclagem do repositório.

Pré-requisitos e limitações

Para usar Agent Merge, você deve ter acesso ao Copilot in the cloud por meio de um plano pago Copilot. Se sua organização ou empresa fornece acesso ao Copilot, suas políticas devem permitir que você use Copilot in the cloud.

A política Habilitar automaçõesCopilot do repositório também deve estar habilitada.

Agent Merge não oferece suporte a pull requests empilhadas ou pull requests abertas a partir de um fork.

Habilitando Agent Merge para uma pull request

  1. Em GitHub, abra a pull request que você quer que Copilot acompanhe.

  2. Na caixa de mesclagem da solicitação de pull, clique em Observar e corrigir.

  3. Escolha as ações que você deseja que Copilot execute:

    • Corrigir fluxos de trabalho do Actions com falha: permitir que Copilot investigue e corrija fluxos de trabalho GitHub Actions com falha.
    • Resolver conflitos de mesclagem: permitir Copilot resolver conflitos entre o branch da solicitação de pull e seu branch base.

Quando um dos bloqueios selecionados é exibido, Copilot começa a trabalhar em um ambiente de desenvolvimento na nuvem para corrigi-lo.

Após o trabalho Agent Merge

Enquanto Copilot observa seu pull request, você verá atualizações na seção Agent Merge da caixa de merge.

Quando Copilot inicia o trabalho, uma atualização aparece como um evento da linha do tempo da pull request. A atualização explica por que ela foi iniciada, por exemplo, por um fluxo de trabalho com falha ou por um conflito de mesclagem.

Examine as alterações feitas Copilot e verifique os resultados do fluxo de trabalho antes da mesclagem. Agent Merge não remove a necessidade de revisão humana.

Habilitar Agent Merge automaticamente

Você pode habilitar Agent Merge por padrão para solicitações de pull que você criar.

  1. No canto superior direito de qualquer página do GitHub, clique em sua imagem de perfil e, em seguida, clique em Configurações.
  2. Na barra lateral, em Copilot, clique em Cloud.
  3. Selecione Habilitar Agent Merge automaticamente para solicitações de pull que eu criar.
  4. Use os interruptores Corrigir fluxos de trabalho do Actions com falha e Resolver conflitos de mesclagem para escolher quais ações Copilot podem ser executadas quando Agent Merge for habilitado automaticamente para suas solicitações de pull. Você pode habilitar uma das ações ou ambas.

Desabilitando Agent Merge para uma solicitação de pull request

Você pode desabilitar Agent Merge para uma solicitação de pull se a habilitou ou se tiver acesso de gravação ao repositório.

  1. Em GitHub, abra a pull request.
  2. Na caixa de mesclagem na parte inferior da solicitação de pull, clique em Desatribuir Copilot.

Usar Agent Merge com a mesclagem automática

Agent Merge corrige os bloqueadores, enquanto a mesclagem automática mescla uma pull request após todas as revisões e verificações de status necessárias serem aprovadas. Ativar Agent Merge não ativa a mesclagem automática.

Você pode combinar os dois para permitir que Copilot prepare a solicitação de pull e a mantenha pronta, enquanto GitHub a mescla assim que todos os requisitos forem atendidos. Para obter diretrizes de configuração, consulte Mesclar automaticamente uma pull request.

Personalizando o ambiente de Agent Merge

Embora Agent Merge faça parte de Copilot in the cloud, suas correções são executadas em um ambiente de desenvolvimento baseado em GitHub Actions, não em uma área restrita de nuvem. Ele usa as mesmas personalizações de repositório que outras Copilot tarefas executadas GitHub Actions, incluindo:

Uso e cobrança

Os AI credits usados por Agent Merge são cobrados ao usuário que os habilita para a solicitação de pull, não necessariamente ao autor da solicitação de pull. Para obter mais informações sobre uso e franquias, consulte Cobrança e uso do GitHub Copilot.