Programar com o Gemini Code Assist

Neste documento, descrevemos como usar O Gemini Code Assist, uma ferramenta com tecnologia de IA colaborador no Google Cloud, para ajudar você a fazer o seguinte no Cloud Code:

• Fornecer orientações para ajudar você a resolver problemas com seu código.

• Gere o código do seu projeto.

• Receba sugestões inline enquanto estiver codificando.

Saiba como e quando o Gemini do Google Cloud usa seus dados.

Para ajudar você atender aos requisitos de licença para seu código, O Gemini Code Assist faz citações de fontes quando as sugestões dele citação direta de uma fonte específica. Para saber mais sobre como quando o Gemini cita fontes, consulte Como o Gemini ajuda você a gerar código e cita fontes.

Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Ele pressupõe que você ter conhecimento prático sobre o VS Code; e tem familiaridade com o Google Cloud. Se preferir, você também pode conhecer o Gemini Code Assist no Cloud Workstations; Cloud Code para IntelliJ Editor do Cloud Shell.

Antes de começar

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

2. Instale o Gemini Code Assist + extensão do Cloud Code caso ainda não tenha feito isso. O Cloud Code se integra o Gemini Code Assist no seu ambiente de desenvolvimento integrado.

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

Conecte-se ao Google Cloud e selecione um projeto

Nesta seção, você vai se conectar ao Google Cloud e selecionar uma Projeto do Google Cloud com a API Cloud AI Companion ativada em no seu ambiente de desenvolvimento integrado.

Se você selecionar um projeto do Google Cloud sem as com a API Cloud AI Companion ativada, você vai receber uma notificação a opção de ativar a API no IDE. Selecione Ativar a API no janela de notificação para ativar a API no projeto. Para mais informações, consulte Configurar o Gemini Code Assist para um projeto.

Se preferir seguir o guia Programar com o Gemini Code Assist diretamente no seu ambiente de desenvolvimento integrado, clique em Iniciar o VS Code e siga as etapas no tutorial para se conectar ao Google Cloud e ativar Gemini Code Assist

Iniciar o VS Code

Caso contrário, siga estas etapas:

1. Inicie seu IDE.

2. Em Na barra de status, clique em Cloud Code - Fazer login.

   

3. Quando for solicitado que o Cloud Code abra o site externo, clique em Abrir.

4. Siga as instruções para fazer login na sua Conta do Google.

5. Quando aparecer a mensagem perguntando se você fez o download do Cloud Code do Google, clique em Fazer login.

   Observação :se o tempo das tentativas de login continuar expirando, consulte As tentativas de login continuam atingindo o tempo limite. problema para mais informações sobre solução de problemas.

   Você se conectou ao Google Cloud.

Em seguida, para selecionar um projeto do Google Cloud que tenha a API Cloud AI Companion ativado, siga estas etapas:

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

   

2. No menu Gemini Code Assist, selecione Selecionar projeto do Gemini Code Assist.

3. Selecione um projeto do Google Cloud com A API Cloud AI Companion ativada.

   O Gemini está pronto para uso.

   

Conversar com o Gemini Code Assist

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloud podem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todos os resultados do Gemini para produtos do Google Cloud antes de usá-los. Para mais informações, consulte Gemini no Google Cloud e IA responsável.

Nesta seção, você vai aprender a abrir o painel Gemini Code Assist e conversar com o Gemini Code Assist para entender melhor o código-fonte.

Para começar a conversar com o Gemini, siga estas etapas:

1. Abra o arquivo de código.

2. Na barra de atividades do IDE, Clique no spark Gemini Code Assist.

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

   O Gemini usa o código do seu arquivo como referência ao ao comando e responde com uma explicação do código.

   Para se referir a um bloco de código específico em vez de todo o código do arquivo, pode selecionar o bloco no seu arquivo de código e depois executar o comando ao Gemini.

Redefinir histórico de chat

O Gemini Code Assist usa o histórico de chat para oferecer mais contexto ao responder aos seus comandos.

Caso seu histórico de chat não seja mais relevante para o objetivo, você poderá Se quiser redefinir o histórico de chat: no painel Gemini Code Assist, clique delete Redefinir chat.

Observação :o histórico de chat é redefinido automaticamente quando você troca o espaço de trabalho ou saia do ambiente de desenvolvimento integrado.

Gerar código com comandos

As seções a seguir mostram como usar o Gemini Code Assist para gere código com o comando de exemplo Function to create a Cloud Storage bucket no arquivo de código. Também é possível selecionar uma parte do código e enviar um comando para o Gemini Code Assist pelo recurso de chat; e receber e aceitar ou rejeitar sugestões enquanto você codifica.

Criar um comando para o Gemini Code Assist em um arquivo de código

1. No arquivo de código, em uma nova linha, pressione Control+I (para Windows e Linux) ou Command + I (no macOS) para abrir Menu Escolha rápida do Gemini Code Assist.

2. No menu, usando o comando /generate, digite /generate function to create a cloud storage bucket e pressione Enter (no Windows). e Linux) ou Return (para macOS).

   

   O Gemini Code Assist gera o código com base no seu comando em um visualização de diferenças.

   

3. Opcional: para aceitar essas mudanças, clique em Aceitar.

Opcional: crie um comando para o Gemini Code Assist em um arquivo de código com um comentário

Se preferir, você também pode acionar o Gemini Code Assist no seu com um comentário, seguindo estas etapas:

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

