Fornece orientações para ajudar você a resolver problemas com seu código.
Gerar código para seu projeto.
Receba sugestões inline enquanto codifica.
O Gemini não usa seus comandos nem as respostas deles como dados para treinar os modelos. Para mais informações, consulte Como o Gemini para o Google Cloud usa seus dados.
Para ajudar você a obedecer a todos os requisitos de licença do código, o Gemini Code Assist fornece citações de origem quando as sugestões citam diretamente uma fonte específica. Para saber mais sobre como e quando o Gemini cita fontes, consulte Como o Gemini ajuda a gerar código e citar fontes.Este documento é destinado a desenvolvedores de todos os níveis de habilidade. Para isso, é preciso ter conhecimento prático de VS Code e familiaridade com o Google Cloud. Se preferir, também é possível explorar o Gemini Code Assist no Cloud Workstations, Cloud Code for IntelliJ e Cloud Shell Editor.
Antes de começar
- Instale a extensão do Cloud Code, caso ainda não tenha feito isso. O Cloud Code se integra ao Gemini Code Assist no seu ambiente de desenvolvimento integrado.
- Opcional: se você optar por clonar uma amostra para as tarefas deste documento, instale o Git (em inglês). O Git é necessário para copiar amostras na sua máquina.
Conecte-se ao Google Cloud e selecione um projeto
Nesta seção, você se conectará ao Google Cloud e selecionará um projeto do Google Cloud com a API Cloud AI Companion ativada no ambiente de desenvolvimento integrado.
Se você selecionar um projeto do Google Cloud sem a API Cloud AI Companion ativada, receberá uma notificação de erro e será instruído a entrar em contato com seu administrador. Para mais informações, consulte Configurar o Gemini Code Assist para um projeto.
Se você preferir seguir o tutorial Code with Gemini Code Assist diretamente no ambiente de desenvolvimento integrado, clique em Iniciar o VS Code e siga as etapas no tutorial para se conectar ao Google Cloud e ativar o Assistente de código do Genmini.
Caso contrário, siga estas etapas:
Inicie seu ambiente de desenvolvimento integrado.
Na barra de status, clique em Cloud Code - Login.
Quando for solicitado que o Cloud Code abra o site externo, clique em Abrir.
Siga as instruções para fazer login na sua Conta do Google.
Quando for perguntado se você fez o download do Cloud Code no Google, clique em Fazer login.
Agora você está conectado ao Google Cloud.
Em seguida, para selecionar um projeto do Google Cloud que tenha a API Cloud AI Companion ativada, siga estas etapas:
Na barra de status do Gemini Code Assist, clique em Gemini Code Assist.
No menu do Gemini Code Assist, selecione Selecionar projeto do Gemini Code Assist.
Selecione um projeto do Google Cloud que tenha a API Cloud AI Companion ativada.
O Gemini está pronto para uso.
Para testar os recursos do Gemini Code Assist, abra um aplicativo ou crie um aplicativo de amostra na próxima seção.
Opcional: criar um aplicativo de amostra
Se você preferir usar um aplicativo existente para testar os recursos do Genmini Code Assist, pule esta seção. Caso contrário, para criar um aplicativo de amostra, siga estas etapas:
No seu ambiente de desenvolvimento integrado, abra a paleta de comandos: pressione Control+Shift+P (para Windows e Linux) ou Command+Shift+P (para macOS) e execute Cloud Code: New Application.
Selecione Aplicativo do Kubernetes.
Selecione o modelo de aplicativo Python (Flask): Livro de visitas.
Salve o novo aplicativo no local de sua preferência.
Uma notificação confirma que seu aplicativo foi criado e uma nova janela é aberta com o aplicativo carregado.
Converse com o Gemini Code Assist
Nesta seção, você aprenderá a abrir o painel Gemini Code Assist e conversar com ele para entender melhor seu código.
Para começar a conversar com o Gemini, siga estas etapas:
Crie um novo arquivo de código ou use um existente. Se você estiver usando o exemplo Python (Flask), execute esta tarefa no arquivo
front.py: navegue até Explorer > src > frontend e abra o arquivofront.py.Na barra de atividades do seu ambiente de desenvolvimento integrado, clique em chat_spark Gemini Code Assist.
No painel Gemini Code Assist, digite o comando
Explain this code to mee clique em enviar Enviar.Gemini usa o código no arquivo de código como referência 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 no arquivo, selecione o bloco no arquivo de código e solicite o Gêmini.
Redefinir histórico de chat
O Gemini Code Assist usa o histórico de chat para oferecer mais contexto ao responder aos comandos.
Se o histórico de chat não for mais relevante para o que você está tentando fazer, redefina o histórico: no painel Gemini Code Assist, clique em excluir Redefinir chat.
Gerar código com comandos
As seções a seguir mostram como usar o Gemini Code Assist para
gerar código com o prompt de exemplo # Function to create a Cloud Storage bucket
dentro de um arquivo Python. Você também pode selecionar uma
parte do código e pedir ajuda ao Gemini Code Assist
pelo recurso de chat, além de receber e aceitar ou rejeitar sugestões de
código enquanto escreve.
Solicitar o Gemini Code Assist em um arquivo de código
Crie um novo arquivo de código ou use um existente. Se você estiver usando o exemplo Python (Flask), faça isso no arquivo
front.py: navegue até Explorer > src > frontend e abra o arquivofront.py.No arquivo de código, em uma nova linha, digite
# Function to create a Cloud Storage buckete pressione Enter (para Windows e Linux) ou Return (para macOS).Para gerar o código, pressione Control+Enter (para Windows e Linux) ou Control+Return (para macOS).
Ao lado do texto do comando no arquivo Python, o Gemini Code Assist gera o código na forma de texto fantasma.
Opcional: para aceitar o código gerado, pressione Tab.
Opcional: mudar o atalho do teclado para gerar código
Se o atalho de teclado padrão para gerar código não está funcionando como descrito na seção anterior, você pode mudar o atalho seguindo estas etapas:
No seu ambiente de desenvolvimento integrado, clique em File (para Windows e Linux) ou em Code (para macOS) e navegue até Settings > Keyboard Shortcuts.
Na lista de atalhos do teclado, role até encontrar Cloud Code: gerar código.
Clique em Cloud Code: Generate Code e, em seguida, clique em Editar Alterar vinculação de chaves.
Na caixa de diálogo exibida, insira seu próprio atalho.
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 Code Assist.
Para saber mais sobre como mudar atalhos no ambiente de desenvolvimento integrado, consulte Vinculação de teclas para o Visual Studio Code.
Solicitar o Gemini Code Assist com código selecionado usando o chat
O Gemini Code Assist pode realizar tarefas ou responder às suas perguntas com base no código que você selecionar. Para receber o código gerado com base em um prompt com o código selecionado, siga estas etapas:
No ambiente de desenvolvimento integrado, abra um arquivo no projeto que contenha código ou use o mesmo arquivo de código usado nas etapas anteriores.
Na barra de atividades, clique em chat_spark Gemini Code Assist para abrir o painel Gemini Code Assist.
No arquivo de código, selecione um bloco.
No campo de texto do painel Gemini Code Assist, digite um comando para o código selecionado.
Por exemplo, selecione uma função no seu código e insira o comando
Write a unit test for this function:
Gemini usa o código selecionado como referência e responde ao comando.
Receba sugestões inline enquanto escreve
Enquanto você escreve o código, o Gemini Code Assist faz sugestões de código in-line que você pode aceitar ou ignorar. Para testar esse recurso, siga estas etapas:
Crie um novo arquivo de código ou use um existente. Se você estiver usando o exemplo Python (Flask), faça isso no arquivo
front.py: navegue até Explorer > src > frontend e abra o arquivofront.py.No arquivo de código, em uma nova linha, comece a escrever uma função. Por exemplo, se você estiver em um arquivo Python, escreva
def.O Gemini sugere um código na forma de texto fantasma.
Para aceitar a sugestão de código do Gemini Code Assist, pressione Tab. Caso contrário, para ignorar a sugestão, pressione Esc ou continue escrevendo o código.
Opcional: desativar as sugestões in-line
Se você preferir desativar as sugestões in-line no Gemini Code Assist, siga estas etapas:
No seu ambiente de desenvolvimento integrado, selecione Code (para macOS) ou File (para Windows e Linux) e navegue até Settings > Settings.
Na guia Usuário da caixa de diálogo Configurações, navegue até Extensões > Cloud Code.
Role até encontrar a lista Cloudcode: Gemini Code Assist: sugestões in-line: ativar Auto e selecione Desativado.
Essa ação desativa as sugestões inline. Ainda é possível pressionar Control+Enter (para Windows e Linux) ou Control+Return (para macOS) para acionar manualmente as sugestões inline.
Desativar sugestões de código que correspondam às fontes citadas
Gemini fornece informações de citação quando ela cita diretamente outra fonte, como código fonte aberto. Para mais informações, consulte Como e quando o Gemini cita fontes.
Para evitar que um código correspondente às fontes citadas seja sugerido, modifique
a configuração cloudcode.duetAI.recitation.maxCitedLength para 0 em um
arquivo settings.json:
"cloudcode.duetAI.recitation.maxCitedLength": 0
Usar ações inteligentes
Para aumentar sua produtividade e minimizar a troca de contexto, o Genmini Code Assist fornece ações inteligentes com tecnologia de IA diretamente no seu editor de código. Ao selecionar o código no editor, você pode ver e selecionar em uma lista de ações relevantes para seu contexto.
Para usar ações inteligentes no seu código, siga estas etapas:
No arquivo de código, selecione um bloco.
Ao lado do bloco de código selecionado, clique em lâmpada Mostrar ações de código.
Selecione uma ação, como Generate unit testes.
Gemini gera uma resposta com base na ação que você selecionou.
Testar outros exemplos de comandos
Depois de ler a seção Gerar código com comandos deste documento, tente alguns dos comandos de exemplo a seguir.
Receber uma explicação do código
- No arquivo de código, selecione uma função que você queira explicar.
No painel Gemini Code Assist, digite o comando
Explain this code to me.Gemini usa o código selecionado como referência e responde com uma explicação da função selecionada.
Gerar planos de teste
- No arquivo de código, selecione o código em que você quer adicionar testes de unidade.
- No painel Gemini Code Assist, digite o comando
Write unit tests for my code.
Receber ajuda com a depuração do código
- No arquivo de código, selecione o código que você quer depurar.
- No painel Gemini Code Assist, digite o comando
Help me debug my code.
Tornar seu código mais legível
- No arquivo de código, selecione o código que você quer deixar mais legível.
No painel Gemini Code Assist, digite o comando
Make my code more readable.Se você preferir se concentrar em uma parte específica do código, selecione a parte preferencial antes de solicitar o Gemini.
Problemas conhecidos
As seções a seguir descrevem os problemas conhecidos do Gemini Code Assist.
As respostas do chat podem ficar truncadas quando incluem a versão atualizada de um arquivo grande aberto
Para contornar esse problema, selecione uma seção menor de código e inclua uma
diretiva adicional na solicitação 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 no modo de inserção
Ao usar o plug-in Vim no modo normal, não é possível aceitar ou dispensar as sugestões de código.
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 as sugestões.
Quando você pressiona Esc, as sugestões do IntelliJ e do Gemini são dispensadas. Esse comportamento é diferente do comportamento do não-Vim, em que pressionar Esc aciona novamente o Gemini.
Os avisos de recitação de licenças não persistem entre as sessões
Se os avisos de recitação de licença não persistirem nas sessões, consulte os registros persistentes:
Clique em Visualizar > Saída.
Selecione Gemini Code Assist - Citations.
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 o firewall para permitir o acesso a
oauth2.googleapis.comecloudaicompanion.googleapis.com.Configure seu 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 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
Enviar feedback
Para enviar feedback sobre sua experiência, siga estas etapas:
Na barra de status, clique em Gemini Code Assist e, no menu Seleção rápida, selecione Enviar feedback.
No formulário, preencha os campos Title e Comments.
Caso queira compartilhar os registros do Skaffold ou do AI Companion, selecione a opção Enviar registros do Skaffold ou Enviar registros do AI Companion.
Clique em Enviar feedback.
A seguir
- Saiba como escrever comandos melhores.