Conversar com o Gemini Code Assist Standard e Enterprise

VS Code

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

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

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

IntelliJ

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

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

3. Se você preferir usar seu ambiente de desenvolvimento integrado por trás de um proxy, consulte Proxy HTTP.

VS Code

Para receber uma explicação do seu 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 do Gemini Code Assist, insira o comando Explain this code to me e clique em send Enviar.

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

   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 peça ajuda ao Gemini Code Assist.

IntelliJ

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

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

2. Na janela de ferramentas do 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 seu comando e responde com uma explicação.

Se você quiser apenas uma explicação de uma determinada parte do código, selecione o código e peça novamente ao Gemini Code Assist. O Gemini Code Assist vai usar apenas o código selecionado como referência para a resposta gerada.

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

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

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

  

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

Conferir o histórico de consultas

Se quiser reutilizar seus comandos anteriores, você pode encontrá-los no Histórico de consultas na janela de ferramentas do Gemini Code Assist. Para isso, clique em schedule Mostrar histórico de consultas.

VS Code

1. Para adicionar uma nova conversa, clique em Adicionar Nova conversa e insira o comando no campo de texto. Depois que você inserir o comando, o Gemini Code Assist vai criar a nova conversa.
2. Para acessar seu chat anterior, clique em Histórico Retomar chat anterior. Uma lista dos seus chats vai aparecer. Selecione a conversa que você quer ver.
3. Para excluir uma conversa, clique em Retomar conversa anterior e em delete Excluir ao lado da conversa que você quer excluir.

IntelliJ

No momento, esse recurso não está disponível no Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains compatíveis.

VS Code

Por padrão, o Gemini Code Assist rola automaticamente o chat. Para desativar esse comportamento, faça o seguinte:

1. Acesse Configurações > Extensões > Gemini Code Assist.

2. Procure a configuração Rolagem automática e desmarque a caixa de seleção.

IntelliJ

Esse recurso não está disponível no Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

Para interromper uma resposta do chat em andamento, pressione stop Parar:

IntelliJ

Esse recurso não está disponível no Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

1. No seu ambiente de desenvolvimento integrado, acesse Configurações > Extensões > Gemini Code Assist.

2. Procure a configuração Exibição padrão do bloco de código.

3. Selecione uma das seguintes opções:

   • Expandido: expande automaticamente todos os blocos de código nas respostas do chat do Gemini Code Assist.

   • Prévia: mostra apenas as seis primeiras linhas de código no bloco. Você precisa abrir o bloco de código na resposta do chat do Gemini Code Assist para conferir o restante do código. Esta é a configuração padrão.

   • Fechar: fecha automaticamente todos os blocos de código nas respostas do chat do Gemini Code Assist.

   Quando o ambiente de desenvolvimento integrado for recarregado, a nova configuração vai entrar em vigor.

IntelliJ

Esse recurso não é compatível com o Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

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.

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 usa o código selecionado como referência e responde ao comando.

IntelliJ

1. Na barra de atividades, clique em faísca Gemini Code Assist para abrir a janela de ferramentas Gemini Code Assist.

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

3. No campo de texto da janela de ferramentas do 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 seu comando.

VS Code

1. No arquivo de código, selecione um snippet.

2. No campo de texto do Gemini Code Assist Chat, clique em Adicionar ao contexto da conversa.

   O Gemini Code Assist adiciona o snippet de código selecionado à gaveta de contexto.

3. No campo de texto da conversa do Gemini Code Assist, insira o comando what does this code do?.

   O Gemini Code Assist responde ao seu comando com base no snippet de código selecionado na gaveta de contexto.

IntelliJ

Esse recurso não está disponível no Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

1. No seu ambiente de desenvolvimento integrado, abra o terminal (Visualizar > Terminal).

2. Selecione qualquer saída do terminal.

3. Clique com o botão direito do mouse na saída do terminal selecionada e escolha Gemini Code Assist: Adicionar ao contexto da conversa.

   O Gemini Code Assist adiciona a saída do terminal ao painel de contexto.

4. No campo de texto da conversa do Gemini Code Assist, insira o comando what does this do?.

   O Gemini Code Assist responde ao seu comando com base na saída do terminal selecionada na gaveta de contexto.

IntelliJ

Esse recurso não está disponível no Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

Para especificar arquivos ou pastas no comando de chat, digite @ e selecione o item que você quer especificar.

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

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

2. No painel Assistente de código do Gemini, 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. Ao clicar no nome do arquivo, ele é adicionado ao contexto do comando e aberto no seu ambiente de desenvolvimento integrado.

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

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

Por exemplo, no painel Assistente de código do Gemini, insira o comando 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 especificado no comando.

IntelliJ

Para especificar arquivos ou pastas no comando de chat, digite @ e selecione os itens que você quer especificar.

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

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

2. No painel Assistente de código do Gemini, 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. Ao clicar no nome do arquivo, ele é adicionado ao contexto do comando e aberto no seu ambiente de desenvolvimento integrado.

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

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

Por exemplo, no painel Assistente de código do Gemini, insira o comando 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 especificado no comando.

VS Code

1. Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em spark Gemini Code Assist.