2. Para gerar um código, pressione Control+Enter (para Windows e 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.

3. Opcional: para aceitar o código gerado, pressione Tab.

Opcional: mudar o atalho de 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, você pode alterar o atalho de teclado seguindo estas etapas:

1. No ambiente de desenvolvimento integrado, clique em File (para Windows e Linux) ou Code (para macOS). e navegue até Configurações > Atalhos do teclado.

2. Na lista de atalhos de teclado, role até encontrar a opção Cloud Code: Gerar código

3. Clique em Cloud Code: gerar código e selecione edit Alterar vinculação de teclas.

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

5. Pressione Enter (no Windows e no Linux) ou Return (para macOS).

   Agora você pode usar o atalho de teclado recém-atribuído para gerar código com Gemini Code Assist

Para saber mais sobre como alterar atalhos no seu ambiente de desenvolvimento integrado, consulte Vinculações de teclas para o Visual Studio Code.

Fazer comandos no Gemini Code Assist com o código selecionado pelo chat

O Gemini Code Assist pode realizar tarefas ou responder às suas perguntas com base no código selecionado. Para obter o código gerado com base em uma com o código selecionado, siga estas etapas:

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 à sua solicitação.

Receba sugestões inline enquanto você codifica

Enquanto você escreve o código, o Gemini Code Assist cria código in-line sugestões que você pode aceitar ou ignorar. Para testar esse recurso, siga estas etapas:

1. No arquivo de código, em uma nova linha, comece a escrever uma função. Por exemplo, se estiver em um arquivo Python, escreva def.

   O Gemini sugere código na forma de texto fantasma.

2. Para aceitar a sugestão de código do Gemini Code Assist, pressione Guia. Caso contrário, para ignorar a sugestão, pressione Esc ou continuar escrevendo seu código.

Opcional: desativar sugestões in-line

Se preferir desativar as sugestões inline no Gemini Code Assist, siga estas etapas:

1. No seu IDE, selecionar Code (para macOS) ou File (para Windows e Linux) e acesse Configurações > Configurações.

2. Na guia Usuário da caixa de diálogo Configurações, acesse Extensões. > Cloud Code.

3. Role a tela até encontrar Cloudcode: Gemini Code Assist: sugestões inline: ativar automática e selecione Desativado.

   Essa ação desativa as sugestões inline. Você ainda pode pressionar Control + Enter (para Windows e Linux) ou Control + Return (para macOS) acionar sugestões inline manualmente.

Desativar sugestões de código que correspondem às fontes citadas

O Gemini fornece informações de citação ao citar diretamente comprimento de outra fonte, como um código-fonte aberto já criado. Para mais informações, consulte Como e quando o Gemini cita fontes.

Para evitar que o código correspondente às fontes citadas seja sugerido, modifique a configuração cloudcode.duetAI.recitation.maxCitedLength como 0 em uma Arquivo settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

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 seu editor de código. Ao selecionar seu código no editor de código, é possível visualizar e selecione de uma lista de ações relevantes para o contexto.

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

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

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

   

3. Selecione uma ação, como Gerar testes de unidade.

   O Gemini gera uma resposta com base na ação que você selecionados.

Teste outros exemplos de comandos

Depois de ler seção Gerar código com comandos deste use alguns dos exemplos de comando a seguir.

Receber uma explicação do código

1. No arquivo de código, selecione uma função que você queira explicar.

2. No painel Gemini Code Assist, insira o comando Explain this code to me.

   O Gemini usa o código selecionado como referência e responde com uma explicação da função selecionada.

Gerar planos de teste

1. No arquivo de código, selecione o código em que você quer adicionar testes de unidade.
2. No painel Gemini Code Assist, insira o comando Write unit tests for my code.

Receber ajuda com a depuração do código

1. No arquivo de código, selecione o código que você quer depurar.
2. No painel Gemini Code Assist, insira o comando Help me debug my code.

Tornar seu código mais legível

1. No arquivo de código, selecione aquele que você quer facilitar a leitura.

2. No painel Gemini Code Assist, insira o comando Make my code more readable.

   Se você preferir se concentrar em uma parte específica do código, selecione o parte preferida do código antes de enviar o comando ao Gemini.

Problemas conhecidos

As seções a seguir descrevem os problemas conhecidos de Gemini Code Assist

As respostas do chat podem ficar truncadas quando incluem uma versão atualizada de um arquivo grande aberto.

Para contornar esse problema, selecione uma seção menor do código e inclua uma diretiva extra no comando 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 dispensar o código sugestões.

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ões

Quando você pressiona Esc, o IntelliJ e o Gemini sugestões foram dispensadas. Esse comportamento é diferente do não Vim em que pressionar Esc aciona o Gemini novamente.

As tentativas de login continuam expirando

Se as tentativas de login continuarem expirando, tente adicionar o 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 nas sessões

Se esses avisos não persistirem nas sessões, consulte 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 no Na janela de saída do Gemini Code Assist, tente o seguinte:

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

• Configure o firewall para permitir a comunicação por HTTP/2, que é usada pelo gRPC.

Use a ferramenta grpc-health-probe para testar a conectividade. Um bem-sucedido check 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 ver mais detalhes, execute o seguinte antes de grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

"Ativar o Gemini Code Assist" ainda aparece após selecionar o projeto do Gemini Code Assist

Se você selecionou seu projeto de acordo com as instruções desta que inclui ativar a API Cloud AI Companion, poderá haver 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 depois selecione Enviar feedback.

2. Clique em Mostrar em qualquer um dos arquivos de registro para ver mais detalhes e receber ajuda resolver o problema.

Enviar feedback

Para deixar um feedback sobre sua experiência, siga estas etapas:

1. Na barra de status, clique em Gemini Code Assist e, menu Escolha rápida, selecione Enviar feedback.

2. No formulário, preencha o Título e Campos Comentários.

3. Se quiser compartilhar o Skaffold ou o AI Companion registros, não se esqueça de selecionar Opção Enviar registros do Skaffold ou Enviar registros do AI Companion.

4. Clique em Enviar feedback.

A seguir

• Saiba como escrever comandos melhores.