Analisar o código do GitHub usando o Gemini Code Assist

O Gemini Code Assist para GitHub traz a capacidade do Gemini para o processo de solicitação de pull atuando como um revisor de código. O Gemini Code Assist acelera e aumenta a qualidade do código usando um agente com tecnologia Gemini que resume automaticamente as solicitações de pull e oferece análises detalhadas do código. É possível invocar o Gemini Code Assist em qualquer etapa do pull request para revisar o código.

Você pode interagir com o Gemini nos comentários do pull request diretamente:

  • Faça perguntas para esclarecer a revisão criada pelo Gemini.
  • Ative o Gemini adicionando a tag /gemini aos seus comentários para fazer perguntas no contexto da solicitação de envio.

O Gemini vai extrair automaticamente informações úteis do repositório e da solicitação de pull para realizar as tarefas.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Pressupomos que você tenha um conhecimento prático do GitHub.

Antes de começar

Para testar as etapas neste documento, siga um destes procedimentos:

Instalar o Gemini Code Assist para GitHub

Para instalar o Gemini Code Assist, siga estas etapas:

  1. Acesse a página do app Gemini Code Assist for GitHub.

  2. Faça login na sua conta do GitHub, se ainda não tiver feito isso.

  3. Clique em Instalar.

    Uma solicitação para instalar o Gemini Code Assist para um usuário ou organização é exibida.

  4. Quando você receber uma solicitação para instalar o Gemini Code Assist para um usuário ou organização, selecione a organização em que você pretende usá-lo.

    Depois de instalar o Gemini Code Assist na sua organização do GitHub, você vai receber uma solicitação para selecionar os repositórios e ativar a integração de análise de código.

    Você será redirecionado para o Console do Administrador do Gemini Code Assist.

  5. Faça login com sua conta do GitHub.

  6. Selecione uma organização ou conta pessoal do GitHub no menu suspenso.

  7. Leia e aceite os Termos de Serviço do Google, a Política de uso proibido da IA generativa e a Política de Privacidade e clique em Concluir configuração.

    O Gemini Code Assist é adicionado aos pull requests nos repositórios selecionados.

Após a criação, o Gemini Code Assist oferece sugestões para a revisão de código sempre que o autor do pull request ou outros revisores humanos adicionam comentários com a tag /gemini no pull request.

O Gemini Code Assist agora está ativo para todas as solicitações de pull nos repositórios selecionados. Na próxima seção, você vai aprender a receber resumos e feedback de solicitações de pull.

Receber o resumo e o feedback da solicitação de pull

Para receber uma análise inicial de uma solicitação de envio do Gemini Code Assist, crie uma nova solicitação de envio.

Quando você abrir o novo pull request, o Gemini Code Assist vai fornecer uma análise inicial. Depois que a análise estiver pronta, gemini-code-assist[bot] será adicionado automaticamente como revisor à solicitação de pull. O Gemini Code Assist adiciona um comentário de problema na guia Conversation da solicitação de envio com o feedback e continua adicionando comentários sobre partes modificadas do código.

Os comentários de revisão contêm as seguintes informações:

  • Gravidade do problema, indicada como "Crítica", "Alta", "Média" e "Baixa"
  • Feedback sobre o problema
  • Sugestão de código que pode ser confirmada diretamente no GitHub
  • Referências a um guia de estilo fornecido pelo usuário

Invocar manualmente o Gemini Code Assist

O Gemini Code Assist ouve os comentários de qualquer colaborador de solicitação de pull e decide se ele deve responder.

Para invocar manualmente o Gemini Code Assist, use os comandos a seguir na página principal de comentários da solicitação de envio como um comentário de problema.

Comando Descrição
/gemini summary Posta um resumo das mudanças na solicitação de envio
/gemini review Posta uma análise de código das mudanças na solicitação de envio
/gemini Invocar manualmente o Gemini Code Assist nos comentários
/gemini help Visão geral dos comandos disponíveis

Gerenciar as configurações do Gemini Code Assist

Qualquer pessoa com permissões para modificar as configurações do GitHub App para a organização pode gerenciar as configurações da Assistência de código do Gemini. É possível revisar as permissões fornecidas ao Gemini Code Assist, gerenciar o acesso ao repositório e desinstalar o Gemini Code Assist.

Para modificar as configurações, siga estas etapas:

  1. No GitHub, clique na sua foto do perfil e em Configurações.
  2. Na seção Integrations, clique em Applications. Uma lista de apps do GitHub é exibida.
  3. Ao lado do Gemini Code Assist, clique em Configurar.

A seguir