Programar com o Gemini Code Assist

Este documento descreve como usar o Gemini Code Assist, uma ferramenta de colaboração com tecnologia de IA no Google Cloud, para ajudar a realizar as seguintes ações no VS Code ou IntelliJ e em outros ambientes de desenvolvimento integrados do JetBrains com suporte:

  • Oferecer orientações para ajudar a resolver problemas com o 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.

Para ajudar você a obedecer a todos os requisitos de licença do código, o Gemini Code Assist fornece citações de fontes 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 cita fontes.

A personalização de código permite receber sugestões de código com base na base de código particular da sua organização diretamente do Gemini Code Assist. 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 do JetBrains com suporte e que você esteja familiarizado com Google Cloud. Se preferir, você também pode conferir o Gemini Code Assist no editor do Cloud Shell e nas estações de trabalho do Cloud.

Antes de começar

VS Code

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

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

IntelliJ

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

  2. Se você preferir usar o ambiente de desenvolvimento integrado por um proxy, consulte Proxy HTTP.

Instalar o plug-in do Gemini Code Assist

Para instalar o plug-in do Gemini Code Assist no seu ambiente de desenvolvimento integrado, siga estas etapas:

VS Code

  1. Para abrir a visualização Extensions no VS Code, clique em Ícone de extensão Extensions ou pressione Ctrl/Cmd+Shift+X.

  2. Pesquise Gemini Code Assist.

  3. Clique em Instalar.

  4. Se solicitado, reinicie o VS Code.

    Depois que a extensão for instalada, o Gemini Code Assist vai aparecer na barra de atividades e estará pronto para uso. É possível definir outras configurações da instalação do Gemini Code Assist especificando suas preferências na barra de tarefas do aplicativo: acesse Code > Settings > Settings > Extensions e pesquise Gemini Code Assist.

IntelliJ

  1. Clique em settings IDE e Configurações do projeto > Plugins.
  2. Na guia Marketplace, pesquise Gemini Code Assist.
  3. Clique em Instalar para instalar o plug-in.
  4. Quando a instalação for concluída, clique em Restart IDE.
  5. Quando o ambiente de desenvolvimento integrado é reiniciado, o Gemini Code Assist aparece na barra de atividades.

    O ícone do Gemini Code Assist aparece na barra de atividades

Agora você já pode usar o Gemini Code Assist no seu ambiente de desenvolvimento integrado.

Faça login no Google e selecione um Google Cloud projeto

Nesta seção, você faz login na sua Conta do Google e, se for a primeira vez que você usa o Gemini Code Assist no seu ambiente de desenvolvimento integrado, selecione um projetoGoogle Cloud .

VS Code

Se você selecionar um Google Cloud projeto sem a API Gemini para o 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.

Se você preferir seguir o tutorial Programar com o Gemini Code Assist diretamente no seu ambiente de desenvolvimento integrado, clique em Launch VS Code e siga as etapas no tutorial para se conectar ao Google Cloud e ativar o Gemini Code Assist.

Iniciar o VS Code

Caso contrário, siga estas etapas:

  1. Inicie o ambiente de desenvolvimento integrado.

  2. Na barra de atividades, clique em Gemini Code Assist.

  3. No painel de chat do Gemini Code Assist, clique em Fazer login no Google Cloud.

  4. Quando solicitado a permitir que o Gemini Code Assist abra o site externo, clique em Abrir.

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

  6. Quando perguntarem se você fez o download do Gemini Code Assist do Google, clique em Fazer login.

    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:

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

    A barra de status do Gemini está disponível.

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

  9. Selecione um Google Cloud projeto com a API Gemini para Google Cloud ativada.

    O Gemini Code Assist está pronto para uso.

    O ícone Gemini na barra de status está definido como normal.

IntelliJ

Para fazer login na sua Conta do Google, siga estas etapas:

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

  2. Clique em Fazer login no Google.

  3. Na página que abrir no navegador da Web, selecione sua Conta do Google.

  4. Na tela que pede para você confirmar se fez o download do app pelo Google, clique em Fazer login.

    O Gemini Code Assist agora tem autorização para acessar sua conta.

    Em seguida, se esta for a primeira vez que você usa o Gemini no seu ambiente de desenvolvimento integrado, selecione um projeto Google Cloud seguindo estas etapas:

  5. Volte ao seu ambiente de desenvolvimento integrado. Na janela da ferramenta Gemini Code Assist, se você permitir que o Google ative as APIs necessárias para usar o Gemini Code Assist em seu nome para o projeto selecionado, clique em Selecionar um projeto do GCP para continuar.

  6. Na caixa de diálogo Select Google Cloud Project, pesquise e selecione o projeto Google Cloud . Em seguida, clique em OK.

  7. Clique em FINALIZAR.

Seu projeto Google Cloud é selecionado com a API Gemini Code Assist ativada. Você já pode usar o Gemini no seu ambiente de desenvolvimento integrado.

Conversar com o Gemini Code Assist

Nesta seção, você vai pedir ao Gemini Code Assist para fornecer uma explicação do código atual.

VS Code

