Programar com o Gemini Code Assist

Neste documento, descrevemos como usar O Gemini Code Assist, uma ferramenta com tecnologia de IA colaborador 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 do Google Cloud usa seus dados.

Para ajudar você atender aos requisitos de licença para seu código, O Gemini Code Assist faz citações de fontes quando as sugestões dele citação direta de uma fonte específica. Para saber mais sobre como 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. Ele pressupõe que você Ter conhecimento prático do IntelliJ e do 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 seu código , verifique se a linguagem de codificação do seu arquivo é compatível. Para mais informações sobre linguagens de codificação compatíveis, consulte Linguagens de codificação compatíveis.

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

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

Conecte-se ao Google Cloud e selecione um projeto

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

Se você selecionar um projeto do Google Cloud sem as com a API Cloud AI Companion ativada, você vai receber uma notificação a opção de ativar a API no IDE. Selecione Ativar a API no 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 seu ambiente de desenvolvimento integrado, siga estas etapas:

  1. Inicie seu IDE.

  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 ativado, 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 Cloud Project, 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 o Gemini Code Assist para entender melhor o código-fonte é alterado.

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.

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

Redefinir histórico de chat

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

Caso seu histórico de chat não seja mais relevante para o objetivo, você poderá Se quiser redefinir o histórico de chat: no painel Gemini Code Assist, clique excluir Redefinir chat.

Gerar código com comandos

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

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 (no macOS).

  2. Para gerar um código, pressione Alt+Shift+\ (no Windows e no Linux) ou Option+Shift+\ (macOS). Como alternativa, no gutter do 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 você preferir aceitar uma única linha do o 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ê pode alterar o atalho de teclado seguindo estas etapas:

  1. No seu ambiente de desenvolvimento integrado, clique em Arquivo (para Windows e Linux) ou IntelliJ IDEA (para macOS) e acesse 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 teclado atual. atalho 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 Gemini Code Assist

Para saber mais sobre como alterar atalhos no seu ambiente de desenvolvimento integrado, consulte Configure atalhos do teclado.

Receba sugestões inline enquanto você codifica

Enquanto você escreve o código, o Gemini Code Assist cria código in-line sugestões 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 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 Guia. Caso contrário, para ignorar a sugestão, pressione Esc ou continuar escrevendo seu código.

.

Teste outros exemplos de comandos

Depois de ler seção Gerar código com comandos deste use alguns dos exemplos de comando 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 de 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 diretiva extra no comando 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 o 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.

"Fazer login no Google" ainda aparece após selecionar o projeto do Gemini Code Assist

Se você selecionou seu projeto de acordo com as instruções desta que inclui ativar a API Cloud AI Companion, poderá haver um problema com o servidor LS.

Para saber mais detalhes sobre o problema, faça o seguinte:

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

  2. Selecione os arquivos de registro para ver mais detalhes e ajudar a resolver o problema.

Enviar feedback

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

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

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

  3. Se você quiser compartilhar nos registros do Gemini Code Assist, selecione o registro .

  4. Clique em Enviar feedback.

A seguir