Programar com o Gemini Code Assist

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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

A personalização de código permite receber sugestões de código baseadas na base de código particular da sua organização diretamente do Gemini Code Assist. Saiba como configurar a personalização do código.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. É necessário ter conhecimento prático do Editor do Cloud Shell e familiaridade com Google Cloud. Se preferir, conheça o Gemini Code Assist no Cloud Workstations, Cloud Code para IntelliJ e Cloud Code para VS Code.

Conecte-se a Google Cloud e selecione um projeto

Nesta seção, você vai se conectar a Google Cloud e selecionar um projeto doGoogle Cloud com a API Gemini para Google Cloud ativada no editor do Cloud Shell.

Se você selecionar um projeto Google Cloud sem a API Gemini para Google Cloud ativada, vai 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 a Google Cloud no Editor do Cloud Shell, siga estas etapas:

1. Inicie o editor do Cloud Shell

2. Se você estiver usando o Editor legado, clique em Testar o novo Editor.

3. Na barra de status, clique em Cloud Code - Fazer login.

   

4. Se for preciso autorizar o editor do Cloud Shell a fazer chamadas de API Google Cloud, clique em Autorizar.

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

   Você se conectou a Google Cloud.

Em seguida, para selecionar um Google Cloud projeto com a API Gemini para Google Cloud ativada, siga estas etapas:

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

   

2. No menu Gemini Code Assist, selecione Selecionar projeto do Gemini Code.

3. Selecione um projeto Google Cloud com a API Gemini para Google Cloud 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 atividades do Editor do Cloud Shell, clique em spark Gemini Code Assist.

3. No painel Gemini Code Assist, insira o comando Explain this code to me e clique em send Enviar.

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

   Para se referir a um bloco de código específico em vez de todo o código do arquivo, selecione o bloco no seu arquivo de código e solicite ao Gemini.

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 delete 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 no seu 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.

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 Control+Enter (para Windows e Linux) ou Control+Return (para macOS).

   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.

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. No Editor do Cloud Shell, clique em menu Menu e navegue até Arquivo > Preferências > Atalhos de teclado.

2. Na lista de atalhos de teclado, pesquise Cloud Code: Generate Code.

3. Clique em Cloud Code: gerar código e depois em edit Alterar vinculação de chaves.

4. Na caixa de diálogo exibida, insira seu próprio atalho.

5. Pressione Enter (no Windows e Linux) ou Return (no macOS).

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

Fazer comandos no Gemini Code Assist com o código selecionado pelo chat

O Gemini Code Assist pode realizar tarefas ou responder às suas 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 o painel Gemini Code Assist.

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

3. No campo de texto do painel Gemini Code Assist, insira 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 usa o código selecionado como referência e responde ao seu comando.

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.

Opcional: desativar sugestões in-line

Se preferir desativar as sugestões inline no Gemini Code Assist, siga estas etapas:

1. No Editor do Cloud Shell, selecione menu Menu e navegue até Arquivo > Preferências > Configurações.

2. Na guia Usuário da caixa de diálogo Configurações, navegue até Extensões > Cloud Code.

3. Role até encontrar a lista Cloudcode: Gemini Code Assist: sugestões inline: ativar automaticamente e selecione Desativado.

   Isso desativa as sugestões inline. Você ainda pode pressionar Control+Enter (para Windows e Linux) ou Control+Return (para macOS) para acionar manualmente as sugestões inline.

Opcional: excluir arquivos do contexto com um arquivo .aiexclude

É possível criar um arquivo .aiexclude para impedir que arquivos sejam considerados pelo Gemini Code Assist para contexto. Um arquivo .aiexclude segue a sintaxe de um arquivo .gitignore, com as seguintes diferenças:

• Um arquivo .aiexclude vazio ou inexistente bloqueia arquivos no diretório dele e em todos os subdiretórios.
• Um arquivo .aiexclude não oferece suporte à negação, em que você prefixa padrões com um ponto de exclamação (!).
• Um arquivo .aiexclude faz a correspondência exata com o caractere *. Isso haverá correspondência indiscriminada em diretórios e arquivos. Esse arquivo .aiexclude não diferencia ** ou * em relação a pastas ou arquivos.

