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

O Gemini Code Assist para GitHub traz o poder 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 do Gemini que resume automaticamente as solicitações de pull e oferece revisões detalhadas do código. Você pode invocar o Gemini Code Assist em qualquer etapa da solicitação de pull para revisar o código.

Você pode interagir com o Gemini diretamente nos comentários da solicitação de pull:

  • Fazer perguntas para esclarecer a avaliação criada pelo Gemini.
  • Pedir ao Gemini para adicionar a tag /gemini aos seus comentários para fazer perguntas no contexto da solicitação de envio.

O Gemini vai recuperar 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, faça uma das seguintes ações:

  • Use seu próprio repositório do GitHub. O Gemini Code Assist não é compatível com organizações que ativam a conectividade particular.

  • Crie um fork do repositório de amostra.

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 para 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 for solicitado a instalar o Gemini Code Assist para um usuário ou organização, selecione a organização em que você pretende usar o recurso.

    Depois de instalar o Gemini Code Assist na sua organização do GitHub, você vai precisar selecionar os repositórios para ativar a integração da revisão de código.

    Você será redirecionado para o Admin Console 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. Depois, clique em Concluir configuração.

    O Gemini Code Assist é adicionado às solicitações de pull nos repositórios selecionados.

Depois da criação, o Gemini Code Assist fornece sugestões para sua revisão de código sempre que o autor da solicitação de pull ou outros revisores humanos adicionam comentários com a tag /gemini na solicitação de pull.

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 resumo e feedback de solicitações de pull

Para receber uma revisão inicial de uma solicitação de envio do Gemini Code Assist, crie uma solicitação de envio.

Quando você abre a nova solicitação de pull, o Gemini Code Assist faz uma análise inicial. Depois que a revisão estiver pronta, o 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 Conversa da solicitação de envio com o feedback e continua adicionando comentários sobre as partes modificadas do código.

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

  • Gravidade do problema, classificada como crítica, alta, média e baixa
  • Feedback sobre o problema
  • Sugestão de código que pode ser confirmada diretamente do 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 deve responder.

Para invocar manualmente o Gemini Code Assist, use os seguintes comandos 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 revisão de código das mudanças na solicitação de envio.
/gemini Invoca manualmente o Gemini Code Assist em 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 app GitHub na organização pode gerenciar as configurações do Gemini Code Assist. Você pode analisar as permissões concedidas 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 Integrações, clique em Aplicativos. Uma lista de apps do GitHub é exibida.
  3. Ao lado de "Gemini Code Assist", clique em Configurar.

A seguir