Configurando a revisão de código por GitHub Copilot

Configure Copilot para examinar solicitações de pull.

Neste artigo

Introdução

Você pode configurar Copilot code review para examinar solicitações de pull automaticamente. Para obter uma visão geral das revisões automáticas de pull request, consulte Sobre a revisão do código do GitHub Copilot.

Configurar a revisão automática de código para suas pull requests

Observação

Isso só estará disponível se você estiver em um dos planos Copilot Pro, Copilot Pro+ ou Copilot Max.

  1. No canto superior direito de qualquer página, clique na sua foto de perfil e em Copilot settings.

  2. Encontre a opção Automático Copilot code review e clique no botão de lista suspensa.

    Captura de tela da configuração "Automatic Copilot code review" com o menu suspenso exibido.

  3. No menu suspenso, selecione Habilitado.

Configurando a revisão automática de código para um repositório

Você pode habilitar revisões automáticas de código para um repositório e personalizar como as revisões de código são executadas.

Habilitação das avaliações automáticas

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na barra lateral esquerda, em "Código e automação", clique em Conjuntos de Regras e clique em Conjuntos de Regras.

  4. Clique em Novo conjunto de regras.

  5. Clique em Novo conjunto de regras de branch.

  6. Em "Nome do conjunto de regras", digite um nome para o conjunto de regras.

  7. Para ativar o conjunto de regras, em "Status de Imposição", selecione Ativo.

  8. Em "Branches de destino", clique em Adicionar destino e escolha uma das opções. Por exemplo, Incluir branch padrão ou Incluir todos os branches.

  9. Em "Branches de destino", clique em Adicionar destino e escolha uma das opções de destino.

  10. Em "Regras de ramificação", selecione Solicitar automaticamente Copilot code review.

  11. Opcionalmente, se você quiser Copilot examinar todos os novos pushes para a solicitação de pull, selecione Examinar novos pushes.

    Se essa opção não estiver selecionada, Copilot examinará apenas a solicitação de pull uma vez.

  12. Opcionalmente, se você quiser que Copilot revise pull requests enquanto ainda estiverem em rascunho, selecione Revisar pull requests em rascunho.

    Essa pode ser uma opção útil para capturar erros antecipadamente, antes de solicitar uma revisão humana.

  13. Na parte inferior da página, clique em Criar.

Personalizar Copilot code review

Você pode configurar como Copilot code review conclui as revisões de código em seu repositório.

  1. Em GitHub, acesse a página principal do repositório.

  2. No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na barra lateral, em "Código, planejamento e automação", clique Copilot e, em seguida, revisão de código.

  4. Para escolher a profundidade das revisões de código de Copilot, ao lado de "Nível de esforço da revisão", selecione o nível de esforço para revisões automáticas neste repositório.

    • Lite: Revisão padrão.
    • Balanceado: análise mais profunda de lógica complexa, código sensível à segurança e alterações entre serviços.

    As revisões balanceadas usam mais AI credits e podem consumir marginalmente mais GitHub Actions minutos. Consulte Sobre a revisão do código do GitHub Copilot.

  5. Para escolher se Copilot pode aprovar solicitações de pull em seu repositório, defina as configurações em "Aprovação automática".

    • Permitir que Copilot aprove pull requests: ative esta opção para permitir que Copilot envie revisões de aprovação.

    • Permitir que as aprovações de Copilot contem para os requisitos de mesclagem: Ative esta opção para que as aprovações de Copilot satisfaçam os requisitos de aprovação da solicitação de pull.

    • Caminhos de arquivo: Opcionalmente, limite quais pull requests contam para os requisitos de mesclagem. Insira um glob de arquivo por linha para contar aprovações somente em solicitações de pull em que cada arquivo alterado corresponde a um dos globs. Deixe em branco para contar aprovações para todos os arquivos. Há suporte para até 15 globs.

    Observação

    Copilot as aprovações estão em prévia pública e estão sujeitas a alterações.

Configuração da revisão automática para repositórios em uma organização

Você pode habilitar revisões automáticas de código para repositórios em sua organização e personalizar como as revisões de código são executadas.