Para receber uma explicação do código, siga estas etapas:

  1. Abra o arquivo de código.

  2. Na barra de atividades do seu ambiente de desenvolvimento integrado, 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 no arquivo como referência para o comando e responde com uma explicação do código.

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

IntelliJ

Para receber uma explicação do código, siga estas etapas:

  1. No ambiente de desenvolvimento integrado, abra o arquivo de código.

  2. Na janela da ferramenta Gemini Code Assist, digite o comando Explain this code to me e clique em Enviar.

O Gemini Code Assist usa o código no arquivo como referência para o comando e responde com uma explicação do código.

Se você quiser uma explicação de uma parte específica do código, selecione esse código e solicite o Gemini Code Assist novamente. O Gemini Code Assist só vai usar o código selecionado como referência para a resposta gerada.

Quando o Gemini Code Assist fornece um código na resposta, você pode selecionar as seguintes opções listadas no final da resposta:

  • Inserir no cursor: insere o código gerado no arquivo atual na posição atual do cursor.

  • Inserir em um novo arquivo: abre um novo arquivo e insere o código gerado nele.

    O Gemini lista as ações de código no final de uma resposta de código gerada.

Essas opções ficam disponíveis quando o Gemini Code Assist identifica a linguagem usada no bloco de código e se ela é compatível com o seu ambiente de desenvolvimento integrado atual.

Conferir o histórico de consultas

Se você quiser reutilizar os comandos anteriores, encontre-os no Query History na janela de ferramentas do Gemini Code Assist clicando em schedule Show Query History.

Histórico de consultas do Gemini na janela de ferramentas.

Redefinir o histórico de chat

O Gemini Code Assist usa o histórico de chat para mais contexto ao responder aos seus comandos. Se o histórico de chat não for mais relevante para o que você está tentando fazer, redefina o histórico de chat:

VS Code

No painel Gemini Code Assist, clique em delete Reiniciar conversa.

IntelliJ

Na janela de ferramentas do Gemini Code Assist, clique em delete Limpar histórico de conversas. Isso também limpa seu histórico de consultas.

Botão para limpar o histórico de conversas na janela de ferramentas do Gemini.

Gerar código com comandos

As seções a seguir mostram como usar o Gemini Code Assist para gerar código com o exemplo de comando Function to create a Cloud Storage bucket no 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.

VS Code

Como usar o Gemini Code Assist com a transformação de código

A transformação de código permite usar comandos ou solicitações de linguagem natural no menu de seleção rápida para solicitar modificações no código e oferece uma visualização de diferença para mostrar as mudanças pendentes no código. Para solicitar o Gemini Code Assist com a transformação de código, siga estas etapas:

  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 a barra Gemini Code Assist Quick Pick.

  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.

    O Gemini Code Assist gera o código com base na solicitação em uma visualização de diferença.

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

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

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

Se preferir, também é possível ativar o Gemini Code Assist no seu arquivo de código com um comentário seguindo estas etapas:

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

Ativar o Gemini Code Assist com o código selecionado usando o chat

O Gemini Code Assist pode realizar tarefas ou responder a 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 escreve um teste de unidade para uma função selecionada.

    O Gemini usa o código selecionado como referência e responde ao comando.

IntelliJ

Como usar o Gemini Code Assist com a transformação de código

A transformação de código permite usar comandos ou comandos de linguagem natural no menu de seleção rápida para solicitar modificações no código e oferece uma visualização de diferença para mostrar as alterações pendentes no código. Para solicitar a transformação de código no Gemini Code Assist, siga estas etapas:

  1. No arquivo de código, em uma nova linha, pressione Alt+A (no Windows e no Linux) ou Cmd+A (no macOS) para abrir o menu Gemini Code Assist Quick Pick.

  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 IntelliJ Gemini Code Assist

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

    Visualização de diferença de transformação de código no IntelliJ Gemini Code Assist

  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: corrigir problemas ou erros no código. Exemplo: /fix potential NullPointerExceptions in my code.
    • /generate: gera o código. Exemplo: /generate a function to get the current time.
    • /doc: adicione documentação ao 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

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

  2. Para gerar o 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.

Ativar o Gemini Code Assist com o código selecionado usando o chat

O Gemini Code Assist pode realizar tarefas ou responder a 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 a janela de ferramentas Gemini Code Assist.

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

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

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:

VS Code

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

  2. Na lista de atalhos de teclado, role até encontrar Gemini Code Assist: Generate code.

  3. Clique em Gemini Code Assist: Generate Code e em edit Change Keybinding.

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

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

    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 os atalhos no seu ambiente de desenvolvimento integrado, consulte Vinculações de tecla para o Visual Studio Code.

IntelliJ

  1. Navegue até settings Configurações do ambiente de desenvolvimento integrado e do projeto > Configurações > Mapa de teclado > Assistente de código Gemini.

  2. Clique com o botão direito do mouse em Gemini Code Assist e selecione Adicionar atalho ao teclado.

  3. Insira o atalho de teclado que preferir e clique em OK.

  4. Clique com o botão direito do mouse em Gemini Code Assist e selecione Remover Alt+G (para Windows e Linux) ou Remover Option+G (para macOS).

