Converse com o Gemini Code Assist Standard e Enterprise

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

• Receba orientações para ajudar a resolver problemas com o seu código.
• Gere código para o seu projeto.
• Faça a gestão do contexto do seu projeto especificando ficheiros e pastas.
• Crie comandos e regras personalizados.

A personalização de código permite-lhe receber sugestões de código com base na base de código privada da sua organização diretamente a partir do Gemini Code Assist Enterprise. Saiba como configurar a personalização de código.

Este documento destina-se a programadores de todos os níveis de competências. Parte do princípio de que tem conhecimentos práticos do VS Code ou do IntelliJ e de outros IDEs JetBrains suportados, e que está familiarizado com o Google Cloud. Se preferir, também pode explorar o Gemini Code Assist no Cloud Shell Editor, Cloud Workstations e Android Studio.

Nota: o comportamento da geração, conclusão e transformação de código não é determinístico quando usado em simultâneo com outros plug-ins que implementam os mesmos atalhos e/ou usam a mesma API de plataforma para processar estas ações.

Antes de começar

VS Code

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

2. Antes de testar as capacidades do Gemini Code Assist no seu ficheiro de código, certifique-se de que a linguagem de programação do ficheiro é suportada. Para mais informações sobre as linguagens de programação suportadas, consulte o artigo Linguagens de programação suportadas.

3. Se preferir usar o IDE atrás de um proxy, consulte o artigo Ligações de rede no Visual Studio Code.

IntelliJ

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

2. Antes de testar as capacidades do Gemini Code Assist no seu ficheiro de código, certifique-se de que a linguagem de programação do ficheiro é suportada. Para mais informações sobre as linguagens de programação suportadas, consulte o artigo Linguagens de programação suportadas.

3. Se preferir usar o IDE através de um proxy, consulte o artigo Proxy HTTP.

Use o chat do Gemini Code Assist para explicar o seu código

Nesta secção, pede ao Gemini Code Assist para fornecer uma explicação do seu código existente.

VS Code

Para receber uma explicação do seu código, siga estes passos:

1. Abra o ficheiro de código.

2. Na barra de atividade do IDE, clique em spark Gemini Code Assist.

3. No painel Gemini Code Assist, introduza o comando Explain this code to me e clique em send Enviar.

   O Gemini Code Assist usa o código no seu ficheiro de código como referência para o seu comando 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 no ficheiro, pode selecionar o bloco no ficheiro de código e, em seguida, pedir ajuda ao Gemini Code Assist.

IntelliJ

Para receber uma explicação do seu código, siga estes passos:

1. No IDE, abra o ficheiro de código.

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

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

Se quiser apenas uma explicação de uma determinada parte do seu código, pode selecionar determinado código e, em seguida, pedir novamente ao Gemini Code Assist. O Gemini Code Assist só usa o código selecionado como referência para a respetiva resposta gerada.

Quando o Gemini Code Assist lhe fornece código na respetiva resposta, pode selecionar as seguintes opções apresentadas no final da resposta:

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

• Inserir num novo ficheiro: abre um novo ficheiro e insere o código gerado no novo ficheiro.

  

Estas opções estão disponíveis quando o Gemini Code Assist identifica o idioma usado no bloco de código e se este idioma for suportado no IDE atual.

Veja o histórico de consultas

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

Crie vários chats

Pode criar vários chats com o Gemini Code Assist que contêm o seu próprio contexto separado de outros chats. O histórico do chat mostra o seu primeiro chat e a data/hora da última atualização. Existe um limite de 20 chats. Quando atinge este limite, o chat mais antigo é eliminado automaticamente quando adiciona um novo chat.

VS Code

1. Para adicionar um novo chat, clique em adicionar Novo chat e introduza o comando no campo de texto. Depois de introduzir o comando, o Gemini Code Assist cria o novo chat.
2. Para aceder ao seu chat anterior, clique em histórico Retomar chat anterior. É apresentada uma lista dos seus chats. Selecione o chat que quer ver.
3. Para eliminar uma discussão de chat, clique em Retomar chat anterior e, de seguida, clique em eliminar Eliminar junto ao chat que quer eliminar.

IntelliJ

1. Para adicionar um novo chat, clique em adicionar Novo chat e introduza o comando no campo de texto. Depois de introduzir o comando, o Gemini Code Assist cria o novo chat.
2. Para aceder ao seu chat anterior, clique em chat_bubble Chats recentes. É apresentada uma lista dos seus chats. Selecione o chat que quer ver.
3. Para eliminar uma discussão de chat, clique em Chats recentes e, de seguida, clique em eliminar Eliminar junto ao chat que quer eliminar.

