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 seu ambiente de desenvolvimento integrado, para ajudar você a fazer o seguinte no VS Code ou IntelliJ e outros ambientes de desenvolvimento integrados do JetBrains com suporte:

  • Gere código para seu projeto com transformação de código.
  • Receber conclusões de código enquanto programa.
  • Use ações inteligentes.

Se você estiver usando o Gemini Code Assist Enterprise, use a Personalização de código, que permite receber sugestões de código com base na base de código particular da sua organização diretamente do Gemini Code Assist Enterprise. Saiba como configurar a personalização de código.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Ele pressupõe que você tenha conhecimento prático do VS Code ou do IntelliJ e de outros ambientes de desenvolvimento integrado da JetBrains com suporte, além de estar familiarizado com Google Cloud. Se preferir, você também pode conhecer o Gemini Code Assist no editor do Cloud Shell, nas estações de trabalho em nuvem e no Android Studio.

Antes de começar

VS Code

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

  2. Antes de testar os recursos do Gemini Code Assist no seu arquivo de código, verifique se a linguagem de programação do arquivo é aceita. Para mais informações sobre as linguagens de programação compatíveis, consulte Linguagens de programação compatíveis.

  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, se ainda não tiver feito isso.

  2. Antes de testar os recursos do Gemini Code Assist no seu arquivo de código, verifique se a linguagem de programação do arquivo é aceita. Para mais informações sobre as linguagens de programação compatíveis, consulte Linguagens de programação compatíveis.

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

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 arquivo de código. Você também pode selecionar uma parte do código e pedir ajuda ao Gemini Code Assist pelo recurso de chat. Além disso, é possível receber e aceitar ou rejeitar sugestões de código enquanto programa.

Comandar o Gemini Code Assist com transformação de código

Com a transformação de código, é possível usar comandos ou solicitações de linguagem natural no menu de seleção rápida para pedir modificações no código e receber uma visualização de diff que mostra as mudanças pendentes. Para pedir ao Gemini Code Assist uma transformação de código, siga estas etapas:

VS Code

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

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

    O Gemini Code Assist gera código com o comando /generate.

    O Gemini Code Assist gera o código com base no seu comando em uma visualização de diff.

    O Gemini Code Assist abre uma visualização de diff para mostrar o código gerado.

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

    Função de geração de transformação de código no Gemini Code Assist do IntelliJ

    O Gemini Code Assist gera o código com base no seu comando em uma visualização de diff.

    Visualização de diff da transformação de código no Gemini Code Assist do IntelliJ

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

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

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

Ativar o Gemini Code Assist em um arquivo de código com um comentário

Se preferir, você também pode ativar o Gemini Code Assist no arquivo de código com um comentário seguindo 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 gera 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). Como alternativa, clique com o botão direito do mouse ao lado do comentário e selecione Gerar código.

    O Gemini Code Assist gera o código abaixo do seu 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, você pode mudar o atalho de teclado.

Receber preenchimentos de código

Enquanto você escreve o código, o Gemini Code Assist faz sugestões inline, também conhecidas como preenchimentos de código, que podem ser aceitas ou ignoradas. Para receber complementações de código, siga estas etapas:

VS Code

  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 Code Assist 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, pressione Esc ou continue a escrever o código.

IntelliJ

  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 Code Assist sugere código na forma de uma sugestão inline.

  2. Para aceitar a sugestão de código do Gemini Code Assist, pressione Tab. Caso contrário, pressione Esc ou continue a escrever o código.

  3. Opcional: se você preferir usar uma tecla de atalho diferente para aceitar a sugestão inline, mantenha o ponteiro sobre ela e clique no menu suspenso Tab que aparece. Em seguida, selecione o atalho que preferir ou clique em Personalizado para inserir seu próprio atalho.

    O Gemini oferece um menu suspenso para mudar o atalho e aceitar uma sugestão inline.

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

O preenchimento de código está ativado por padrão. Se quiser desativar a conclusão de código, 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 Usuário da caixa de diálogo Configurações, navegue até Extensões > Gemini Code Assist.

  3. Role a tela até encontrar a lista Duet AI: sugestões inline: ativar automático 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.

