Programar com o Gemini Code Assist

Neste documento, descrevemos como usar o Gemini Code Assist, uma ferramenta de colaboração com tecnologia de IA no Google Cloud, para ajudar você a realizar as seguintes ações no Cloud Code:

  • Forneça orientações para ajudar a resolver problemas com seu código.

  • Gere o código do seu projeto.

  • Receba sugestões inline enquanto estiver codificando.

Saiba como e quando o Gemini do Google Cloud usa seus dados.

Para ajudar você a obedecer a todos os requisitos de licença do código, o Gemini Code Assist fornece citações de fontes quando as sugestões citam diretamente uma fonte específica. Para saber mais sobre como e quando o Gemini cita fontes, consulte Como o Gemini ajuda a gerar código e cita fontes.

Personalização de código permite que você receba sugestões de código baseadas na base de código particular da sua organização. diretamente no Gemini Code Assist. Aprender como configurar a personalização de código.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Ele pressupõe que você tenha conhecimento prático do IntelliJ e esteja familiarizado com o Google Cloud. Se preferir, você também pode conhecer o Gemini Code Assist no Cloud Workstations; Cloud Code para VS Code e Editor do Cloud Shell.

Antes de começar

  1. Antes de testar os recursos do Gemini Code Assist no arquivo de código, verifique se o arquivo tem suporte para a linguagem de programação. Para mais informações sobre as linguagens de programação compatíveis, consulte Linguagens de programação compatíveis.

  2. Instale a extensão Gemini Code Assist/Cloud Code se ainda não fez isso. O Gemini Code Assist e o Cloud Code são agrupados.

  3. Se você preferir usar o ambiente de desenvolvimento integrado por um proxy, consulte Proxy HTTP.

Instalar o plug-in do Gemini Code Assist

Para instalar o plug-in Gemini Code Assist no ambiente de desenvolvimento integrado do JetBrains, siga estas etapas:

  1. Clique em settings IDE and Project Settings > Plugins.
  2. Na guia Marketplace, pesquise por Gemini Code Assist/Cloud Code.
  3. Clique em Instalar para instalar o plug-in.
  4. Quando a instalação terminar, clique em Restart IDE.
  5. Quando o ambiente de desenvolvimento integrado é reiniciado, o Gemini Code Assist aparece na barra de atividades.

    O ícone do Gemini Code Assist aparece na barra de atividades

Agora você já pode usar o Gemini Code Assist no seu ambiente de desenvolvimento integrado.

Faça login no Google e selecione um projeto do Google Cloud

Nesta seção, você faz login na sua Conta do Google e, se for a primeira vez que você usa o Gemini Code Assist no seu ambiente de desenvolvimento integrado, selecione um projeto do Google Cloud.

Para fazer login na sua Conta do Google, siga estas etapas:

  1. Na barra de atividades, clique em spark. Gemini Code Assist (em inglês).

  2. Clique em Fazer login no Google.

  3. Na página que aparecer no navegador da Web, selecione sua Conta do Google.

  4. Na tela que pede para você conferir se fez o download do app pelo Google, clique em Fazer login.

    O Gemini Code Assist agora tem autorização para acessar sua conta.

Se esta é a primeira vez que você usa o Gemini no seu ambiente de desenvolvimento integrado, precisa selecionar um projeto do Google Cloud seguindo estas etapas:

  1. Volte ao ambiente de desenvolvimento integrado. Na janela de ferramentas do Gemini Code Assist, você permite que o Google ative as APIs necessárias para usar o Gemini Code Assist em seu nome para o projeto selecionado, Clique em Selecionar um projeto do GCP para continuar.

  2. Na caixa de diálogo Selecionar projeto do Google Cloud, pesquise e selecione as opções projeto do Google Cloud e clique em OK.

  3. Clique em FINALIZAR.

Seu projeto do Google Cloud está selecionado com a API Gemini Code Assist ativada. Você já pode usar o Gemini no seu ambiente de desenvolvimento integrado.

Conversar com o Gemini Code Assist

Nesta seção, você vai pedir que o Gemini Code Assist forneça uma explicação de seu código existente.

Para conferir uma explicação sobre o código, siga estas etapas:

  1. No IDE, abra o arquivo de código.

  2. Na janela da ferramenta Gemini Code Assist, digite o comando Explain this code to me e clique em Enviar.

    O Gemini Code Assist usa o código no arquivo como referência para o comando e responde com uma explicação do código.

    Se você quiser uma explicação de uma parte específica do código, selecione um código específico e solicite o Assistente de código do Gemini novamente. O Gemini Code Assist só vai usar o código selecionado como referência para a resposta gerada.

Confira outros exemplos de comandos que você pode fazer ao Gemini Assistência de código:

  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

Quando o Gemini Code Assist fornece código na resposta, você pode selecionar as seguintes opções listadas no final da resposta:

  • Insert at Cursor: insere o código gerado no arquivo atual em a posição atual do cursor.

  • Inserir em um novo arquivo: abre um novo arquivo e insere o código gerado nele.

