Código com Gemini Code Assist Standard e Enterprise

Este documento descreve como você pode usar o Gemini Code Assist Standard e Enterprise, um colaborador com tecnologia de IA no seu IDE, para ajudá-lo a fazer o seguinte no VS Code ou IntelliJ e outros IDEs JetBrains suportados :

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

Se você usa o Gemini Code Assist Enterprise , pode usar a personalização de código , que permite obter sugestões de código com base na base de código privada da sua organização diretamente do Gemini Code Assist Enterprise. Saiba como configurar a personalização de código .

Este documento destina-se a desenvolvedores de todos os níveis de habilidade. Ele pressupõe que você tenha conhecimento prático do VS Code ou IntelliJ e outros IDEs JetBrains suportados, e esteja familiarizado com Google Cloud. Se preferir, você também pode explorar o Gemini Code Assist no Cloud Shell Editor , Cloud Workstations e Android Studio .

Antes de começar

Código VS

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

  2. Antes de testar os recursos do Gemini Code Assist no seu arquivo de código, certifique-se de que a linguagem de codificação do arquivo seja compatível. Para obter mais informações sobre as linguagens de codificação compatíveis, consulte Linguagens de codificação compatíveis .

  3. Se preferir usar seu IDE atrá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 o tenha feito.

  2. Antes de testar os recursos do Gemini Code Assist no seu arquivo de código, certifique-se de que a linguagem de codificação do arquivo seja compatível. Para obter mais informações sobre as linguagens de codificação compatíveis, consulte Linguagens de codificação compatíveis .

  3. Se você preferir usar seu IDE atrás de um proxy, consulte Proxy HTTP .

Gerar código com prompts

As seções a seguir mostram como usar o Gemini Code Assist para gerar código com a Function to create a Cloud Storage bucket dentro do seu arquivo de código. Você também pode selecionar uma parte do seu código e solicitar ajuda ao Gemini Code Assist por meio do recurso de bate-papo, além de receber, aceitar ou rejeitar sugestões de código enquanto codifica.

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

A transformação de código permite que você use comandos ou prompts de linguagem natural no menu Seleção Rápida para solicitar modificações no seu código e oferece uma visualização de diferenças para mostrar as alterações pendentes. Para solicitar a transformação de código ao Gemini Code Assist, siga estas etapas:

Código VS

  1. No seu 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 do Gemini Code Assist .

  2. No menu, usando o comando /generate , insira /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 prompt em uma visualização diff.

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

  3. Opcional: para aceitar essas alterações, clique em Aceitar .

IntelliJ

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

  2. No menu, usando o comando /generate , insira /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 IntelliJ Gemini Code Assist

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

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

  3. Opcional: para aceitar essas alterações, clique em Aceitar alterações .

    Você pode usar os seguintes comandos de transformação de código no seu IDE:

    • /fix : Corrige problemas ou erros no seu código. Exemplo: /fix potential NullPointerExceptions in my code .
    • /generate : Gera 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 .

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

Se preferir, você também pode solicitar ao Gemini Code Assist no seu arquivo de código um comentário seguindo estas etapas:

Código VS

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

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

    Ao lado do texto do prompt no seu 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 seu arquivo de código, em uma nova linha, insira o comentário Function to create a Cloud Storage bucket .

  2. Para gerar código, pressione Alt+G (para Windows e Linux) ou Option+G (para macOS). Como alternativa, você pode clicar com o botão direito do mouse ao lado do comentário e selecionar 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: Alterar atalho de teclado para geração de código

Se o atalho de teclado padrão para gerar código não estiver funcionando conforme descrito na seção anterior, você pode alterá-lo seguindo estas etapas:

