Programar com o Gemini Code Assist

Neste documento, descrevemos como usar o Gemini Code Assist, um colaborador com tecnologia de IA no Google Cloud, para ajudar você a fazer o seguinte no Cloud Code:

  • Fornecer orientações para ajudar você 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 para o Google Cloud usa seus dados.

Para ajudar você a cumprir todos os requisitos de licença do seu 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 você a gerar código e cita fontes.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Você precisa ter conhecimento prático do IntelliJ e familiaridade com o Google Cloud. Se preferir, conheça 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 seu arquivo de código, verifique se a linguagem de programação dele tem suporte. Para mais informações sobre as linguagens de programação compatíveis, consulte Linguagens de codificação compatíveis.

  2. Instale a extensão Gemini Code Assist/Cloud Code, caso ainda não tenha feito isso. O Cloud Code se integra ao Gemini Code Assist no seu ambiente de desenvolvimento integrado.

Conecte-se ao Google Cloud e selecione um projeto

Nesta seção, você vai se conectar ao Google Cloud e selecionar um projeto do Google Cloud com a API Cloud AI Companion ativada no ambiente de desenvolvimento integrado.

Se você selecionar um projeto do Google Cloud sem a API Cloud AI Companion ativada, receberá uma notificação com a opção de ativar a API no ambiente de desenvolvimento integrado. Selecione Ativar a API na janela de notificação para ativar a API no projeto. Para mais informações, consulte Configurar o Gemini Code Assist para um projeto.

Para se conectar ao Google Cloud no ambiente de desenvolvimento integrado, siga estas etapas:

  1. Inicie seu ambiente de desenvolvimento integrado.

  2. Clique em Ferramentas > Google Cloud Code > Fazer login no Google Cloud Platform.

  3. Siga as instruções para fazer login na sua Conta do Google.

  4. Quando aparecer a mensagem perguntando se você fez o download do Cloud Code do Google, clique em Fazer login.

    Você se conectou ao Google Cloud.

Em seguida, para selecionar um projeto do Google Cloud que tenha a API Cloud AI Companion ativada, siga estas etapas:

  1. Na barra de status do Gemini Code Assist, clique em Gemini Code Assist.

    Botão na barra de status do Gemini.

  2. No menu Gemini Code Assist, selecione Configurações.

  3. No campo Projeto do Cloud, clique em more_horiz Selecionar projeto do Google Cloud e selecione um projeto que tenha a API Cloud AI Companion ativada.

    O Gemini está pronto para uso.

Conversar com o Gemini Code Assist

Nesta seção, você vai aprender a abrir o painel Gemini Code Assist e conversar com ele para entender melhor seu código.

Para começar a conversar com o Gemini, siga estas etapas:

  1. Abra o arquivo de código.

  2. Na barra de status, clique em Gemini Code Assist e selecione Abrir chat.

    O botão do Gemini na barra de status do Cloud Code mostra a opção "Abrir conversa".

  3. Na janela de chat do Gemini Code Assist, digite o comando Explain this code to me e clique em Enviar.

    O Gemini usa o código do seu arquivo como referência ao comando e responde com uma explicação.

Redefinir histórico de chat

O Gemini Code Assist usa o histórico de chat para ter mais contexto ao responder aos seus comandos.

Se o histórico de chat não for mais relevante para o que você quer, redefina o histórico de chat. No painel Gemini Code Assist, clique em Excluir Redefinir chat.

Gerar código com comandos

As seções abaixo mostram como usar o Gemini Code Assist para gerar código com o comando de exemplo Function to create a Cloud Storage bucket no seu arquivo de código. Você também pode 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 enquanto você programa.

Criar um comando para o Gemini Code Assist em um arquivo de código

  1. No arquivo de código, em uma nova linha, digite o comentário Function to create a Cloud Storage bucket e pressione Enter (para Windows e Linux) ou Return (para macOS).

  2. Para gerar um código, pressione Alt+Shift+\ (no Windows e Linux) ou Option+Shift+\ (macOS). Como alternativa, no gutter do arquivo de código, clique em spark no Gemini Code Assist.

    O gutter no Cloud Code mostra o ícone "Gerar código com o Gemini".

    Ao lado do texto do comando no arquivo de código, o Gemini Code Assist gera o código na forma de texto fantasma.

  3. Opcional: para aceitar o código gerado, pressione Tab. Se preferir aceitar uma única linha do código gerado, pressione Shift+Enter.

Opcional: mudar o atalho de 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, você poderá mudar o atalho seguindo estas etapas:

  1. No seu ambiente de desenvolvimento integrado, clique em Arquivo (para Windows e Linux) ou IntelliJ IDEA (para macOS) e navegue até Configurações > Mapa de teclado > Plugins > Google Cloud Code.

  2. Na lista de atalhos de teclado, role até encontrar Gerar código.

  3. Clique com o botão direito do mouse em Gerar código e selecione Adicionar atalho de teclado.

  4. Na caixa de diálogo Atalhos do teclado, clique duas vezes no atalho atual e insira seu próprio atalho.

  5. Clique em OK.

  6. Clique em Apply e depois em OK.

    Agora você pode usar o atalho de teclado recém-atribuído para gerar código com o Gemini Code Assist.

Para saber mais sobre como mudar atalhos no ambiente de desenvolvimento integrado, consulte Configurar atalhos de teclado.

Receba sugestões inline enquanto você codifica

Enquanto você escreve o código, o Gemini Code Assist faz sugestões de código inline que você pode aceitar ou ignorar. Para testar esse recurso, 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 sugere código na forma de texto fantasma.

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

Teste outros exemplos de comandos

Depois de ler a seção Gerar código com comandos deste documento, tente alguns dos comandos de exemplo a seguir.

No painel de chat do Gemini Code Assist, insira uma das seguintes comandos:

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

Problemas conhecidos

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

As respostas do chat podem ficar truncadas quando incluem uma versão atualizada de um arquivo grande aberto.

Para contornar esse problema, selecione uma seção menor do código e inclua uma outra diretiva na solicitação de chat, como only output the selected code.

IdeaVim: o plug-in não mostra a sugestão do Gemini Code Assist ao pressionar Esc para dispensar a sugestão do IntelliJ

Ao usar o plug-in IdeaVim no IntelliJ, se você pressionar Esc para dispensar a sugestão do IntelliJ, ele vai para o modo de comando VIM e não mostra a sugestão do Gemini Code Assist.

O Gemini Code Assist funciona como esperado no modo de inserção.

IdeaVim: não é possível aceitar sugestões de geração de código a menos que estejam no modo de inserção

Ao usar o plug-in IdeaVim no modo normal, você não pode aceitar sugestões de código.

Para contornar esse problema, pressione i para entrar no modo de inserção e pressione Tab para aceitar a sugestão.

Para dispensar a sugestão, pressione Esc.

Enviar feedback

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

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

  2. No formulário, digite seu feedback no campo de texto superior.

  3. Se quiser compartilhar seus registros do Gemini Code Assist, selecione as opções de registro.

  4. Clique em Enviar feedback.

A seguir