Agora você pode usar o novo atalho de teclado para gerar código em um arquivo de código.

Receber preenchimentos de código

Enquanto você escreve código, o Gemini Code Assist faz sugestões de código inline, também conhecidas como preenchimento de código, que podem ser aceitas ou ignoradas. Para receber as sugestõ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 de sua preferência 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

A conclusão de código é ativada por padrão. Se você quiser desativar a conclusão de código, siga estas etapas:

VS Code

  1. No ambiente de desenvolvimento integrado, clique em Code (para macOS) ou File (para 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: Inline Suggestions: Enable Auto e selecione Off.

    Isso desativa as sugestões inline. Você ainda pode pressionar Ctrl + Enter (no Windows e Linux) ou Ctrl + Return (no 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: Active e selecione Ativar preenchimento de código com tecnologia de 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 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 código, siga estas etapas:

VS Code

  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.

    O ícone de lâmpada das ações inteligentes aparece após a seleção de um bloco de código no VS Code.

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

    O Gemini gera uma resposta com base na ação que você selecionou.

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 selecione uma ação inteligente, como Generate unit tests.

    A seleção da ação inteligente faz com que o Gemini Code Assist gere automaticamente uma resposta ao comando na janela de ferramentas do 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 oferece a opção de aplicar uma correção rápida ao erro com a 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 com ondulações 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 de diferença 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 diferença aparece. Para aceitar essas mudanças, clique em Aceitar.

Solicitação com arquivos específicos no seu espaço de trabalho com reconhecimento da base de código local

O reconhecimento da base de código local ajuda você com sugestões de código de alta qualidade que são gramaticalmente corretas e semanticamente significativas no contexto mais amplo da sua base de código, quando você especifica arquivos para o Gemini Code Assist usar como contexto.

Para especificar arquivos na solicitação de chat, digite @ e selecione os arquivos que você quer especificar.

Especifique arquivos com reconhecimento da base de código local.

Para receber uma explicação sobre as diferenças entre dois arquivos na base de código, siga estas etapas:

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

  2. No painel Gemini Code Assist, digite o comando Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 e pressione Enter (no Windows e no Linux) ou Return (no macOS) ou Tab. Você também pode clicar no nome do arquivo na lista para selecioná-lo. Clicar no nome do arquivo adiciona o arquivo ao contexto do comando e o abre no ambiente de desenvolvimento integrado.

    O Gemini Code Assist responde ao comando usando os dois arquivos especificados para o contexto. O Gemini Code Assist também inclui os arquivos especificados em Origens de contexto.

Agora que você especificou esses arquivos, pode continuar fazendo outras perguntas ou comandos no mesmo histórico de chat, sem precisar especificar os arquivos novamente.

Por exemplo, no painel Gemini Code Assist, digite o comando How can I improve YOUR_FILE_NAME_1? (sem o símbolo @) e pressione Enter (no Windows e no Linux) ou Return (no macOS).

O Gemini Code Assist responde à sua consulta sobre o arquivo especificado no comando.

Opcional: excluir arquivos do contexto com um arquivo .aiexclude

É possível excluir arquivos para que não sejam considerados pelo Gemini Code Assist para contexto criando um arquivo .aiexclude. Um arquivo .aiexclude segue a sintaxe semelhante a um arquivo .gitignore, com as seguintes diferenças:

  • Um arquivo .aiexclude vazio ou inexistente não bloqueia nenhum arquivo no diretório e em todos os subdiretórios.
  • Um arquivo .aiexclude não aceita negação, em que você prefixa padrões com um ponto de exclamação (!).
  • Um arquivo .aiexclude corresponde avidamente ao caractere *. Isso vai corresponder de forma indiscriminada a diretórios e arquivos. Esse arquivo .aiexclude não diferencia ** ou * em relação a pastas ou arquivos.

No momento, apenas um arquivo .aiexclude é aceito. Para configurar o arquivo .aiexclude, crie um arquivo com o título .aiexclude na raiz da pasta do espaço de trabalho.

Examples

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 do arquivo .aiexclude, mas não em 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 Code Assist fornece informações de citação quando cita diretamente de 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 código correspondente às fontes citadas seja sugerido, 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 Duet AI > Recitation: Max Cited Length.

  4. Defina o valor como 0.

    O Gemini Code Assist não sugere mais códigos que correspondem 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 na solicitação de 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 descartar 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 ao pressionar Esc para dispensar sugestão

    Quando você pressiona Esc, as sugestões do IDE e do Gemini são dispensadas. Esse comportamento é diferente do comportamento não-Vim, em que pressionar Esc aciona novamente o Gemini.

  • As tentativas de login continuam expirando

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

     "cloudcode.beta.forceOobLogin": true
    
  • Os avisos de leitura 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 Visualizar > Saída.

    2. Selecione Gemini Code Assist - Citations.

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

    Você pode usar 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 conferir 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, incluindo a ativação da API Gemini para o 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 conferir 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.

Enviar feedback

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

VS Code

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

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

  3. Se você quiser compartilhar seus 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.

IntelliJ

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

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

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

  4. Clique em Enviar feedback.

A seguir