Limpe o histórico do chat

O Gemini Code Assist usa o histórico do chat para contexto adicional quando responde aos seus comandos. Se o seu histórico de conversas já não for relevante, pode limpar o histórico de conversas.

Faça a gestão do chat

Pode gerir as definições de chat do Gemini Code Assist da seguinte forma:

Configure o deslocamento automático

VS Code

Por predefinição, o Gemini Code Assist desloca automaticamente o chat. Para desativar este comportamento, execute as seguintes tarefas:

1. Navegue para Definições > Extensões > Gemini Code Assist.

2. Pesquise a definição Deslocamento automático e desmarque a caixa de verificação.

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ e outros IDEs da JetBrains.

Pare o chat em curso

VS Code

Pode parar uma resposta de chat em curso premindo parar Parar:

IntelliJ

Pode parar uma resposta de chat em curso premindo parar Parar:

Edite um comando anterior

Quando edita um comando anterior, o Gemini Code Assist volta a gerar a resposta ao comando editado. Para editar o comando, siga estes passos:

VS Code

1. No painel de chat, passe o cursor do rato sobre o comando que quer editar.

2. Clique em editar Editar.

   

3. Faça alterações ao comando e clique em Atualizar.

   O Gemini Code Assist gera uma nova resposta ao seu comando editado.

IntelliJ

1. No painel de chat, passe o cursor do rato sobre o comando que quer editar.

2. Clique em editar Editar.

   

3. Faça alterações ao comando e clique em Atualizar.

   O Gemini Code Assist gera uma nova resposta ao seu comando editado.

Volte a gerar uma resposta a um comando

Se preferir, pode voltar a gerar uma resposta diferente ao comando mais recente seguindo estes passos:

VS Code

No painel de chat do Gemini Code Assist, na parte inferior da sua resposta mais recente, clique em Replay Gerar resposta novamente.

O Gemini Code Assist reavalia o seu comando recente e fornece uma nova resposta.

IntelliJ

No painel de chat do Gemini Code Assist, na parte inferior da sua resposta mais recente, clique em Replay Gerar resposta novamente.

O Gemini Code Assist reavalia o seu comando recente e fornece uma nova resposta.

Elimine pares de comandos e respostas

Para eliminar o seu comando e a resposta do Gemini Code Assist a esse comando específico, siga estes passos:

VS Code

1. No painel de chat, passe o cursor do rato sobre o comando que quer remover.

2. Clique em Eliminar.

   

3. Quando lhe for pedido que confirme se quer eliminar o par de comando e resposta, selecione Eliminar. Caso contrário, clique em Cancelar para cancelar a operação.

   O par de comando e resposta é removido do seu histórico de chat com o Gemini Code Assist.

IntelliJ

1. No painel de chat, passe o cursor do rato sobre o comando que quer remover.

2. Clique em Eliminar.

   

3. Quando lhe for pedido que confirme se quer eliminar o par de comando e resposta, selecione Eliminar. Caso contrário, clique em Cancelar para cancelar a operação.

   O par de comando e resposta é removido do seu histórico de chat com o Gemini Code Assist.

Configure o painel de pré-visualização de código

Por predefinição, a definição do painel de pré-visualização do código para o chat do Gemini Code Assist está ativada. Com esta definição ativada, o bloco de código de pré-visualização no chat do Gemini Code Assist mostra as primeiras 6 linhas de código. Pode expandir e reduzir blocos de código.

Para alterar a predefinição, execute as seguintes tarefas:

VS Code

1. No IDE, navegue para Definições > Extensões > Gemini Code Assist.

2. Pesquise a definição Apresentação do bloco de código predefinido.

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é-visualização: mostra apenas as primeiras 6 linhas de código no bloco de código. Tem de expandir o bloco de código na resposta do chat do Gemini Code Assist para ver o resto do código. Esta é a predefinição.

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

   Quando o IDE é recarregado, a nova definição entra em vigor.

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ e outros IDEs JetBrains.

Envie comandos ao Gemini Code Assist com código selecionado através do chat

O Gemini Code Assist pode realizar tarefas ou responder às suas perguntas com base no código que selecionar. Para obter código gerado com base num comando com código selecionado, siga estes passos:

VS Code

1. Na barra de atividade, clique em spark Gemini Code Assist para abrir o painel Gemini Code Assist.

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