No momento, só é possível usar um único arquivo .aiexclude. Para configurar o arquivo .aiexclude, crie um arquivo chamado .aiexclude na raiz da pasta do espaço de trabalho. Se você quiser colocar esse arquivo fora da raiz do espaço de trabalho ou renomeá-lo, o caminho poderá ser definido nas configurações do VS Code em "Arquivo de exclusão de contexto". O valor do caminho fornecido nessa configuração será resolvido em relação à pasta raiz do espaço de trabalho aberto.

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 que o arquivo .aiexclude, mas 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/*
  

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

O Gemini fornece informações de citação ao citar uma outra fonte, como um código aberto. Para mais informações, consulte Como e quando o Gemini cita fontes.

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

"geminicodeassist.recitation.maxCitedLength": 0

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 seu código, siga estas etapas:

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

2. Ao lado do bloco de código selecionado, clique em lightbulb Mostrar ações de código.

   

3. Selecione uma ação, como Gerar testes de unidade.

   O Gemini gera uma resposta com base na ação selecionada.

Usar a transformação de código

O Gemini Code Assist oferece transformação de código, que permite selecionar uma parte do arquivo de código e solicitar modificações no código usando comandos em linguagem natural usando uma caixa de texto inline.

Com a transformação de código, é possível fazer o seguinte:

• Gere linhas de comentários para documentar seu código
• Resolver problemas no código
• Melhorar a legibilidade do código
• Tornar o código mais eficiente

Você também pode conferir as fontes de contexto de uma resposta gerada no painel Gemini: Chat.

Criar um comando para o Gemini Code Assist com a caixa de texto inline

A caixa de texto inline permite interagir com o Gemini Code Assist diretamente no arquivo de código.

Para abrir a caixa de texto inline e o comando para o Gemini, siga estas etapas:

1. No arquivo de código, pressione Ctrl + I (para Windows e Linux) ou Command + I (para macOS).

2. Digite um prompt, como Write a function to create a Cloud Storage bucket, e pressione Enter (no Windows e Linux) ou Return (no macOS).

   O Gemini Code Assist gera o código com base no seu comando.

Conferir diferenças do código refatorado

Com a visualização de diferenças integrada à caixa de texto inline, é possível conferir as mudanças sugeridas pelo Gemini e o código original. Aceite ou descarte as alterações sugeridas.

Para conferir as diferenças do código refatorado na caixa de texto inline, siga estas etapas:

1. No arquivo de código, selecione uma função e abra a caixa de texto inline pressionando Control+I (para Windows e Linux) ou Command+I (para macOS).

2. Digite um prompt, como Add comments, e pressione Enter (no Windows e Linux) ou Return (no macOS).

   Quando o Gemini gera o código muda para a função selecionada, a visualização de diferenças aparece.

   

3. Para aceitar ou descartar as mudanças, clique em Aceitar ou Descartar.

Conferir origens de contexto de uma resposta gerada

O recurso de exibição de contexto lista os arquivos de projeto (as origens de contexto) que foram usados como referência para gerar respostas aos seus comandos. Saber quais arquivos foram usados como referências ajuda a refinar seus comandos e receber respostas mais específicas. As fontes de contexto aparecem sempre que você usa as conversas no Gemini.

Para conferir as origens de contexto da resposta gerada, no painel Gemini: Chat, role até encontrar o snippet Fontes de contexto. Expanda o snippet para ver todas as fontes de contexto.

Usar comandos inteligentes

Os comandos inteligentes podem ser usados na caixa de texto inline para executar ações específicas no código.

Para conferir uma explicação de todo o arquivo de código com o comando inteligente /explain, siga estas etapas:

1. No arquivo de código, abra a caixa de texto inline pressionando Control + I (para Windows e Linux) ou Command + I (para macOS).

2. Pressione / para ver a lista de comandos inteligentes e as descrições deles.

3. Selecione /explain.

   O Gemini gera uma explicação de todo o arquivo de código na caixa de texto inline.

4. Opcional: para conferir a resposta gerada no painel Gemini: Chat, clique em Abrir no Chat.

Ver histórico de solicitações

O acesso ao histórico de solicitações economiza tempo quando você precisa inserir os mesmos comandos em um arquivo de código grande.

Para acessar o histórico de solicitações, no arquivo de código, abra a caixa de texto inline pressionando Ctrl + I (no Windows e Linux) ou Command + I (no macOS) e depois em Control + seta para cima (no Windows e Linux) ou Command + seta para cima (no macOS). Assim, você pode revisar seus comandos mais antigos e reutilizar quando precisar.

Melhorar a legibilidade do código para falantes não nativos de inglês

Se você não é falante de inglês nativo e depende de aplicativos de tradução, use a caixa de texto inline para gerar comentários em outros idiomas.

Para converter comentários em inglês para outro idioma ou adicionar comentários em outro idioma, siga estas etapas:

1. No arquivo de código, selecione o código em que você quer adicionar comentários.

2. Abra a caixa de texto inline pressionando Control + I (no Windows e Linux) ou Command + I (no macOS).

3. Digite um prompt, como Add spanish comments, e pressione Enter (para Windows e Linux) ou Return (para macOS).

   O Gemini gera comentários no idioma especificado no comando e compara as sugestões.

4. Para aceitar ou descartar essas mudanças no código, clique em Aceitar ou Descartar.

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.

Receber uma explicação do código

1. No arquivo de código, selecione uma função que você queira explicar.

2. No painel Gemini Code Assist, insira o comando Explain this code to me.

   O Gemini usa o código selecionado como referência e responde com uma explicação da função selecionada.

Gerar planos de teste

1. No arquivo de código, selecione o código em que você quer adicionar testes de unidade.
2. No painel Gemini Code Assist, insira o comando Write unit tests for my code.

Receber ajuda com a depuração do código

1. No arquivo de código, selecione o código que você quer depurar.
2. No painel Gemini Code Assist, insira o comando Help me debug my code.

Tornar seu código mais legível

1. No arquivo de código, selecione aquele que você quer facilitar a leitura.

2. No painel Gemini Code Assist, insira o comando Make my code more readable.

   Se você preferir se concentrar em uma parte específica do código, selecione a parte preferida antes de enviar o comando.

Problemas conhecidos

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

Os avisos de recitação de licença não são mantidos nas sessões

Se os avisos de leitura de licença não persistirem nas sessões, consulte os registros persistentes:

1. Clique em menu Menu > View > Output.

2. Selecione Gemini Code Assist - Citações.

Problemas de conectividade na janela de saída do Gemini Code Assist

Se você receber um erro de conexão ou outros problemas de conectividade na janela de saída do Gemini Code Assist, tente o seguinte:

• Configure o firewall para permitir acesso a oauth2.googleapis.com e cloudaicompanion.googleapis.com.

• Configure o firewall para permitir a comunicação por HTTP/2, que é usada pelo gRPC.

Use a ferramenta grpc-health-probe para testar a conectividade. Uma verificação bem-sucedida resulta na seguinte saída:

$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

Uma verificação malsucedida resulta na seguinte saída:

timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

Para ver mais detalhes, execute o seguinte antes de grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

A mensagem "Ativar o Gemini Code Assist" ainda aparece depois que você seleciona o projeto do Gemini Code Assist

Se você selecionou seu projeto de acordo com as instruções deste guia, que incluem a ativação do Gemini para a API Google Cloud, pode haver um problema com o servidor do LS.

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

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

2. Clique em Mostrar em qualquer um dos 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, no menu Escolha rápida, selecione Enviar feedback.

2. No formulário, preencha os campos Título e Comentários.

3. Se você quiser compartilhar os registros do Skaffold ou do AI Companion, selecione a opção Enviar registros do Skaffold ou Enviar registros do AI Companion.

4. Clique em Enviar feedback.

A seguir

• Saiba como escrever comandos melhores.