Programar com o Gemini Code Assist Standard e Enterprise

Neste documento, descrevemos como usar o Gemini Code Assist Standard e Enterprise, um colaborador com tecnologia de IA no ambiente de desenvolvimento integrado (IDE), para fazer o seguinte no VS Code ou IntelliJ e outros ambientes de desenvolvimento integrado do JetBrains com suporte:

• Gerar código para um projeto com a transformação de código.
• Usar o preenchimento automático enquanto você programa.
• Usar ações inteligentes.

Com o Gemini Code Assist Enterprise, você conta com o recurso de personalização de código, que faz sugestões baseadas na base de código particular da sua organização. Saiba como configurar a personalização de código.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Você precisa ter conhecimento prático sobre VS Code ou IntelliJ e outros ambientes de desenvolvimento integrados do JetBrains com suporte, além de experiência com o Google Cloud. Se preferir, você também pode conhecer o Gemini Code Assist no editor do Cloud Shell, nas Cloud Workstations e no Android Studio.

Observação: o comportamento da geração, conclusão e transformação de código é não determinista quando usado simultaneamente com outros plug-ins que implementam os mesmos atalhos e/ou usam a mesma API de plataforma para processar essas ações.

Antes de começar

VS Code

1. Configure o Gemini Code Assist Standard ou Enterprise, caso ainda não tenha feito isso.

2. Antes de testar os recursos do Gemini Code Assist em um arquivo de código, verifique se há suporte à linguagem de programação do arquivo. Saiba quais são as linguagens de programação com suporte.

3. Se você preferir usar o ambiente de desenvolvimento integrado por trás de um proxy, consulte Conexões de rede no Visual Studio Code.

IntelliJ

1. Configure o Gemini Code Assist Standard ou Enterprise, caso ainda não tenha feito isso.

2. Antes de testar os recursos do Gemini Code Assist em um arquivo de código, verifique se há suporte à linguagem de programação do arquivo. Saiba quais são as linguagens de programação com suporte.

3. Se preferir usar o ambiente de desenvolvimento integrado por trás de um proxy, consulte Proxy HTTP.

Gerar código com comandos

Nas seções a seguir, você vai entender como usar o Gemini Code Assist para gerar código com o comando Function to create a Cloud Storage bucket em um arquivo de código. Também é possível selecionar uma parte do código e pedir ajuda ao Gemini Code Assist pela conversa, além de aceitar ou rejeitar sugestões enquanto você programa.

Enviar um comando de transformação de código ao Gemini Code Assist

Com a transformação de código, é possível usar comandos ou solicitações em linguagem natural no menu de seleção rápida para pedir modificações no código. O recurso também mostra uma comparação das mudanças pendentes. Para enviar um comando de transformação de código ao Gemini Code Assist, siga estas etapas:

VS Code

1. No arquivo de código, em uma nova linha, pressione Control+I (no Windows e no Linux) ou Command+I (no macOS) para abrir o menu de seleção rápida do Gemini Code Assist.

2. No menu, usando o comando /generate, digite /generate function to create a Cloud Storage bucket e pressione Enter (no Windows e no Linux) ou Return (no macOS).

   

   Com base no comando, o Gemini Code Assist gera o código em uma visualização comparativa.

   

3. Opcional: para aceitar essas mudanças, clique em Aceitar.

IntelliJ

1. No arquivo de código, em uma nova linha, pressione Alt+\ (no Windows e no Linux) ou Cmd+\ (no macOS) para abrir o menu de seleção rápida do Gemini Code Assist.

2. No menu, usando o comando /generate, digite /generate function to create a Cloud Storage bucket e pressione Enter (no Windows e no Linux) ou Return (no macOS).

   

   Com base no comando, o Gemini Code Assist gera o código em uma visualização comparativa.

   

3. Opcional: para aceitar essas mudanças, clique em Accept Changes.

   É possível usar os seguintes comandos de transformação de código no ambiente de desenvolvimento integrado:

   • /fix: corrigir problemas ou erros no código. Exemplo: /fix potential NullPointerExceptions in my code.
   • /generate: gerar código. Exemplo: /generate a function to get the current time.
   • /doc: adicionar documentação ao código. Exemplo: /doc this function.
   • /simplify: simplificar o código. Exemplo: /simplify if statement in this code.

Enviar um comando ao Gemini Code Assist com um comentário em um arquivo de código

Se preferir, envie um comando ao Gemini Code Assist com um comentário no arquivo de código. Siga estas etapas:

VS Code