3. No campo de texto do painel Gemini Code Assist, introduza um comando para o código selecionado.

   Por exemplo, selecione uma função no seu código e introduza o comando Write a unit test for this function.

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

IntelliJ

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

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

3. No campo de texto da janela de ferramentas do Gemini Code Assist, introduza um comando para o código selecionado.

   Por exemplo, selecione uma função no seu código e introduza 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.

Adicione fragmentos do código selecionados ao contexto

Pode selecionar, anexar e direcionar o Gemini Code Assist para se focar em fragmentos de código. A seleção de fragmentos de código permite a análise discreta de blocos de código mais pequenos em vez de ficheiros inteiros.

Quando seleciona um fragmento do código no seu ficheiro de código, pode dar instruções ao Gemini Code Assist para adicionar o fragmento do código ao Painel de contexto.

Tudo o que for selecionado na janela do editor, mas ainda não for adicionado ao painel de contexto, também é incluído automaticamente no contexto. Os fragmentos do código selecionados só são apresentados para uma única interação de chat. Não persistem na gaveta de contexto, mas permanecem no histórico do chat do Gemini Code Assist.

Nesta secção, adiciona um fragmento do código selecionado ao seu contexto e recebe uma explicação sobre o fragmento do código do Gemini Code Assist:

VS Code

1. No ficheiro de código, selecione um fragmento do código.

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

   O Gemini Code Assist adiciona o fragmento do código selecionado ao painel de contexto.

3. No campo de texto do Gemini Code Assist Chat, introduza o comando what does this code do?.

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

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ e outros IDEs da JetBrains.

Envie comandos ao Gemini Code Assist com o resultado do terminal selecionado através do chat

O Gemini Code Assist pode realizar tarefas ou responder às suas perguntas com base no resultado do terminal selecionado. Para receber uma explicação do resultado do terminal selecionado, siga estes passos:

VS Code

1. No IDE, abra o terminal (Ver > Terminal).

2. Selecione qualquer resultado do terminal.

3. Clique com o botão direito do rato no resultado do terminal selecionado e selecione Gemini Code Assist: Adicionar ao contexto do chat.

   O Gemini Code Assist adiciona o resultado do terminal ao painel de contexto.

4. No campo de texto do Gemini Code Assist Chat, introduza o comando what does this do?.

   O Gemini Code Assist responde ao seu comando com base no resultado do terminal selecionado na gaveta de contexto.

IntelliJ

1. No campo de texto do Gemini Code Assist Chat, introduza @terminal.

2. Na lista apresentada, em Terminais, selecione o terminal sobre o qual quer fazer uma consulta.

   

3. No campo de texto do Gemini Code Assist Chat, introduza o comando what does this do?.

   O Gemini Code Assist responde ao seu comando com base no resultado do terminal selecionado.

Especifique ficheiros e pastas no contexto do seu espaço de trabalho

Pode especificar ficheiros ou pastas no seu espaço de trabalho para o Gemini Code Assist usar como contexto. Quando especifica uma pasta, o Gemini Code Assist usa os ficheiros na pasta, bem como os ficheiros nas subpastas, como contexto.

Nota: quando inclui uma pasta, o Gemini Code Assist seleciona até aos primeiros 100 ficheiros que encontrar na pasta e nas respetivas subpastas. Se precisar de ter conhecimento da base de código além deste limite, recomendamos que considere usar a personalização de código.

VS Code

Para especificar ficheiros ou pastas no comando de chat, escreva @ e selecione o ficheiro ou a pasta que quer especificar.

Para receber uma explicação sobre as diferenças entre dois ficheiros na sua base de código, siga estes passos:

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

2. No painel Gemini Code Assist, introduza o comando Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 e prima Enter (para Windows e Linux) ou Return (para macOS) ou Tab. Também pode clicar no nome do ficheiro na lista para selecionar o ficheiro. Se clicar no nome do ficheiro, o ficheiro é adicionado ao contexto do comando e é aberto no IDE.

O Gemini Code Assist responde ao seu comando enquanto usa os dois ficheiros que especificou para contexto. O Gemini Code Assist também inclui os ficheiros que especificou em Fontes de contexto.

Agora que especificou esses ficheiros, pode continuar a fazer perguntas ou dar comandos adicionais no mesmo histórico do chat, sem ter de especificar os ficheiros novamente.

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

O Gemini Code Assist responde à sua consulta sobre o ficheiro que especificou no comando.