2. Para ver os arquivos e pastas na gaveta de contexto, clique em Itens de contexto.

   

3. Para remover itens da gaveta de contexto, clique em close Remover.

IntelliJ

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

2. Para ver os arquivos e pastas na gaveta de contexto, clique em Contexto.

   

3. Para remover arquivos e pastas da gaveta de contexto, clique em close Remover.

VS Code

No painel de conversa do Gemini Code Assist, clique em Reverter para ponto de verificação. Isso reverte o arquivo de código para o estado do ponto de verificação antes das edições.

IntelliJ

Esse recurso não é compatível com o Gemini Code Assist para IntelliJ e outros ambientes de desenvolvimento integrado da JetBrains.

VS Code

1. No arquivo de código, pressione Control+I (no Windows e no Linux) ou Command+I (no macOS) para abrir o menu Seleção rápida do Gemini Code Assist.

2. No menu, procure e selecione Preferências: abrir configurações (UI).

3. No campo Configurações de pesquisa, insira Geminicodeassist: Custom Commands.

4. Na caixa Comandos personalizados, selecione Adicionar item.

5. No campo Item, insira add-comments como o nome do comando.

6. No campo Valor, insira add comments to all functions without comments in my code como o comando.

7. Clique em OK.

Agora você pode usar o comando personalizado add-comments no seu ambiente de desenvolvimento integrado. O comando aparece na lista de comandos no menu de seleção rápida do Gemini Code Assist (Control+I (para Windows e Linux) ou Command+I (para macOS)).

IntelliJ

1. No seu ambiente de desenvolvimento integrado, acesse Configurações > Ferramentas > Gemini > Biblioteca de comandos.

   

2. Na janela Biblioteca de comandos, clique em add Adicionar.

3. Nomeie seu comando personalizado add-comments.

4. Na caixa de texto da biblioteca de comandos, digite o comando: Add comments to all functions without comments in this code.

5. Marque a caixa de seleção Mostrar no aviso do editor se ela estiver desmarcada.

6. Clique em OK para salvar o comando personalizado na biblioteca de comandos.

7. No arquivo de código, destaque o que você quer modificar.

8. Clique com o botão direito do mouse no código destacado e navegue até Gemini > Biblioteca de comandos e selecione o comando personalizado add-comments.

   O Gemini Code Assist executa o comando add-comments e adiciona comentários ao código destacado.

Você também pode invocar o comando personalizado com o prompt no editor realizando as seguintes tarefas:

1. No arquivo de código, destaque o código que você quer modificar e pressione Alt+\ (no Windows e no Linux) ou Cmd+\ (no macOS) para abrir o menu Seleção rápida da assistência do Gemini Code.

2. No menu, selecione seu comando personalizado add-comments.

   O Gemini Code Assist executa o comando add-comments e adiciona comentários ao código destacado.

VS Code

1. No arquivo de código, pressione Control+I (no Windows e no Linux) ou Command+I (no macOS) para abrir o menu Seleção rápida do Gemini Code Assist.

2. No menu, procure e selecione Preferências: abrir configurações (UI).

3. No campo Configurações de pesquisa, insira Geminicodeassist: Rules.

4. No campo de texto, insira uma regra como: Always generate unit tests when creating a new function. Também é possível 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 comando ou solicitação feita.

   Para remover a regra, exclua o conteúdo do campo de texto "Regras".

IntelliJ

1. Para criar uma regra, acesse Configurações > Ferramentas > Gemini > Biblioteca de comandos > Regras e edite o texto no editor.

2. Para definir o escopo da regra, no menu suspenso Escopo, selecione IDE ou Projeto.

   • As regras no nível do ambiente de desenvolvimento integrado são particulares e podem ser usadas em vários projetos.
   • As regras no nível do projeto podem ser compartilhadas entre colegas de equipe que trabalham no mesmo projeto.

   Para compartilhar comandos com a equipe, adicione a pasta .idea ao sistema de controle de versões.

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 no comando do 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 dispensar 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 dispensar sugestões

  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 sem o Vim, em que pressionar Esc reativa o Gemini Code Assist.

• 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 entre as sessões

  Se os avisos de recitação de licença não persistirem entre as sessões, 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 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.

  Use 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 sem sucesso resulta na seguinte saída:

  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
  

• 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, que incluem a ativação da API Gemini para 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 ver 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 compatíveis.

VS Code

1. Você pode deixar feedback de uma das seguintes maneiras:

   • Na barra de status, clique em spark Gemini Code Assist e, no menu Seleção rápida, 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 para o Gemini Code Assist, selecione uma opção nos menus suspensos Categoria do feedback e Tipo.

4. Escreva uma descrição detalhada da sua experiência no campo Comentário.

5. Inclua os registros do Gemini Code Assist no seu relatório de feedback. Por padrão, essa opção é selecionada.

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

7. Clique em Enviar feedback.

IntelliJ

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

2. Depois de enviar um comando para o Gemini Code Assist no chat, se você não estiver satisfeito com a resposta, clique em thumb_down Negativo e selecione Enviar feedback.

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

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

5. Clique em Enviar feedback.