Código VS

  1. No seu IDE, clique em Arquivo (para Windows e Linux) ou Código (para macOS) e navegue até Configurações > Atalhos de teclado .

  2. Na lista de atalhos de teclado, role até encontrar Gemini Code Assist: Gerar código .

  3. Clique em Gemini Code Assist: Gerar código e, em seguida, clique em edit Alterar atalho de teclado .

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

  5. Pressione Enter (para Windows e Linux) ou Return (para 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 alterar atalhos no seu IDE, consulte Atalhos de teclado para Visual Studio Code .

IntelliJ

  1. Navegue até settings IDE e Configurações do projeto > Configurações > Mapa de teclas > Gemini Code Assist .

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

  3. Digite seu atalho de teclado preferido 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 seu novo atalho de teclado para gerar código em um arquivo de código.

Obter conclusões de código

Enquanto você escreve o código, o Gemini Code Assist faz sugestões de código em linha, também conhecidas como conclusões de código , que você pode aceitar ou ignorar. Para obter conclusões de código, siga estes passos:

Código VS

  1. No seu 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, para ignorar a sugestão, pressione Esc ou continue escrevendo seu código.

IntelliJ

  1. No seu 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 em linha.

  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 seu código.

  3. Opcional: Se preferir usar uma tecla de atalho diferente para aceitar a sugestão em linha, mantenha o cursor sobre a sugestão em linha e clique no menu suspenso Tab que aparece. Em seguida, selecione o atalho de sua preferência ou clique em Personalizar para inserir seu próprio atalho.

    O Gemini fornece um menu suspenso para alterar seu atalho para aceitar uma sugestão em linha.

Opcional: Desabilitar a conclusão de código

A complementação de código é habilitada por padrão. Se quiser desabilitar a complementação de código, siga estas etapas:

Código VS

  1. No seu IDE, clique em Código (para macOS) ou Arquivo (para Windows e Linux) e navegue até Configurações > Configurações .

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

  3. Role até encontrar a lista Duet AI: Sugestões em linha: Ativar automático e selecione Desativar .

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

IntelliJ

Na barra de status do seu IDE, clique em spark Gemini Code Assist: Ativo e selecione Habilitar conclusão de código de IA .

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

Isso desabilita a configuração de conclusão de código, e o Gemini Code Assist não faz mais sugestões em linha até que você habilite a configuração novamente.

Use ações inteligentes

Para ajudar você a ser mais produtivo e, ao mesmo tempo, minimizar a troca de contexto, o Gemini Code Assist oferece ações inteligentes com tecnologia de IA diretamente no seu editor de código. Ao selecionar seu código no editor, você pode visualizar e selecionar ações relevantes para o seu contexto em uma lista.

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

Código VS

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

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

    O ícone de lâmpada de ações inteligentes aparece após selecionar 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 seu arquivo de código, selecione uma linha ou bloco de código.

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

    Selecionar a ação inteligente fará com que o Gemini Code Assist gere automaticamente uma resposta ao prompt na janela da ferramenta Gemini Code Assist .

Use a solução rápida de transformação de código

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

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

Código VS

  1. No seu arquivo de código, mantenha o ponteiro do mouse sobre a linha de erro ondulada e selecione Correção rápida e, em seguida, selecione /fix .

    Correção rápida de transformação de código no IDE.

  2. Quando a correção rápida for aplicada, uma visualização de diferenças será exibida. Para aceitar essas alterações, clique em Aceitar .

IntelliJ

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

    Opção de transformação de código para corrigir com Gemini no IDE.

  2. Quando a correção for aplicada, uma visualização de diferenças será exibida. Para aceitar as alterações, clique em Aceitar .

Excluir arquivos do contexto local

Por padrão, o Gemini Code Assist exclui arquivos do uso local no contexto de conclusão de código, geração de código, transformação de código e bate-papo se os arquivos 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 .

Desabilitar sugestões de código que correspondam às fontes citadas

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

Para evitar que códigos que correspondam às fontes citadas sejam sugeridos a você, faça o seguinte:

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

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

  3. Role 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 às fontes citadas.

Problemas conhecidos

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

Código VS

  • 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 prompt de bate-papo, como only output the selected code.

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

    Ao usar o plugin Vim no modo normal, você não pode aceitar ou descartar 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 descartar sugestões

    Ao pressionar Esc , as sugestões do IDE e do Gemini Code Assist são descartadas. Esse comportamento é diferente do comportamento não-Vim, em que pressionar Esc reativa o Gemini Code Assist.

  • As tentativas de login continuam expirando

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

     "cloudcode.beta.forceOobLogin": true
    
  • Os avisos de recitação de licença não persistem nas sessões

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

    1. Clique em Exibir > Saída .

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

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

    Se você vir 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 acesso a oauth2.googleapis.com e cloudaicompanion.googleapis.com .

    • Configure seu firewall para permitir a comunicação via HTTP/2, usado pelo gRPC.

    Você pode usar a ferramenta grpc-health-probe para testar a conectividade. Uma verificação bem-sucedida resulta no seguinte resultado:

    $ 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 obter mais detalhes, execute o seguinte antes de grpc-health-probe :

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    
  • 'Ativar Gemini Code Assist' ainda aparece após selecionar o projeto Gemini Code Assist

    Se você selecionou seu projeto conforme as instruções neste guia, o que inclui a ativação da API Gemini para Google Cloud, pode haver um problema com o servidor LS.

    Para descobrir mais detalhes sobre o seu problema, execute as seguintes ações:

    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 log para ver mais detalhes e ajudar a solucionar o problema.

IntelliJ

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

Deixar feedback

Para deixar um feedback sobre sua experiência, siga estes passos:

Código VS

  1. Na barra de status, clique em spark Gemini Code Assist e, no menu Seleção rápida , selecione Enviar feedback .

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

  3. Se você quiser compartilhar seus logs do Skaffold ou do AI Companion, certifique-se de selecionar a opção Enviar logs do Skaffold ou Enviar logs 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 superior do formulário, insira seu feedback.

  3. Se você quiser compartilhar seus logs do Gemini Code Assist, certifique-se de selecionar os arquivos de log.

  4. Clique em Enviar feedback .

O que vem a seguir