1. Em uma nova linha, digite o comentário Function to create a Cloud Storage bucket e pressione Enter (no Windows e no Linux) ou Return (no macOS).

2. Para gerar código, pressione Control+Enter (no Windows e no Linux) ou Control+Return (no macOS).

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

3. Opcional: para aceitar o código gerado, pressione Tab.

IntelliJ

1. No arquivo de código, em uma nova linha, digite o comentário Function to create a Cloud Storage bucket.

2. Para gerar código, pressione Alt+G (no Windows e no Linux) ou Option+G (no macOS). Ou clique com o botão direito do mouse ao lado do comentário e selecione Gerar código.

   O Gemini Code Assist vai gerar o código abaixo do comentário, 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 como descrito na seção anterior, mude o atalho.

Usar o preenchimento automático de código

Enquanto você programa, o Gemini Code Assist faz sugestões inline, também chamadas de preenchimento automático de código, que você pode aceitar ou ignorar. Para usar o preenchimento automático, siga estas etapas:

VS Code

1. No arquivo de código, em uma nova linha, comece a escrever uma função. Por exemplo, em um arquivo Python, escreva def.

   O Gemini Code Assist vai sugerir código na forma de texto fantasma.

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

IntelliJ

1. No arquivo de código, em uma nova linha, comece a escrever uma função. Por exemplo, em um arquivo Python, escreva def.

   O Gemini Code Assist faz sugestões de código inline.

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

3. Opcional: se quiser mudar a tecla de atalho usada para aceitar sugestões inline, mantenha o cursor do mouse sobre a sugestão e clique no menu suspenso Tab que vai aparecer. Selecione o atalho que preferir ou clique em Custom para inserir seu próprio atalho.

   

Opcional: desativar o preenchimento automático de código

O preenchimento automático de código está ativado por padrão. Se quiser desativar o recurso, siga estas etapas:

VS Code

1. No ambiente de desenvolvimento integrado, clique em Code (macOS) ou File (Windows e Linux) e navegue até Settings > Settings.

2. Na guia Users da caixa de diálogo Settings, acesse Extensions > Gemini Code Assist.

3. Role a tela até encontrar a lista Duet AI: Inline Suggestions: Enable Auto e selecione Off.

   As sugestões inline serão desativadas. Você ainda pode pressionar Control+Enter (no Windows e Linux) ou Control+Return (no macOS) para acionar manualmente as sugestões.

IntelliJ

Na barra de status do ambiente de desenvolvimento integrado, clique em spark Gemini Code Assist: Active e selecione Enable AI Code Completion.

O preenchimento automático de código será desativado, e o Gemini Code Assist só vai fazer sugestões inline se você ativar a configuração de novo.

Usar ações inteligentes

Para aumentar a 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. Selecione código no editor para conferir uma lista de ações relevantes ao contexto.

Para usar ações inteligentes no código, siga estas etapas:

VS Code

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

2. Ao lado do bloco de código selecionado, clique em lightbulb Show Code Actions.

   

3. Selecione uma ação, como Generate unit tests.

   O Gemini Code Assist vai gerar uma resposta com base na ação selecionada.

IntelliJ

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

2. Clique com o botão direito do mouse no código selecionado e escolha uma ação inteligente, como Generate unit tests.

   Quando você seleciona a ação inteligente, uma resposta ao comando é gerada automaticamente na janela de ferramentas Gemini Code Assist.

Usar a correção rápida de transformação de código

Se houver um erro no código, o Gemini Code Assist vai oferecer a opção de aplicar uma correção rápida com transformação de código.

Para aplicar uma correção rápida no arquivo de código, siga estas etapas:

VS Code

1. No arquivo de código, mantenha o cursor do mouse sobre a linha de erro ondulada e selecione Quick Fix e /fix.

   

2. Quando a correção rápida é aplicada, uma visualização comparativa aparece. Para aceitar essas mudanças, clique em Aceitar.

IntelliJ

1. No arquivo de código, clique no ícone de lâmpada vermelha, que indica um erro no código, e selecione Fix with Gemini.

   

2. Quando a correção é aplicada, uma visualização comparativa aparece. Para aceitar essas mudanças, clique em Accept.

Excluir arquivos do contexto local

Por padrão, o Gemini Code Assist exclui arquivos do uso local no contexto para preenchimento, geração, transformação e conversa de código se eles são especificados em um arquivo .aiexclude ou .gitignore.

Saiba como excluir arquivos do uso local no Gemini Code Assist.

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

O Gemini Code Assist atribui crédito quando usa grandes trechos de outra fonte, como código-fonte aberto. Saiba como e quando o Gemini cita fontes.

