Programar com o Gemini Code Assist

Observação: o Gemini Code Assist Enterprise está disponível por USD 19 por mês por usuário com compromisso de 12 meses até 31 de março de 2025. Entre em contato com nossa equipe de vendas para aproveitar essa oferta promocional.

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 seu ambiente de desenvolvimento integrado:

• Forneça orientações para ajudar a resolver problemas com seu código.
• Gerar código para seu projeto.
• Receba sugestões inline enquanto programa.

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.

A personalização de código permite receber sugestões de código com base na base de código particular da sua organização diretamente do Gemini Code Assist. Saiba 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 conferir o Gemini Code Assist no VS Code, no editor do Cloud Shell e nas estações de trabalho do Cloud.

Observação: o comportamento da geração, conclusão e transformação de código não é determinístico quando usado simultaneamente com outros plug-ins que implementam os mesmos atalhos e/ou usam a mesma API de plataforma para processar essas ações.

Antes de começar

1. Antes de testar os recursos do Gemini Code Assist no seu 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. 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 Configurações do ambiente de desenvolvimento integrado e do projeto > Plugins.
2. Na guia Marketplace, pesquise Gemini Code Assist.
3. Clique em Instalar para instalar o plug-in.
4. Quando a instalação for concluída, clique em Restart IDE.

5. Quando o ambiente de desenvolvimento integrado é reiniciado, o 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.

2. Clique em Fazer login no Google.

3. Na página que abrir 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.

Em seguida, se esta for a primeira vez que você usa o Gemini no seu ambiente de desenvolvimento integrado, selecione um projeto do Google Cloud seguindo estas etapas:

1. Volte para o ambiente de desenvolvimento integrado. Na janela da ferramenta Gemini Code Assist, se você permitir 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 Select Google Cloud Project, pesquise e selecione seu projeto do Google Cloud, depois 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 ao Gemini Code Assist para fornecer uma explicação do código atual.

Para receber uma explicação do código, siga estas etapas:

1. No ambiente de desenvolvimento integrado, 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 o código e solicite o Gemini Code Assist 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 Code Assist:

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

Quando o Gemini Code Assist fornece um código na resposta, é possível selecionar as seguintes opções listadas no final da resposta:

• Inserir no cursor: insere o código gerado no arquivo atual na posição atual do cursor.

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

Essas opções ficam disponíveis quando o Gemini Code Assist identifica o idioma usado no bloco de código e se esse idioma tem suporte no ambiente de desenvolvimento integrado atual.

Ver histórico de consultas

Se você quiser reutilizar os comandos anteriores, eles estarão disponíveis no Histórico de consultas na janela da ferramenta Gemini Code Assist. Basta clicar em schedule Show Query History.

O histórico de consultas e conversas é mantido em todas as sessões do ambiente de desenvolvimento integrado. Para limpar o histórico de consultas e de conversas, clique em delete Limpar histórico de conversas.

Gerar código com comandos

As seções a seguir mostram como usar o Gemini Code Assist para gerar código com o exemplo de comando Function to create a Cloud Storage bucket no arquivo de código. Também é possível selecionar uma parte do código e pedir ajuda ao Gemini Code Assist pelo recurso de chat, além de receber e aceitar ou rejeitar sugestões de código enquanto você programa.

Ativar o Gemini Code Assist em um arquivo de código com um comentário

1. No arquivo de código, em uma nova linha, digite o comentário Function to create a Cloud Storage bucket.

2. Para gerar o código, pressione Alt + G (no Windows e no Linux) ou Option + G (no macOS). Como alternativa, clique com o botão direito do mouse ao lado do comentário e selecione Gerar código.

   O Gemini Code Assist gera o código abaixo do seu comentário na forma de texto fantasma.

3. Opcional: para aceitar o código gerado, pressione Tab.

Opcional: mudar o atalho do teclado para gerar código

Se o atalho de teclado padrão para gerar código não estiver funcionando conforme descrito na seção anterior, siga estas etapas para mudar o atalho de teclado:

1. Navegue até settings Configurações do ambiente de desenvolvimento integrado e do projeto > Configurações > Mapa de teclado > Assistente de código Gemini.

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

3. Insira o atalho de teclado que preferir e clique em OK.

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

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

Acionar o Gemini Code Assist com o código selecionado usando o chat

O Gemini Code Assist pode realizar tarefas ou responder a perguntas com base no código selecionado. Para gerar um código com base em uma instrução com o código selecionado, siga estas etapas:

1. Na barra de atividades, clique em spark Gemini Code Assist para abrir a janela de ferramentas Gemini Code Assist.

2. No arquivo de código, selecione um bloco de código.

3. No campo de texto da janela de ferramentas do Gemini Code Assist, digite um comando para o código selecionado.

   Por exemplo, selecione uma função no código e insira o comando Write a unit test for this function..

   O Gemini Code Assist usa o código selecionado como referência e responde ao comando.

Receber preenchimentos de código

Enquanto você escreve o código, o Gemini Code Assist faz sugestões de código inline, chamadas de preenchimento 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.

   

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

Isso desativa a configuração de preenchimento de código, e o Gemini Code Assist não faz 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 editor de código. Quando você seleciona o código no editor, é possível conferir e selecionar em uma lista as 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 um bloco de código.

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

   A seleção da ação inteligente faz com que o Gemini Code Assist gere automaticamente uma resposta ao comando na janela de ferramentas do Gemini Code Assist.

Opcional: excluir arquivos do contexto com um arquivo .aiexclude

É possível excluir arquivos para que não sejam considerados pelo Gemini Code Assist para contexto criando um arquivo .aiexclude. Um arquivo .aiexclude segue a sintaxe semelhante a um arquivo .gitignore, com as seguintes diferenças:

• Um arquivo .aiexclude vazio ou inexistente não bloqueia nenhum arquivo no diretório e em todos os subdiretórios.
• Um arquivo .aiexclude não aceita negação, em que você prefixa padrões com um ponto de exclamação (!).
• Um arquivo .aiexclude corresponde avidamente ao caractere *. Isso vai corresponder de forma indiscriminada a diretórios e arquivos. Esse arquivo .aiexclude não diferencia ** ou * em relação a pastas ou arquivos.

No momento, apenas um arquivo .aiexclude é aceito. Para configurar o arquivo .aiexclude, crie um arquivo com o título .aiexclude na raiz da pasta do espaço de trabalho.

Exemplos

Os exemplos a seguir demonstram como configurar um arquivo .aiexclude:

• Bloqueie todos os arquivos com o nome apikeys.txt no diretório do espaço de trabalho ou abaixo dele:

  apikeys.txt
  

• Bloqueie todos os arquivos com a extensão .key no diretório do espaço de trabalho ou abaixo dele:

  *.key
  

• Bloqueie apenas o arquivo apikeys.txt no mesmo diretório do arquivo .aiexclude, mas não em nenhum subdiretório:

  /apikeys.txt
  

• Bloqueie todos os arquivos no diretório my/sensitive/dir e todos os subdiretórios. O caminho precisa ser relativo ao diretório raiz do espaço de trabalho.

  my/sensitive/dir/*
  

Enviar feedback

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

1. Na barra de status, clique em spark Gemini Code Assist e, no menu, selecione Enviar feedback.

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

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

4. Clique em Enviar feedback.

A seguir

• Saiba como escrever comandos melhores.
• Saiba como o Gemini para o Google Cloud usa seus dados.
• Saiba mais sobre os preços do Gemini Code Assist.
• Saiba mais sobre a conformidade do Google Cloud.