Nota: se limpar o histórico do chat, o Gemini Code Assist deixa de usar os seus ficheiros para contexto, e tem de especificar novamente os ficheiros no painel de chat através do símbolo @ se quiser fazer mais consultas sobre os ficheiros.

IntelliJ

Para especificar ficheiros ou pastas no comando de chat, escreva @ e selecione os ficheiros ou as pastas que quer especificar.

Para receber uma explicação sobre as diferenças entre dois ficheiros na sua base de código, siga estes passos:

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

2. No painel Gemini Code Assist, introduza o comando Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 e prima Enter (para Windows e Linux) ou Return (para macOS) ou Tab. Também pode clicar no nome do ficheiro na lista para selecionar o ficheiro. Se clicar no nome do ficheiro, o ficheiro é adicionado ao contexto do comando e é aberto no IDE.

O Gemini Code Assist responde ao seu comando enquanto usa os dois ficheiros que especificou para contexto. O Gemini Code Assist também inclui os ficheiros que especificou em Fontes de contexto.

Agora que especificou esses ficheiros, pode continuar a fazer perguntas ou dar comandos adicionais no mesmo histórico do chat, sem ter de os especificar novamente.

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

O Gemini Code Assist responde à sua consulta sobre o ficheiro que especificou no comando.

Nota: se limpar o histórico do chat, o Gemini Code Assist deixa de usar os seus ficheiros para contexto, e tem de especificar novamente os ficheiros ou as pastas no painel de chat através do símbolo @ se quiser fazer mais consultas sobre os ficheiros.

Faça a gestão de ficheiros e pastas no painel de contexto

Depois de especificar um ficheiro ou uma pasta a usar como contexto para os seus comandos do Gemini Code Assist, estes ficheiros e pastas são colocados na gaveta de contexto, onde os pode ver e remover do contexto do comando.

Para gerir os ficheiros e as pastas na gaveta de contexto, execute as seguintes tarefas:

VS Code

Nota: os chats criados com o Gemini Code Assist para VS Code antes da versão 2.34.0 não retêm nem apresentam o contexto guardado na gaveta de contexto. Isto pode originar problemas em que o chat não apresenta o contexto correto. Para criar e manter o contexto entre chats, recomendamos que limpe os chats antes desta versão.

1. Na barra de atividade do IDE, clique em spark Gemini Code Assist.

2. Para ver os ficheiros e as 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 atividade, clique em spark Gemini Code Assist.

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

   

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

Exclua ficheiros do contexto local

Por predefinição, o Gemini Code Assist exclui ficheiros da utilização local no contexto para o preenchimento automático de código, a geração de código, a transformação de código e o chat se os ficheiros forem especificados num ficheiro .aiexclude ou .gitignore.

Para saber como excluir ficheiros da utilização local, consulte o artigo Exclua ficheiros da utilização do Gemini Code Assist.

Reverta para um ponto de verificação no chat

Depois de aplicar as alterações geradas pelo Gemini Code Assist com base no seu comando, pode optar por reverter os ficheiros de código modificados para um determinado ponto de verificação, o que reverte todas as alterações aplicadas aos ficheiros de código.

A reversão para um ponto de verificação não reverte as alterações manuais que possa ter feito aos ficheiros de código.

Para reverter o ficheiro de código para um ponto de verificação, siga estes passos:

VS Code

No painel de chat do Gemini Code Assist, clique em Reverter para ponto de verificação. Esta ação reverte o ficheiro de código para o estado do ponto de verificação antes de terem sido feitas as edições.

IntelliJ

Esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ e outros IDEs JetBrains.

Veja as diferenças de código

Pré-visualizar

Este produto ou funcionalidade está em pré-visualização. Os produtos e as funcionalidades em pré-visualização estão disponíveis "tal como estão".

Por predefinição, o Gemini Code Assist sugere alterações ao seu código com uma diferença de código. Pode acionar esta diferença sempre que pedir ao Gemini Code Assist para fazer alterações ao seu código.

Nesta secção, pede ao Gemini Code Assist para otimizar o seu ficheiro de código, ver a diferença no ficheiro de código e aceitar ou rejeitar as alterações conforme preferir.

VS Code

1. Com o ficheiro de código aberto, peça ao Gemini Code Assist para optimize this file. Se quiser otimizar vários ficheiros e pastas, peça ao Gemini Code Assist para optimize @FILE1 and @FILE2.

   O Gemini Code Assist responde ao seu comando com sugestões de alterações de código nos ficheiros de código, juntamente com uma diferença inline que ilustra estas alterações.

2. No ficheiro de código, clique em check_small Aceitar ou close_small Rejeitar.

   