Para impedir que o Gemini sugira códigos que correspondam às fontes citadas, faça o seguinte:

VS Code

1. Na barra de atividades do ambiente de desenvolvimento integrado, clique em Manage > Settings.

2. Na guia User da janela de configurações, navegue até Extensions > Gemini Code Assist.

3. Role a tela até encontrar Geminicodeassist > Recitation: Max Cited Length.

4. Defina o valor como 0.

O Gemini Code Assist não vai mais sugerir códigos que correspondam a fontes citadas.

IntelliJ

1. Na barra de status do ambiente de desenvolvimento integrado, clique em spark Gemini Code Assist: Active e selecione Configure Gemini.

2. Expanda a seção Advanced settings e selecione Block selections that match external cited sources.

3. Clique em OK.

O Gemini Code Assist não vai mais sugerir códigos que correspondam a fontes citadas.

Problemas conhecidos

Nesta seção, descrevemos os problemas conhecidos do Gemini Code Assist:

VS Code

• Talvez as respostas da conversa sejam truncadas quando incluírem uma versão atualizada de um arquivo aberto grande

  Para contornar esse problema, selecione uma seção menor de código e inclua uma diretiva adicional no comando da conversa, como only output the selected code.

• Vim: só é possível aceitar ou dispensar as sugestões de código no modo de inserção

  Ao usar o plug-in do Vim no modo normal, não é possível aceitar ou dispensar 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.

• Vim: comportamento inconsistente quando o usuário pressiona Esc para dispensar sugestões

  Quando você pressiona Esc, tanto as sugestões do ambiente de desenvolvimento integrado quanto do Gemini Code Assist são dispensadas. É um comportamento diferente do de outros IDEs, em que o Gemini Code Assist é acionado novamente quando você pressiona Esc.

• As tentativas de login expiram

  Se as tentativas de login continuarem expirando, adicione a configuração cloudcode.beta.forceOobLogin ao arquivo settings.json:

   "cloudcode.beta.forceOobLogin": true
  

• Os avisos de recitação de licença não são mantidos de uma sessão a outra

  Se os avisos de recitação de licença não persistirem de uma sessão a outra, consulte os registros permanentes:

  1. Clique em View > Output.

  2. Selecione Gemini Code Assist - Citations.

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

  Se ocorrer um erro de conexão ou outros problemas de conectividade na janela de saída do Gemini Code Assist, faça o seguinte:

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

  • Configure seu firewall para permitir a comunicação por HTTP/2, que o gRPC usa.

  Use a ferramenta grpc-health-probe para testar a conectividade. Se o teste for positivo, o resultado será este:

  $ 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

  Se o teste falhar, o resultado será este:

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

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

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

• A opção "Activate Gemini Code Assist" ainda aparece depois que o usuário 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 da API Gemini para Google Cloud, talvez haja um problema com o servidor LS.

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

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

  2. Clique em Show em qualquer um dos arquivos de registro para mostrar mais detalhes e resolver o problema.

IntelliJ

Não há problemas conhecidos com o Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado com suporte do JetBrains.

Enviar feedback

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

VS Code

1. É possível enviar feedback de uma das seguintes maneiras:

   • Na barra de status, clique em spark Gemini Code Assist. No menu Quick Pick, escolha Send feedback.
   • Abra a paleta de comandos (Ctrl/Command + Shift + P) e selecione Gemini Code Assist: Send Feedback.

2. No formulário, preencha os campos Title e Comments.

3. No formulário Feedback for Gemini Code Assist, selecione uma opção nos menus suspensos Feedback category e Type.

4. Escreva uma descrição detalhada da sua experiência no campo Comment.

5. Inclua os registros do Gemini Code Assist no relatório de feedback. Essa opção está selecionada por padrão.

6. Marque ou desmarque as outras opções, conforme preferir.

7. Clique em Submit Feedback.

IntelliJ

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

2. Depois de enviar um comando ao Gemini Code Assist na conversa, se a resposta não for satisfatória, clique em thumb_down Negative e selecione Send feedback.

3. No campo de texto na parte de cima do formulário, digite o feedback.

4. Se quiser compartilhar seus registros do Gemini Code Assist, selecione os arquivos de registro.

5. Clique em Submit Feedback.

A seguir

• Saiba como criar comandos melhores.
• Saiba como o Gemini para Google Cloud usa seus dados.
• Saiba mais sobre os preços do Gemini Code Assist.
• Saiba mais sobre Google Cloud compliance.