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 :
- Receba orientação para ajudar você a resolver problemas com seu código.
- Gere código para seu projeto.
- Gerencie o contexto do seu projeto especificando arquivos e pastas.
- Crie comandos e regras personalizados.
A personalização de código permite que você receba 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
Configure o Gemini Code Assist Standard ou Enterprise , caso ainda não o tenha feito.
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 .
Se preferir usar seu IDE atrás de um proxy, consulte Conexões de rede no Visual Studio Code .
IntelliJ
Configure o Gemini Code Assist Standard ou Enterprise , caso ainda não o tenha feito.
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 .
Se você preferir usar seu IDE atrás de um proxy, consulte Proxy HTTP .
Use o chat do Gemini Code Assist para explicar seu código
Nesta seção, você solicita que o Gemini Code Assist forneça uma explicação do seu código existente.
Código VS
Para obter uma explicação do seu código, siga estas etapas:
Abra seu arquivo de código.
Na barra de atividades do seu IDE, clique em spark Gemini Code Assist .
No painel Gemini Code Assist , insira o prompt
Explain this code to me
e clique em send Enviar .O Gemini Code Assist usa o código no seu arquivo de código como uma referência ao seu prompt e responde com uma explicação do seu código.
Para fazer referência a um bloco de código específico em vez de todo o código do arquivo, você pode selecionar o bloco no seu arquivo de código e então solicitar o Gemini Code Assist.
IntelliJ
Para obter uma explicação do seu código, siga estas etapas:
No seu IDE, abra seu arquivo de código.
Na janela da ferramenta Gemini Code Assist, digite o prompt
Explain this code to me
e clique em Enviar .
O Gemini Code Assist usa o código no seu arquivo de código como uma referência ao seu prompt e responde com uma explicação do seu código.
Se você quiser apenas uma explicação de uma determinada parte do seu código, selecione o código desejado e acione o Gemini Code Assist novamente. O Gemini Code Assist usará apenas o código selecionado como referência para a resposta gerada.
Quando o Gemini Code Assist fornece código em sua resposta, você pode selecionar as seguintes opções listadas no final da resposta:
Inserir no cursor : insere o código gerado no seu arquivo atual na posição atual do cursor.
Inserir em novo arquivo : abre um novo arquivo e insere o código gerado no novo arquivo.
Essas opções estão disponíveis quando o Gemini Code Assist identifica a linguagem usada no seu bloco de código e se essa linguagem é suportada no seu IDE atual.
Ver histórico de consultas
Se quiser reutilizar seus prompts anteriores, você pode encontrá-los no Histórico de consultas na janela da ferramenta Gemini Code Assist clicando em schedule mostrar histórico de consultas .
Crie vários chats
Você pode criar vários chats com o Gemini Code Assist, cada um com seu próprio contexto, separado dos outros chats. Seu histórico de chats mostra o primeiro chat e a data e hora da última atualização. Há um limite de 20 chats. Ao atingir esse limite, o chat mais antigo será excluído automaticamente quando você adicionar um novo.
Código VS
- Para adicionar um novo chat, clique em Adicionar Novo Chat e insira o prompt no campo de texto. Após inserir o prompt, o Gemini Code Assist cria o novo chat.
- Para acessar seu bate-papo anterior, clique em Histórico > Retomar Bate-papo Anterior . Uma lista dos seus bate-papos será exibida. Selecione o bate-papo que deseja visualizar.
- Para excluir um tópico de bate-papo, clique em Retomar bate-papo anterior e depois clique em Excluir ao lado do bate-papo que você deseja excluir.
IntelliJ
Este recurso não é suportado no Gemini Code Assist para IntelliJ e outros IDEs JetBrains suportados no momento.
Redefinir histórico de bate-papo
O Gemini Code Assist usa o histórico de bate-papo para fornecer contexto adicional ao responder às suas solicitações. Se o seu histórico de bate-papo não for mais relevante para o seu objetivo, você pode redefini-lo .
Gerencie seu bate-papo
Você pode gerenciar as configurações de bate-papo do Gemini Code Assist fazendo o seguinte:
Configurar rolagem automática
Código VS
Por padrão, o Gemini Code Assist percorre o seu chat automaticamente. Para desativar esse comportamento, execute as seguintes tarefas:
Navegue até Configurações > Extensões > Gemini Code Assist .
Procure a configuração Rolagem Automática e desmarque a caixa de seleção.
IntelliJ
Este recurso não é suportado no Gemini Code Assist para IntelliJ e outros IDEs da JetBrains.
Parar o bate-papo em andamento
Código VS
Você pode interromper uma resposta de bate-papo em andamento pressionando Parar :
IntelliJ
Este recurso não é suportado no Gemini Code Assist para IntelliJ e outros IDEs da JetBrains.
Prompt Gemini Code Assist com o código selecionado usando o chat
O Gemini Code Assist pode executar tarefas ou responder às suas perguntas com base no código que você selecionar. Para obter o código gerado com base em um prompt com o código selecionado, siga estas etapas:
Código VS
Na barra de atividades, clique em spark Gemini Code Assist para abrir o painel Gemini Code Assist .
No seu arquivo de código, selecione um bloco de código.
No campo de texto do painel Gemini Code Assist , insira um prompt para o código selecionado.
Por exemplo, selecione uma função no seu código e digite o prompt
Write a unit test for this function
.O Gemini usa o código selecionado como referência e responde ao seu prompt.
IntelliJ
Na barra de atividades, clique em Spark Gemini Code Assist para abrir a janela da ferramenta Gemini Code Assist .
No seu arquivo de código, selecione um bloco de código.
No campo de texto da janela da ferramenta Gemini Code Assist , insira um prompt para o código selecionado.
Por exemplo, selecione uma função no seu código e digite o prompt
Write a unit test for this function.
O Gemini Code Assist usa o código selecionado como referência e responde ao seu prompt.
Avisar com arquivos e pastas específicos em seu espaço de trabalho com reconhecimento de 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 sintaticamente corretas e semanticamente significativas dentro do contexto mais amplo da sua base de código, quando você especifica arquivos ou pastas para o Gemini Code Assist usar como contexto.
Quando você especifica uma pasta, o Gemini Code Assist usa os arquivos na pasta, bem como os arquivos nas subpastas como contexto.
Código VS
Para especificar arquivos ou pastas no seu prompt de bate-papo, digite @ e selecione o arquivo ou pasta que deseja especificar.
Para obter uma explicação sobre as diferenças de dois arquivos em sua base de código, siga estas etapas:
Na barra de atividades, clique em spark Gemini Code Assist .
No painel Gemini Code Assist , digite o prompt
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
e pressione Enter (para Windows e Linux) ou Return (para 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 prompt e o abre no seu IDE.
O Gemini Code Assist responde ao seu prompt usando os dois arquivos que você especificou para o contexto. O Gemini Code Assist também inclui os arquivos que você especificou em Fontes de Contexto .
Agora que você especificou esses arquivos, pode continuar fazendo perguntas ou avisos adicionais no mesmo histórico de bate-papo, sem precisar especificar os arquivos novamente.
Por exemplo: no painel Gemini Code Assist , digite o prompt How can I improve YOUR_FILE_NAME_1?
(sem o símbolo @ ) e pressione Enter (para Windows e Linux) ou Return (para macOS).
O Gemini Code Assist responde à sua consulta sobre o arquivo que você especificou no prompt.
IntelliJ
Para especificar arquivos ou pastas no seu prompt de bate-papo, digite @ e selecione os arquivos ou pastas que deseja especificar.
Para obter uma explicação sobre as diferenças de dois arquivos em sua base de código, siga estas etapas:
Na barra de atividades, clique em spark Gemini Code Assist .
No painel Gemini Code Assist , digite o prompt
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
e pressione Enter (para Windows e Linux) ou Return (para 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 prompt e o abre no seu IDE.
O Gemini Code Assist responde ao seu prompt usando os dois arquivos que você especificou para o contexto. O Gemini Code Assist também inclui os arquivos que você especificou em Fontes de Contexto .
Agora que você especificou esses arquivos, pode continuar fazendo perguntas ou prompts adicionais no mesmo histórico de bate-papo, sem precisar especificá-los novamente.
Por exemplo: no painel Gemini Code Assist , digite o prompt How can I improve YOUR_FILE_NAME_1?
(sem o símbolo @ ) e pressione Enter (para Windows e Linux) ou Return (para macOS).
O Gemini Code Assist responde à sua consulta sobre o arquivo que você especificou no prompt.
Gerenciar arquivos e pastas na Gaveta de Contexto
Depois de especificar um arquivo ou pasta a ser usado como contexto para seus prompts do Gemini Code Assist , esses arquivos e pastas são colocados na Gaveta de Contexto , onde você pode visualizá-los e removê-los do contexto do prompt.
Para gerenciar os arquivos e pastas na sua Gaveta de Contexto, execute as seguintes tarefas:
Código VS
Na barra de atividades do seu IDE, clique em spark Gemini Code Assist .
Para visualizar os arquivos e pastas na sua Gaveta de Contexto, clique em Itens de contexto .
Para remover itens da Gaveta de Contexto, clique em close Remover .
IntelliJ
Na barra de atividades, clique em spark Gemini Code Assist.
Para visualizar os arquivos e pastas na sua Gaveta de Contexto, clique em Contexto .
Para remover arquivos e pastas da Gaveta de Contexto, clique em close Remover .
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 .
Criar comandos personalizados
Por padrão, o Gemini Code Assist fornece comandos como /generate
para o VS Code e Generate Code para o IntelliJ e outros IDEs JetBrains compatíveis . Você também pode criar seus próprios comandos personalizados para ajudar a realizar tarefas repetitivas com mais rapidez no seu IDE.
Nesta seção, você criará um comando personalizado chamado add-comments
, que adiciona comentários ao código no seu arquivo de código. Para o IntelliJ e outros IDEs JetBrains compatíveis, você criará, salvará e executará o comando personalizado na Biblioteca de Prompts e no prompt do editor.
Código VS
No seu arquivo de código, pressione Control+I (para Windows e Linux) ou Command+I (para macOS) para abrir o menu Seleção rápida do Gemini Code Assist .
No menu, pesquise e selecione Preferências: Abra Configurações (IU) .
No campo Configurações de pesquisa , digite
Geminicodeassist: Custom Commands
.Na caixa Comandos personalizados , selecione Adicionar item .
No campo Item , insira
add-comments
como o nome do comando.No campo Valor , insira
add comments to all functions without comments in my code
como prompt.Clique em OK .
Agora você pode usar o comando personalizado add-comments
no seu IDE. O comando aparece na lista de comandos no menu Seleção Rápida do Gemini Code Assist ( Control+I (para Windows e Linux) ou Command+I (para macOS)).
IntelliJ
No seu IDE, navegue até Configurações > Ferramentas > Gemini > Biblioteca de Prompts .
Na janela Biblioteca de prompts , clique em add Adicionar .
Nomeie seu comando personalizado
add-comments
.Na caixa de texto da Biblioteca de Prompts, insira o prompt:
Add comments to all functions without comments in this code
.Marque a caixa de seleção Mostrar no prompt do editor se ela não estiver selecionada.
Clique em OK para salvar o comando personalizado na Biblioteca de Prompts.
No seu arquivo de código, realce o código que você deseja modificar.
Clique com o botão direito do mouse no código destacado e navegue até Gemini > Prompt Library e selecione o comando personalizado
add-comments
.O Gemini Code Assist executa o comando
add-comments
e adiciona comentários ao seu código destacado.
Você também pode invocar o comando personalizado com o prompt do editor executando as seguintes tarefas:
No seu arquivo de código, realce o código que deseja modificar e pressione Alt+\ (para Windows e Linux) ou Cmd+\ (para macOS) para abrir o menu Seleção rápida do Gemini Code Assist .
No menu, selecione seu comando personalizado
add-comments
.O Gemini Code Assist executa o comando
add-comments
e adiciona comentários ao seu código destacado.
Criar regras
Você pode criar regras para o Gemini Code Assist seguir, e as regras serão incluídas em cada prompt de bate-papo que você inserir.
Código VS
No seu arquivo de código, pressione Control+I (para Windows e Linux) ou Command+I (para macOS) para abrir o menu Seleção rápida do Gemini Code Assist .
No menu, pesquise e selecione Preferências: Abra Configurações (IU) .
No campo Configurações de pesquisa , digite
Geminicodeassist: Rules
.No campo de texto, insira uma regra como:
Always generate unit tests when creating a new function
. Você também pode adicionar uma ou mais regras com várias linhas no campo de texto.Depois de adicionar regras nas Configurações de regras, o Gemini Code Assist considera a regra para cada prompt ou solicitação que você fizer.
Para remover a regra, exclua o conteúdo do campo de texto Regras.
IntelliJ
Este recurso não é suportado no Gemini Code Assist para IntelliJ e outros IDEs JetBrains suportados no momento.
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 arquivosettings.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:
Clique em Exibir > Saída .
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
ecloudaicompanion.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:
Na barra de status, clique em spark Gemini Code Assist e selecione Enviar feedback .
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
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 logs do Skaffold ou do AI Companion, certifique-se de selecionar a opção Enviar logs do Skaffold ou Enviar logs 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 superior do formulário, insira seu feedback.
Se você quiser compartilhar seus logs do Gemini Code Assist, certifique-se de selecionar os arquivos de log.
Clique em Enviar feedback .
O que vem a seguir
- Aprenda a escrever melhores prompts .
- Aprenda como Gêmeos é para Google Cloud usa seus dados .
- Saiba mais sobre os preços do Gemini Code Assist .
- Saiba mais sobre Google Cloud conformidade .