O Gemini lista as ações de código no final de uma resposta de código gerada.

Essas opções ficam disponíveis quando o Gemini Code Assist identifica a linguagem usada em seu bloco de código e se ela é compatível com seu IDE atual.

Ver histórico de consultas

Se quiser reutilizar seus comandos anteriores, eles podem ser encontrados na seção Consulta Histórico na janela de ferramentas do Gemini Code Assist schedule Mostrar histórico de consultas.

Histórico de consultas do Gemini na janela de ferramentas.

Seu histórico de consultas e conversas é mantido nas sessões do ambiente de desenvolvimento integrado. Para limpar o histórico de consultas e de conversas, clique em excluir Limpar histórico de conversas.

Botão para limpar o histórico de conversas na janela de ferramentas do Gemini.

Receber preenchimentos de código

Enquanto você escreve o código, o Gemini Code Assist cria código in-line sugestões, chamadas de preenchimentos de código, que você pode aceitar ou ignorar. Para receber preenchimentos de código, siga estas etapas:

  1. No arquivo de código, em uma nova linha, comece a escrever uma função. Por exemplo, se você estiver em um arquivo Python, escreva def.

    O Gemini Code Assist sugere código na forma de uma sugestão inline.

  2. Para aceitar a sugestão de código do Gemini Code Assist, pressione Tab. Caso contrário, pressione Esc ou continue escrevendo o código.

  3. Opcional: se você preferir usar uma tecla de atalho diferente para aceitar a sugestão inline, mantenha o ponteiro sobre a sugestão inline e clique no menu suspenso Tab que aparece. Em seguida, selecione o atalho de sua preferência ou clique em Personalizado para inserir seu próprio atalho.

    O Gemini oferece um menu suspenso para mudar o atalho e aceitar uma sugestão inline.

A conclusão de código é ativada por padrão. Se você quiser desativar a conclusão de código, na barra de status do ambiente de desenvolvimento integrado, clique em spark AI Code Completion: Active e selecione Enable AI Code Completion.

Botão de conclusão de código do Gemini na barra de status do IntelliJ.

Essa ação desativa a configuração de preenchimento de código e o Gemini Code Assist não fará mais sugestões inline até que você ative a configuração novamente.

Usar ações inteligentes

Para aumentar sua produtividade e minimizar a troca de contexto, O Gemini Code Assist oferece ações inteligentes com tecnologia de IA diretamente no com seu editor de código. Ao selecionar seu código no editor de código, é possível visualizar e selecione de uma lista de ações relevantes para o contexto.

Para usar ações inteligentes no código, siga estas etapas:

  1. No arquivo de código, selecione uma linha ou bloco de código.

  2. Clique com o botão direito do mouse no código selecionado e escolha uma ação inteligente, como Gerar testes de unidade.

    Se você selecionar a ação inteligente, o Gemini vai aparecer automaticamente Code Assist para gerar uma resposta ao comando no Gemini Code Assist janela de ferramentas.

Excluir arquivos do contexto

Se você quiser excluir algum arquivo das finalizações e interações de chat do Gemini Code Assist, crie um arquivo .aiexclude, que funciona de forma semelhante ao .gitignore.

Para mais informações sobre como configurar um arquivo .aiexclude, consulte Configurar o compartilhamento de contexto com arquivos .aiexclude.

Problemas conhecidos

As seções a seguir descrevem os problemas conhecidos do Gemini Code Assist.

O atalho de preenchimento de código do JetBrains se sobrepõe ao atalho do Gemini Code Assist

Em versões 2024.2 da JetBrains, você pode usar o Gemini Code Assist tecla de atalho para a geração de código (Alt+Shift+\ no Windows e no Linux, ou Option+Shift+\ no macOS) sobrepostos ao código do JetBrains. atalho de conclusão que foi introduzido recentemente.

Para mudar a tecla de atalho do Gemini Code Assist, faça o seguinte:

  1. Acesse settings IDE e projeto Configurações > Configurações > Mapa de teclado > Gemini Code Assist (em inglês).

  2. Clique com o botão direito do mouse em Gemini Code Assist e selecione Adicionar atalho de teclado.

  3. Digite o atalho de teclado de sua preferência e clique em OK.

  4. Clique com o botão direito do mouse em Gemini Code Assist e selecione Remover Alt+Shift+\ (no Windows e no Linux) ou Remover Option+Shift+\ (no macOS).

    Agora você pode usar o novo atalho de teclado para gerar código em um arquivo de código.

Enviar feedback

Para deixar feedback sobre sua experiência, siga estas etapas:

  1. Na barra de status, clique em spark. Preenchimento automático de código de IA e, no menu, selecione Enviar feedback.

  2. No campo de texto na parte de cima do formulário, insira seu feedback.

  3. Se quiser compartilhar seus registros do Gemini Code Assist, que você selecione os arquivos de registro.

  4. Clique em Enviar feedback.

A seguir