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 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. Instale o plug-in Gemini Code Assist/Cloud Code se ainda não tiver feito isso. O Gemini Code Assist está integrado ao Cloud Code para levar o colaborador com tecnologia de IA ao seu ambiente de desenvolvimento integrado local.
  2. Opcional: se você quiser clonar uma amostra para as tarefas neste documento, instale o Git (em inglês). O Git é necessário para copiar amostras na sua máquina.

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.

Ao selecionar um projeto do Google Cloud sem a API Cloud AI Companion ativada, você receberá uma notificação de erro e será instruído a entrar em contato com seu administrador. Para mais informações, acesse 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.

Para testar os recursos do Gemini Code Assist, abra um aplicativo ou crie um aplicativo de exemplo na próxima seção.

Opcional: criar um aplicativo de amostra

Se quiser usar um app que já existe para testar os recursos do Gemini Code Assist, pule esta seção. Caso contrário, para criar um aplicativo de amostra, siga estas etapas:

  1. No seu ambiente de desenvolvimento integrado, clique em File > New > Project.

  2. No painel esquerdo da janela New Project, selecione Cloud Code: Kubernetes.

  3. Selecione um dos exemplos de Livro de visitas que corresponda à sua linguagem preferida e clique em Próximo.

  4. Digite um nome para o projeto e escolha o local dele.

  5. Clique em Criar.

    O Cloud Code clona o modelo do Python (Flask) e abre o projeto recém-criado 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 uma explicação do seu código atual.

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

  1. Crie um arquivo de código ou use um arquivo de código existente. Se você estiver usando a amostra do Python (Flask), execute essa tarefa no arquivo front.py: na janela de ferramentas Project, navegue até src > frontend e abra o arquivo front.py.

  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, insira 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 do código.

Redefinir histórico de chat

O Gemini Code Assist usa o histórico de chat para dar 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 a seguir mostram como usar o Gemini Code Assist para gerar código com o comando de exemplo # Function to create a Cloud Storage bucket dentro de um arquivo Python. Também é possível receber e aceitar ou rejeitar sugestões de código enquanto você codifica.

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

  1. Crie um novo arquivo ou use um arquivo de código existente. Se você estiver usando a amostra Python (Flask), faça isso no arquivo front.py: no painel Project, navegue até python-reader > src > frontend e abra o arquivo front.py.

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

  3. Para gerar um código, pressione Alt+Shift+\ (no Windows e Linux) ou Option+Shift+\ (macOS). Como alternativa, no gutter do seu 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 Python, o Gemini Code Assist gera o código na forma de texto fantasma.

  4. 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. Crie um novo arquivo ou use um arquivo de código existente. Se você estiver usando a amostra Python (Flask), faça isso no arquivo front.py: no painel Project, navegue até python-reader > src > frontend e abra o arquivo front.py.

  2. 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.

  3. 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