IntelliJ

Na barra de status do seu ambiente de desenvolvimento integrado, clique em spark Gemini Code Assist: Ativo e selecione Ativar o preenchimento automático de código com IA.

Botão de conclusão de código do Gemini na barra de status do IntelliJ.

Isso desativa a configuração de preenchimento de código, e o Gemini Code Assist não faz mais sugestões inline até que você ative a configuração novamente.

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 direto 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:

VS Code

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

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

    O ícone de lâmpada das ações inteligentes aparece depois que você seleciona um bloco de código no VS Code.

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

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

IntelliJ

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

  2. Clique com o botão direito do mouse no código selecionado e escolha uma ação inteligente, como Gerar testes de unidade.

    Ao selecionar a ação inteligente, o Gemini Code Assist vai gerar automaticamente uma resposta ao comando na janela de ferramentas Gemini Code Assist.

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

Se houver um erro no seu 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 ponteiro sobre a linha de erro ondulada e selecione Correção rápida e depois /fix.

    Correção rápida de transformação de código no ambiente de desenvolvimento integrado.

  2. Quando a correção rápida é aplicada, uma visualização de diff 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 Corrigir com o Gemini.

    Opção de transformação de código para corrigir com o Gemini no ambiente de desenvolvimento integrado.

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

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 por chat de código se eles forem especificados em um arquivo .aiexclude ou .gitignore.

Para saber como excluir arquivos do uso local, consulte Excluir arquivos do uso do Gemini Code Assist.

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

O Gemini Code Assist fornece informações de citação quando cita diretamente e por extenso outra fonte, como um código de código aberto. Para mais informações, consulte Como e quando o Gemini cita fontes.

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

  1. Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em Gerenciar > Configurações.

  2. Na guia Usuário da janela de configurações, navegue até Extensões > Gemini Code Assist.

  3. Role a tela até encontrar Geminicodeassist > Recitação: comprimento máximo citado.

  4. Defina o valor como 0.

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

Problemas conhecidos

Esta seção descreve os problemas conhecidos do Gemini Code Assist:

VS Code

  • As respostas do chat podem ser truncadas quando incluem 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 do chat, como only output the selected code.

  • Vim: não é possível aceitar ou dispensar sugestões de geração de código, a menos que esteja no modo de inserção

    Ao usar o plug-in 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, em seguida, pressione Tab para aceitar a sugestão.

  • Vim: comportamento inconsistente ao pressionar Esc para dispensar sugestões

    Quando você pressiona Esc, as sugestões do ambiente de desenvolvimento integrado e do Gemini Code Assist são dispensadas. Esse comportamento é diferente do comportamento sem o Vim, em que pressionar Esc reativa o Gemini Code Assist.

  • 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 entre as sessões

    Se os avisos de recitação de licença não persistirem entre as sessões, consulte os registros permanentes:

    1. Clique em Visualizar > Saída.

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

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

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

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

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

    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 sem sucesso resulta na seguinte saída:

    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 "Ativar o Gemini Code Assist" ainda aparece depois de selecionar 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 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.

IntelliJ

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

Enviar feedback

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

VS Code

  1. Você pode deixar feedback de uma das seguintes maneiras:

    • Na barra de status, clique em spark Gemini Code Assist e, no menu Seleção rápida, escolha Enviar feedback.
    • Abra a paleta de comandos (Ctrl/Command + Shift + P) e selecione Gemini Code Assist: enviar feedback.
  2. No formulário, preencha os campos Título e Comentários.

  3. No formulário Feedback para o Gemini Code Assist, selecione uma opção nos menus suspensos Categoria do feedback e Tipo.

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

  5. Inclua os registros do Gemini Code Assist no seu relatório de feedback. Por padrão, essa opção é selecionada.

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

  7. Clique em Enviar feedback.

IntelliJ

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

  2. Depois de enviar um comando para o Gemini Code Assist no chat, se você não estiver satisfeito com a resposta, clique em thumb_down Negativo e selecione Enviar feedback.

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

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

  5. Clique em Enviar feedback.

A seguir