3. Se o Gemini Code Assist sugerir várias alterações nos seus ficheiros de código, clique em Ver acima da sugestão e, de seguida, clique em Seguinte ou Anterior para percorrer as outras sugestões.

4. Se quiser aceitar ou rejeitar todas as alterações sugeridas, clique em Aceitar ficheiro ou Rejeitar ficheiro.

   

5. Também pode usar a pré-visualização rápida na resposta do comando para aceitar ou rejeitar todas as sugestões em vários ficheiros de código.

   

IntelliJ

1. Com o ficheiro de código aberto, peça ao Gemini Code Assist para optimize this file. Se quiser otimizar vários ficheiros e pastas, peça ao Gemini Code Assist para optimize @FILE1 and @FILE2.

   O Gemini Code Assist responde ao seu comando com sugestões de alterações de código nos ficheiros de código, juntamente com uma diferença na resposta do chat que ilustra estas alterações.

2. Na resposta do chat, clique em check_smallAceitar alterações.

   

Altere as definições da vista de diferenças

VS Code

Se preferir, pode alterar esta definição para ter uma janela de visualização de diferenças separada no seu IDE seguindo estes passos:

1. Na barra de atividade, navegue para definições Definições > Definições.

2. No separador Utilizador das definições, navegue para Extensões > Gemini Code Assist.

3. Desloque a página até à definição Geminicodeassist > Chat: Change View.

4. Na lista pendente, selecione uma das seguintes opções:

   • Sugestões inline (ativadas por predefinição): alterações de código apresentadas no ficheiro de código.
   • Vista de diferenças predefinida: abre um novo ficheiro com alterações de código lado a lado.

IntelliJ

De momento, esta funcionalidade não é suportada no Gemini Code Assist para IntelliJ e outros IDEs JetBrains suportados.

Crie comandos personalizados

Por predefinição, o Gemini Code Assist oferece comandos como /generate para o VS Code e Gerar código para o IntelliJ e outros IDEs JetBrains suportados. Também pode criar os seus próprios comandos personalizados para ajudar a realizar tarefas repetitivas mais rapidamente no seu IDE.

Nesta secção, cria um comando personalizado denominado add-comments que adiciona comentários ao código no ficheiro de código. Para o IntelliJ e outros IDEs da JetBrains suportados, vai criar, guardar e executar o comando personalizado a partir da biblioteca de comandos e do comando no editor.

VS Code

1. No ficheiro de código, prima Control+I (para Windows e Linux) ou Command+I (para macOS) para abrir o menu Gemini Code Assist Quick Pick.

2. No menu, pesquise e selecione Preferências: abrir definições (IU).

3. No campo Definições de pesquisa, introduza Geminicodeassist: Custom Commands.

4. Na caixa Comandos personalizados, selecione Adicionar item.

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

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

7. Clique em OK.

Agora, pode usar o comando personalizado add-comments no seu IDE. O comando é apresentado 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 IDE, navegue para Definições > Ferramentas > Gemini > Biblioteca de comandos.

   

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

3. Atribua um nome ao comando personalizado add-comments.

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

5. Se a caixa de verificação Mostrar no comando no editor não estiver selecionada, selecione-a.

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

7. No ficheiro de código, realce o código que quer modificar.

8. Clique com o botão direito do rato no código realçado e navegue para Gemini > Biblioteca de comandos e, de seguida, selecione o comando personalizado add-comments.

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

Também pode invocar o comando personalizado com o comando no editor realizando as seguintes tarefas:

1. No ficheiro de código, realce o código que quer modificar e prima Alt+\ (para Windows e Linux) ou Cmd+\ (para macOS) para abrir o menu Seleção rápida do Gemini Code Assist.

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

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

Crie regras

Pode criar regras para o Gemini Code Assist seguir, e as regras são incluídas em todos os comandos de chat que introduzir.

As regras no Gemini permitem-lhe definir as suas preferências, como:

• Estilo de programação
• Formatos de saída
• Pilha tecnológica
• Idioma

Por exemplo, pode criar uma regra como "Dá-me sempre respostas concisas em Kotlin".

VS Code

1. No ficheiro de código, prima Control+I (para Windows e Linux) ou Command+I (para macOS) para abrir o menu Gemini Code Assist Quick Pick.

2. No menu, pesquise e selecione Preferências: abrir definições (IU).

3. No campo Definições de pesquisa, introduza Geminicodeassist: Rules.

