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 integrado do JetBrains com suporte:
- Gere código para seu projeto com a transformação de código.
- Receba preenchimentos de código enquanto você está programando.
- 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 do JetBrains com suporte e que você conheça o Google Cloud. Se preferir, você também pode conferir o Gemini Code Assist no editor do Cloud Shell, nas estações de trabalho do Cloud e no Android Studio.
Antes de começar
VS Code
Configure o Gemini Code Assist Standard ou Enterprise, caso ainda não tenha feito isso.
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 aceitas, consulte Linguagens de programação compatíveis.
Se você preferir usar o ambiente de desenvolvimento integrado por um proxy, consulte Conexões de rede no Visual Studio Code.
IntelliJ
Configure o Gemini Code Assist Standard ou Enterprise, caso ainda não tenha feito isso.
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 aceitas, consulte Linguagens de programação compatíveis.
Se você preferir usar o ambiente de desenvolvimento integrado por 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 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.
Ativar 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ças 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:
VS Code
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 Gemini Code Assist Quick Pick.
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 o código com base na solicitação em uma visualização de diferença.
Opcional: para aceitar essas mudanças, clique em Aceitar.
IntelliJ
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.
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 o código com base na solicitação em uma visualização de diferença.
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
Se preferir, também é possível ativar o Gemini Code Assist no seu arquivo de código com um comentário seguindo estas etapas:
VS Code
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).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.
Opcional: para aceitar o código gerado, pressione Tab.
IntelliJ
No arquivo de código, em uma nova linha, digite o comentário
Function to create a Cloud Storage bucket
.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 Generate Code.
O Gemini Code Assist gera o código abaixo do seu comentário na forma de texto fantasma.
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 conforme descrito na seção anterior, siga estas etapas para mudar o atalho de teclado:
VS Code
No ambiente de desenvolvimento integrado, clique em File (para Windows e Linux) ou Code (para macOS) e navegue até Settings > Keyboard Shortcuts.
Na lista de atalhos do teclado, role até encontrar Gemini Code Assist: Generate code.
Clique em Gemini Code Assist: Generate Code e em edit Change Keybinding.
Na caixa de diálogo exibida, insira seu próprio atalho.
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
Navegue até settings Configurações do ambiente de desenvolvimento integrado e do projeto > Configurações > Mapa de teclado > Assistente de código Gemini.
Clique com o botão direito do mouse em Gemini Code Assist e selecione Adicionar atalho ao teclado.
Insira o atalho de teclado que preferir e clique em OK.
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
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.
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
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.
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.
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.
Opcional: desativar o preenchimento automático de código
O preenchimento automático de código é ativado por padrão. Se você quiser desativar a conclusão de código, siga estas etapas:
VS Code
No ambiente de desenvolvimento integrado, clique em Code (para macOS) ou File (para Windows e Linux) e navegue até Settings > Settings.
Na guia Usuário da caixa de diálogo Configurações, navegue até Extensões > Gemini Code Assist.
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 Control + Enter (no Windows e no Linux) ou Control + 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 Enable AI Code Completion.
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
No arquivo de código, selecione um bloco de código.
Ao lado do bloco de código selecionado, clique em lightbulb Mostrar ações de código.
Selecione uma ação, como Gerar testes de unidade.
O Gemini Code Assist gera uma resposta com base na ação selecionada.
IntelliJ
No arquivo de código, selecione uma linha ou um bloco de código.
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 vai pedir automaticamente que o Gemini Code Assist gere 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 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 arquivo de código, siga estas etapas:
VS Code
No arquivo de código, mantenha o ponteiro sobre a linha de erro com ondulações e selecione Quick Fix e /fix.
Quando a correção rápida é aplicada, uma visualização de diferença aparece. Para aceitar essas mudanças, clique em Aceitar.
IntelliJ
No arquivo de código, clique no ícone de lâmpada de erro vermelho, que indica um erro no código, e selecione Corrigir com Gemini.
Quando a correção é aplicada, uma visualização de diferença aparece. Para aceitar essas mudanças, clique em Aceitar.
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:
Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em Gerenciar > Configurações.
Na guia Usuário da janela de configurações, navegue até Extensões > Gemini Code Assist.
Role a tela até encontrar Duet AI > Recitation: Max Cited Length.
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 ambiente de desenvolvimento integrado e do Gemini Code Assist são dispensadas. Esse comportamento é diferente do comportamento não-Vim, em que pressionar Esc ativa novamente o Gemini Code Assist.
As tentativas de login continuam expirando
Se as tentativas de login continuarem expirando, tente adicionar a configuração
cloudcode.beta.forceOobLogin
ao arquivosettings.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:
Clique em Visualizar > Saída.
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 o firewall para permitir o acesso a
oauth2.googleapis.com
ecloudaicompanion.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:
Na barra de status, clique em spark Gemini Code Assist e selecione Enviar feedback.
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
Na barra de status, clique em spark Gemini Code Assist e, no menu Seleção rápida, selecione Enviar feedback.
No formulário, preencha os campos Título e Comentários.
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.
Clique em Enviar feedback.
IntelliJ
Na barra de status, clique em spark Gemini Code Assist e, no menu, selecione Enviar feedback.
No campo de texto na parte de cima do formulário, digite seu feedback.
Se você quiser compartilhar seus registros do Gemini Code Assist, selecione os arquivos de registro.
Clique em Enviar feedback.
A seguir
- Saiba como escrever 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 a conformidade com oGoogle Cloud .