Programar com o Gemini Code Assist

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

• 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 de Cloud Shell Editor e se familiarize com o Google Cloud. Se preferir, você também pode conhecer o Gemini Code Assist no Cloud Workstations; Cloud Code para IntelliJ Cloud Code para VS 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 editor do Cloud Shell.

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.

Para se conectar ao Google Cloud o Cloud Shell Editor, siga estas etapas:

1. Inicie o editor do Cloud Shell

2. Se você estiver usando o Editor legado, clique em Testar o novo Editor.

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

   

4. Se for preciso autorizar o Editor do Cloud Shell a tornar o Google Cloud chamadas de API, clique em Autorizar.

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

   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 é alterado.

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

1. Abra o arquivo de código.

2. Na barra de atividades do Cloud Shell Editor, Clique no spark Gemini Code Assist.

3. No painel Gemini Code Assist, insira o comando Explain this code to me e clique em Enviar 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 excluir Redefinir chat.

Observação :o histórico de chat é redefinido automaticamente quando você troca o espaço de trabalho ou saia do Editor do Cloud Shell.

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, digite o comentário Function to create a Cloud Storage bucket e pressione Enter (para Windows e Linux). ou Return (no 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 editor do Cloud Shell, clicar menu Menu e navegue até Arquivo > Preferências > Atalhos do teclado.

2. Na lista de atalhos de teclado, pesquise Cloud Code: Generate Code.

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 (para Windows e Linux) ou Return (para macOS).

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

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 editor do Cloud Shell, selecionar menu Menu e navegue até Arquivo > Preferências > 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 lâmpada Exibir 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.

Prévia: Usar transformações de código

Visualização

Este produto ou recurso está sujeito aos "Termos das ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos do serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O Gemini Code Assist oferece transformações de código, o que permite selecionar uma parte do arquivo de código e solicitar modificações ao seu código existente por meio de comandos em linguagem natural, usando uma caixa de texto inline.

Com as transformações de código, é possível fazer o seguinte:

• Gere linhas de comentários para documentar seu código
• Resolver problemas no código
• Melhorar a legibilidade do código
• Tornar o código mais eficiente

Você também pode conferir as fontes de contexto de uma resposta gerada no Gemini: Chat.

Criar um comando para o Gemini Code Assist com a caixa de texto inline

A caixa de texto inline permite interagir com o Gemini Code Assist diretamente no seu arquivo de código.

Para abrir a caixa de texto inline e o comando ao Gemini, siga estas instruções etapas:

1. No arquivo de código, pressione Control+I (para Windows e Linux) ou Command + I (para macOS).

2. Insira um comando, como Write a function to create a Cloud Storage bucket, e pressione Enter (no Windows e Linux) ou Return (no macOS).

   O Gemini Code Assist gera o código com base no seu comando.

Conferir diferenças do código refatorado

Com a visualização de diferenças integrada na caixa de texto inline, você pode ver as alterações que o Gemini e seu código original. Você pode aceitar ou descartar as mudanças sugeridas.

Para ver as diferenças entre o código refatorado na caixa de texto inline, execute o etapas a seguir:

1. No arquivo de código, selecione uma função e abra a caixa de texto inline pressionando Control + I (para Windows e Linux) ou Command + I (para macOS).

2. Digite um prompt, como Add comments, e pressione Enter (no Windows e Linux) ou Return (para macOS).

   Quando o Gemini gera o código, muda o código a visualização de diferenças será exibida.

   

3. Para aceitar ou descartar as mudanças, clique em Aceitar ou Descartar.

Conferir origens de contexto de uma resposta gerada

O recurso de exibição de contexto lista os arquivos do seu projeto (as origens de contexto) que foram usadas como referência para gerar respostas aos seus comandos. Saber qual foram usados como referência ajuda a refinar os comandos e obter respostas específicas. As origens de contexto aparecem sempre que você usa conversa no Gemini.

Para conferir as fontes de contexto da resposta gerada, no Gemini: Chat role até encontrar o snippet Fontes de contexto. Expandir o snippet para conferir todas as fontes de contexto.

Usar comandos inteligentes

Os comandos inteligentes podem ser usados na caixa de texto inline para executar ações específicas ao código.

Para conferir uma explicação de todo o arquivo de código com a /explain , siga estas etapas:

1. No arquivo de código, abra a caixa de texto inline pressionando Control + I. (para Windows e Linux) ou Command + I (para macOS).

2. Pressione / para ver a lista de comandos inteligentes e as descrições deles.

3. Selecione /explain.

   O Gemini gera uma explicação de todo o arquivo de código na caixa de texto inline.

4. Opcional: se você quiser conferir a resposta gerada no Gemini: Chat clique em Ver no Chat.

Ver histórico de solicitações

Acessar o histórico de comandos economiza tempo quando você precisa inserir as mesmas comandos em um arquivo de código grande.

Para acessar o histórico de comandos, no arquivo de código, abra a caixa de texto inline pressione Control + I (para Windows e Linux) ou Command + I (para macOS) e depois pressione Control+seta para cima (no Windows e Linux). ou Command + seta para cima (no macOS). Isso permite que você percorra seus comandos mais antigos e reutilizá-los quando necessário.

Melhorar a legibilidade do código para falantes não nativos de inglês

Se você não é falante nativo do inglês e usa aplicativos de tradução, você pode usar a caixa de texto inline para gerar comentários em outros idiomas.

Para converter comentários em inglês para outro idioma ou adicionar novos comentários em outro. siga estas etapas:

1. No arquivo de código, selecione o código em que você quer adicionar comentários.

2. Abra a caixa de texto inline pressionando Control+I (para Windows e Linux) ou Command + I (para macOS).

3. Digite um comando, como Add spanish comments, e pressione Enter (para Windows e Linux) ou Return (para macOS).

   O Gemini gera comentários no idioma especificado no comando e analisa as diferenças entre essas sugestões.

4. Para aceitar ou descartar essas alterações no código, clique em Aceitar ou Descartar.

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

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 no menu Menu > 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.