Habilitação das avaliações automáticas

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na barra lateral, em "Código, planejamento e automação", clique em Repositório e clique em Conjuntos de Regras.

  5. Clique em Novo conjunto de regras.

  6. Clique em Novo conjunto de regras de branch.

  7. Em "Nome do conjunto de regras", digite um nome para o conjunto de regras.

  8. Para ativar o conjunto de regras, em "Status de Imposição", selecione Ativo.

  9. Em "Repositórios de destino", clique em Adicionar destino e escolha Incluir por padrão ou Excluir por padrão.

  10. Digite um padrão que corresponda aos nomes de repositório que você deseja direcionar, por exemplo, *feature para corresponder a todos os repositórios com nomes que terminam em feature.

    Para obter a sintaxe de correspondência de padrões, consulte Criar conjuntos de regras para repositórios na sua organização.

  11. Clique em Adicionar padrão de inclusão ou Adicionar padrão de exclusão.

  12. Repita para quaisquer padrões adicionais.

    Observação

    Você pode adicionar vários critérios de direcionamento ao mesmo conjunto de regras. Os padrões de exclusão são aplicados após os padrões de inclusão. Por exemplo, você pode incluir todos os repositórios que correspondam ao padrão *cat* e excluir especificamente um repositório que corresponda ao padrão not-a-cat.

  13. Em "Branches de destino", clique em Adicionar destino e escolha uma das opções de destino.

  14. Em "Regras de ramificação", selecione Solicitar automaticamente Copilot code review.

  15. Opcionalmente, se você quiser Copilot examinar todos os novos pushes para a solicitação de pull, selecione Examinar novos pushes.

    Se essa opção não estiver selecionada, Copilot examinará apenas a solicitação de pull uma vez.

  16. Opcionalmente, se você quiser que Copilot revise pull requests enquanto ainda estiverem em rascunho, selecione Revisar pull requests em rascunho.

    Essa pode ser uma opção útil para capturar erros antecipadamente, antes de solicitar uma revisão humana.

  17. Na parte inferior da página, clique em Criar.

Personalizar Copilot code review

Você pode configurar como Copilot code review conclui as revisões de código em repositórios em sua organização.

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Selecione uma organização clicando nela.

  3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela das guias no perfil de uma organização. A guia "Configurações" está contornada em laranja escuro.

  4. Na barra lateral, em "Código, planejamento e automação", clique Copilot e, em seguida, revisão de código.

  5. Para escolher a profundidade das revisões de código Copilot, ao lado de "Nível de esforço da revisão", selecione o nível de esforço padrão das revisões automáticas nos repositórios da sua organização.

    • Lite: Revisão padrão.
    • Balanceado: análise mais profunda de lógica complexa, código sensível à segurança e alterações entre serviços.

    As revisões balanceadas usam mais AI credits e podem consumir marginalmente mais GitHub Actions minutos. Consulte Sobre a revisão do código do GitHub Copilot.

  6. Para escolher se Copilot pode aprovar pull requests nos seus repositórios, selecione uma opção em "Aprovações", ao lado de "Contar aprovações de Copilot para os requisitos de mesclagem".

    • Habilitado em todos os lugares: Copilot as aprovações podem contar para os requisitos de mesclagem em todos os repositórios da organização.

    • Permitir que os repositórios decidam: os administradores do repositório podem decidir isso nas configurações do repositório.

    • Habilitar para repositórios selecionados: as Copilot aprovações podem contar para requisitos de mesclagem somente nos repositórios selecionados. Se você escolher essa opção, atribua também os repositórios para os quais deseja habilitar isso.

    • Desativado em todos os lugares: Copilot as aprovações não podem ser consideradas para atender aos requisitos de mesclagem em qualquer repositório da organização.

    Observação

    Copilot as aprovações estão em prévia pública e estão sujeitas a alterações.

Configurando a revisão automática de código para uma empresa

Você pode habilitar revisões automáticas de código para sua empresa e personalizar como as revisões de código são executadas.

Habilitação das avaliações automáticas

  1. Crie um conjunto de regras de ramificação de nível corporativo. Consulte Impondo a governança de código na sua empresa com conjuntos de regras.
  2. Direcione as organizações e repositórios em que Copilot code review devem ser executados automaticamente.
  3. Habilite a política de Solicitar automaticamente Copilot code review.
  4. Opcionalmente, habilite revisões automáticas para pull requests em rascunho e após cada push em uma pull request.
  5. Clique em Criar.

Personalizar Copilot code review

Você pode configurar como Copilot code review conclui as revisões de código para sua empresa.

  1. Navegue até sua empresa. Por exemplo, na página Enterprises em GitHub.com.
  2. Na parte superior da página, clique em controles de IA.
  3. Role para baixo até "Agentes disponíveis" e clique em Copilot code review.
  4. Ao lado de "Copilot code review", selecione uma política.
  5. Em seguida, escolha quais Copilot code review recursos habilitar para sua empresa.
  6. Para escolher se Copilot pode aprovar solicitações de pull em suas organizações, ao lado de "Permitir Copilot aprovar solicitações de pull", selecione uma política.

    • Permitir que as organizações decidam: os proprietários da organização podem escolher se devem habilitar Copilot as aprovações.

    • Habilitar para organizações selecionadas: Copilot as aprovações são habilitadas apenas para as organizações selecionadas.

    • Desabilitado em qualquer lugar: as organizações não podem ativar Copilot aprovações. Este é o padrão.

    Observação

    Copilot as aprovações estão em prévia pública e estão sujeitas a alterações.