Programar com o Gemini Code Assist para pessoas físicas

Neste documento, descrevemos como usar o Gemini Code Assist, uma ferramenta de colaboração com tecnologia de IA no ambiente de desenvolvimento integrado (IDE), para ajudar você com o seguinte no VS Code ou IntelliJ e outros IDEs aceitos pela JetBrains:

  • 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 do VS Code ou do IntelliJ e de outros IDEs aceitos pela JetBrains. Você também pode usar o Gemini no Android Studio.

Antes de começar

VS Code

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

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

  3. Se você preferir usar o IDE por trás de um proxy, consulte Conexões de rede no Visual Studio Code (link em inglês).

IntelliJ

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

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

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

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

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

    O Gemini Code Assist abre uma visualização comparativa 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 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).

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

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

    Visualização comparativa da transformação de código no Gemini Code Assist para IntelliJ

  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.

    O Gemini mostra um menu suspenso para você mudar o atalho usado para aceitar sugestões inline.

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 Usuário da caixa de diálogo Configurações, acesse Extensões > 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.

Botão de preenchimento automático de código do Gemini na barra de status do IntelliJ.

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.

Receber sugestões mais relevantes com o contexto do repositório remoto

Você pode receber sugestões de código mais relevantes e contextualizadas direcionando o Gemini Code Assist para se concentrar em repositórios remotos específicos. Ao usar o símbolo @ no chat, você pode selecionar um ou mais repositórios para serem usados como uma fonte principal de contexto para seus comandos. Isso é útil quando você está trabalhando em uma tarefa relacionada principalmente a um conjunto específico de microsserviços, bibliotecas ou módulos.

Para usar um repositório remoto como contexto, siga estas etapas no chat do seu ambiente de desenvolvimento integrado:

  1. Comece o comando com o símbolo @. Uma lista dos repositórios remotos indexados disponíveis vai aparecer.
  2. Selecione na lista o repositório que você quer usar para contexto. Você também pode começar a digitar o nome do repositório para filtrar a lista.
  3. Depois de selecionar o repositório, escreva o restante do comando.

O Gemini Code Assist vai priorizar o repositório selecionado ao gerar uma resposta.

Exemplos de comandos

Esta seção inclui exemplos de como receber sugestões mais relevantes com o contexto do repositório remoto.

  • Entender um repositório
    • @REPOSITORY_NAME What is the overall structure of this repository?
    • @REPOSITORY_NAME I'm a new team member. Can you give me an overview of this repository's purpose and key modules?
  • Gerar e modificar código
    • @REPOSITORY_NAME Implement an authentication function similar to the one in this repository.
    • @REPOSITORY_NAME Refactor the following code to follow the conventions in the selected repository.
    • Use the library-x in @REPOSITORY_A_NAME-A and implement the function-x
  • Teste
    • @UNIT_TEST_FILE_NAME Generate unit tests for module-x based on the examples in the selected file.

Ao usar repositórios remotos como uma fonte de contexto focada, você recebe sugestões mais precisas e relevantes do Gemini Code Assist, o que ajuda a programar com mais rapidez e eficiência.

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.

    O ícone de lâmpada das ações inteligentes aparece quando o usuário seleciona um bloco de código no VS Code.

  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.

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

    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 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 de preenchimento, geração e transformação de código, além da conversa, caso os arquivos sejam 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 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 > 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

  • As respostas da conversa podem ficar truncadas quando incluem uma versão atualizada de um arquivo aberto grande

    Para contornar esse problema, escolha um trecho menor de código e inclua outra diretiva no comando da conversa, como only output the selected code..

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

    Ao usar o plug-in do Vim no modo normal, não é possível aceitar nem dispensar sugestões de código.

    Se quiser contornar esse problema, pressione i para entrar no modo de inserção e, depois, 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 IDE quanto do Gemini Code Assist são dispensadas. Outros IDEs não funcionam da mesma forma, já 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 para outra

    Se os avisos não persistirem de uma sessão para outra, 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 ocorrer um erro de conexão ou outros problemas de conectividade na janela de saída do Gemini Code Assist:

    • 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 é usada pelo gRPC.

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

    $ 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

    Caso o teste falhe, o resultado será:

    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

IntelliJ

Não há problemas conhecidos com o Gemini Code Assist para IntelliJ e outros IDEs aceitos pela JetBrains.

Enviar feedback

Para enviar feedback sobre a sua experiência:

VS Code

  1. É possível enviar feedback destas maneiras:

    • Na barra de status, clique em spark Gemini Code Assist. No menu Opções rápidas, 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 sobre o Gemini Code Assist, escolha uma opção nos menus suspensos Categoria de feedback e Tipo.

  4. No campo Comentário, escreva uma descrição detalhada da sua experiência.

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

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

  7. Clique em Enviar 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 Negativo e selecione Enviar feedback.

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

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

  5. Clique em Enviar feedback.

A seguir