4. No campo de texto, introduza uma regra, como: Always generate unit tests when creating a new function. Também pode adicionar uma ou mais regras com várias linhas no campo de texto.

   Depois de adicionar regras nas definições de regras, o Gemini Code Assist considera a regra para cada comando ou pedido que fizer.

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

IntelliJ

Nota: as regras não são usadas no modo de agente.

1. Para criar uma regra, aceda a Definições > Ferramentas > Gemini > Biblioteca de comandos > Regras e, em seguida, edite o texto no editor.

2. Para definir o âmbito da regra, no menu pendente Âmbito, selecione IDE ou Projeto.

   • As regras ao nível do IDE são privadas e podem ser usadas em vários projetos.
   • As regras ao nível do projeto podem ser partilhadas entre colegas que trabalham no mesmo projeto.

   Para partilhar comandos com a equipa, tem de adicionar a pasta .idea ao sistema de controlo de versões.

Problemas conhecidos

Esta secçã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 ficheiro aberto grande

  Para contornar este problema, selecione uma secção de código mais pequena e inclua uma diretiva adicional no comando de chat, como only output the selected code.

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

  Quando usa o plug-in Vim no modo normal, não pode aceitar nem ignorar sugestões de código.

  Para contornar este problema, prima i para entrar no modo de inserção e, em seguida, prima Tab para aceitar a sugestão.

• Vim: comportamento inconsistente quando prime Esc para ignorar as sugestões

  Quando prime Esc, as sugestões do IDE e do Gemini Code Assist são ignoradas. Este comportamento é diferente do comportamento sem o Vim, em que premir Esc reativa o Gemini Code Assist.

• As tentativas de início de sessão continuam a atingir o limite de tempo

  Se as suas tentativas de início de sessão continuarem a expirar, experimente adicionar a definição cloudcode.beta.forceOobLogin ao seu ficheiro settings.json:

   "cloudcode.beta.forceOobLogin": true
  

• Os avisos de recitação de licenças não persistem entre sessões

  Se os avisos de recitação de licenças não persistirem entre sessões, consulte os registos persistentes:

  1. Clique em Ver > Resultado.

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

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

  Se vir um erro de ligação ou outros problemas de conetividade na janela de saída do Gemini Code Assist, experimente o seguinte:

  • Configure a sua firewall para permitir o acesso a oauth2.googleapis.com e cloudaicompanion.googleapis.com.

  • Configure a sua firewall para permitir a comunicação através de HTTP/2, que o gRPC usa.

  Pode usar a ferramenta grpc-health-probe para testar a conetividade. 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 sem êxito 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
  

• A opção "Ativar Gemini Code Assist" continua a aparecer depois de selecionar o projeto do Gemini Code Assist

  Se selecionou o seu projeto de acordo com as instruções neste guia, que incluem a ativação da API Gemini for Google Cloud, pode haver um problema com o servidor LS.

  Para saber mais detalhes sobre o seu problema, efetue as seguintes ações:

  1. Na barra de estado, clique em spark Gemini Code Assist e, de seguida, selecione Enviar feedback.

  2. Clique em Mostrar para qualquer um dos ficheiros de registo para ver mais detalhes e ajudar a resolver o problema.

IntelliJ

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

Deixar feedback

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

VS Code

1. Pode enviar feedback de uma das seguintes formas:

   • Na barra de estado, clique em spark Assistente de código do Gemini e, de seguida, no menu Seleção rápida, selecione Enviar feedback.
   • Abra a paleta de comandos (Ctrl/Command + Shift + P) e, de seguida, 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 pendentes Categoria de feedback e Tipo.

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

5. Certifique-se de que inclui os registos do Gemini Code Assist no seu relatório de feedback. Por predefinição, esta opção está selecionada.

6. Selecione ou desmarque qualquer uma das outras opções, conforme preferir.

7. Clique em Enviar feedback.

IntelliJ

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

2. Depois de pedir ao Gemini Code Assist no chat e se não ficar satisfeito com a resposta, clique em thumb_down Negativo e, de seguida, selecione Enviar feedback.

3. No campo de texto na parte superior do formulário, introduza o seu feedback.

4. Se quiser partilhar os seus registos do Gemini Code Assist, certifique-se de que seleciona os ficheiros de registo.

5. Clique em Enviar feedback.

O que se segue?

• Saiba como escrever melhores comandos.
• Saiba como o Gemini para Google Cloud usa os seus dados.
• Saiba mais sobre os preços do Gemini Code Assist.
• Saiba mais sobre a Google Cloud conformidade.