Programar com o Gemini Code Assist

Como uma tecnologia em estágio inicial, o Gemini pode gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide toda a saída do Genmini antes de usá-la. Para mais informações, consulte Gemini para o Google Cloud e IA responsável.

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:

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

• Gerar código para seu projeto.

• Receba sugestões inline enquanto codifica.

O Gemini não usa seus comandos nem as respostas deles como dados para treinar os modelos. Para mais informações, consulte Como o Gemini para o 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 origem 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 citar fontes.

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, também é possível explorar o Gemini Code Assist no Cloud Workstations, Cloud Code para VS Code e Cloud Shell Editor.

Antes de começar

1. Instale o plug-in do Cloud Code, caso ainda não tenha feito isso. O Gemini Code Assist é integrado ao Cloud Code para oferecer o colaborador com tecnologia de IA ao ambiente de desenvolvimento integrado local.
2. Opcional: se você optar por clonar uma amostra para as tarefas deste 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ê 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 de erro e será instruído a entrar em contato com seu administrador. Para mais informações, consulte Configurar o Gemini Code Assist para um projeto.

Para se conectar ao Google Cloud no seu 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 for perguntado se você fez o download do Cloud Code no Google, clique em Fazer login.

   Agora você está conectado 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.

   

2. No menu do 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 amostra na próxima seção.

Opcional: criar um aplicativo de amostra

Se você preferir usar um aplicativo existente para testar os recursos do Genmini 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 uma das amostras do Livro de visitas que corresponda à sua linguagem preferida e clique em Próxima.

   Observação: os exemplos neste documento se referem ao aplicativo de exemplo Python (Flask): livro de visitas (em inglês).

4. Digite um nome e escolha o local do projeto.

5. Clique em Criar.

   O Cloud Code clona o modelo do Python (Flask) e abre seu projeto recém-criado para uso.

Converse com o Gemini Code Assist

Nesta seção, você 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. Crie um arquivo de código ou use um arquivo de código existente. Se você estiver usando a amostra Python (Flask), execute essa tarefa no arquivo front.py: na janela de ferramentas Project, navegue até src > front-end e abra o arquivo front.py.

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

   

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

   Gemini usa o código no arquivo de código 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 oferecer mais contexto ao responder aos comandos.

Se o histórico de chat não for mais relevante para o que você está tentando fazer, redefina o histórico: no painel Gemini Code Assist, clique em excluir Redefinir chat.

Observação :o histórico de chat é redefinido automaticamente quando você troca o espaço de trabalho ou sai do ambiente de desenvolvimento integrado.

Gerar código com comandos

As seções a seguir mostram como usar o Gemini Code Assist para gerar código com o prompt 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 enquanto você programa.

Solicitar o Gemini Code Assist em um arquivo de código

1. Crie um novo arquivo de código ou use um existente. Se você estiver usando o exemplo em Python (Flask), poderá fazer isso no arquivo front.py: no painel Project, navegue até python-playbook > 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 o código, pressione Alt+Shift+\ (para Windows e Linux) ou Option+Shift+\ (macOS). Como alternativa, no gutter do arquivo de código, clique no spark Gemini Code Assist.

   

   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 do teclado para gerar código

Se o atalho de teclado padrão para gerar código não está funcionando como descrito na seção anterior, você pode mudar o atalho seguindo estas etapas:

1. No seu ambiente de desenvolvimento integrado, clique em File (para Windows e Linux) ou em IntelliJ IDEA (para macOS) e navegue até Settings > Keymap > Plugins > Google Cloud Code.

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

3. Clique com o botão direito do mouse em Generate code e selecione Add Keyboard Shortcut.

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

5. Clique em OK.

6. Clique em Apply e, em seguida, clique 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 do teclado.

Receba sugestões inline enquanto escreve

Enquanto você escreve o código, o Gemini Code Assist faz sugestões de código in-line que você pode aceitar ou ignorar. Para testar esse recurso, siga estas etapas:

1. Crie um novo arquivo de código ou use um existente. Se você estiver usando o exemplo em Python (Flask), poderá fazer isso no arquivo front.py: no painel Project, navegue até python-playbook > 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 um 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.

Desativar sugestões de código que correspondam às fontes citadas

Gemini fornece informações de citação quando ela cita diretamente outra fonte, como código fonte aberto. Para mais informações, consulte Como e quando o Gemini cita fontes.

Para evitar que um código correspondente às fontes citadas seja sugerido, modifique a configuração cloudcode.duetAI.recitation.maxCitedLength para 0 em um arquivo settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Testar 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, digite uma das seguintes opções:

• 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 a versão atualizada de um arquivo grande aberto

Para contornar esse problema, selecione uma seção menor de código e inclua uma diretiva adicional 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 vai mostrar a sugestão do Genmini Code Assist.

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

IdeaVim: não é possível aceitar sugestões de geração de código, a menos que 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 enviar 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, insira seu feedback no campo de texto superior.

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

4. Clique em Enviar feedback.

A seguir

• Saiba como escrever comandos melhores.