Programe com a assistência da Duet AI

Neste documento, descrevemos como usar a Duet AI, uma colaboradora com tecnologia de IA do 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.
Gerar código para o projeto.
Receba sugestões inline enquanto codifica.

A Duet AI não usa seus prompts ou as respostas como dados para treinar o modelo. Para mais informações, consulte a página Como a Duet AI no Google Cloud usa seus dados.

Para ajudar a cumprir os requisitos de licença para seu código, a Duet AI fornece citações de fonte quando as sugestões citam diretamente uma fonte específica. Para saber mais sobre como e quando a Duet AI cita fontes, consulte Como a Duet AI 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ê tenha conhecimento prático sobre VS Code e familiaridade com o Google Cloud. Se preferir, também é possível explorar a Duet AI no Cloud Workstations, Cloud Code para IntelliJ e Editor do Cloud Shell.

Antes de começar

Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

Acessar o seletor de projetos

Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

Verifique se a Duet AI está configurada para seu projeto e conta de usuário do Google Cloud.
Instale a extensão do Cloud Code, caso ainda não tenha feito isso. O Cloud Code se integra à Duet AI no seu ambiente de desenvolvimento integrado.
Opcional: se você optar por clonar uma amostra para as tarefas neste documento, instale o Git. O Git é necessário para copiar amostras na sua máquina.

Conectar-se ao Google Cloud

Se você já estiver conectado ao Google Cloud no ambiente de desenvolvimento integrado, pule esta seção. Caso contrário, siga estas etapas:

Inicie o 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 solicitado, confirme se você fez o download do Cloud Code no Google clicando em Fazer login.

Agora você está conectado ao Google Cloud.

Ativar Duet AI no Cloud Code

Nesta seção, você ativará a Duet AI no Cloud Code. Antes de prosseguir, siga as instruções em Configurar a Duet AI para um projeto, caso ainda não tenha feito isso.

Para ativar a Duet AI no Cloud Code para seu ambiente de desenvolvimento integrado, siga estas etapas:

No seu ambiente de desenvolvimento integrado, selecione Code (para MacOS) ou File (para Windows e Linux) e navegue até Configurações > Configurações.
Na guia Usuário da caixa de diálogo Configurações, navegue até Extensões > Google Cloud Code.
Role a tela até encontrar Duet AI: ativar e marque a caixa de seleção Ativar Duet AI para desenvolvedores.
Atualize o ambiente de desenvolvimento integrado.
Isso ativa a Duet AI no Cloud Code, e a barra de status da Duet AI aparece no seu ambiente de desenvolvimento integrado.
Selecione um projeto do Google Cloud que tenha a API Cloud AI Companion ativada:
1. Na barra de status da Duet AI, clique em Duet AI.
2. No menu Escolha rápida da Duet AI, selecione um projeto do Google Cloud que tenha a API Cloud AI Companion ativada.
A Duet AI está pronta para uso.

Se você selecionar um projeto do Google Cloud sem a API Cloud AI Companion ativada, receberá uma notificação de erro e uma instrução para entrar em contato com o administrador. Para mais informações, consulte Configurar a Duet AI para um projeto.

Para testar os recursos da Duet AI, 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 atual para testar os recursos da Duet AI, pule esta seção. Caso contrário, para criar um aplicativo de exemplo, siga estas etapas:

No 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: novo aplicativo.
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 o aplicativo foi criado e uma nova janela é aberta com o aplicativo carregado.

Chat com a Duet AI

Nesta seção, você aprenderá a abrir o painel da Duet AI e a conversar com a Duet AI para receber uma explicação do código existente.

Para começar a conversar com a Duet AI, siga estas etapas:

Crie um arquivo de código novo ou use um já existente. Se você estiver usando o exemplo Python (Flask), realize esta tarefa no arquivo front.py: navegue até Explorer > src > front-end e abra o arquivo front.py.
Na barra de atividades do ambiente de desenvolvimento integrado, clique em chat_spark Duet AI.
No painel Duet AI, insira o comando Explain this code to me e clique em Enviar Enviar.

A Duet AI usa o código no arquivo de código como uma referência ao comando e responde com uma explicação do código.

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 solicite a Duet AI.

Redefinir histórico de chat

A Duet AI usa o histórico de chat para oferecer mais contexto ao responder aos seus comandos.

Se o histórico de chat não for mais relevante para o que você está tentando fazer, redefina-o: no painel da Duet AI, clique em excluir Redefinir chat.

Gerar código com comandos

As seções a seguir mostram como usar a Duet AI para gerar código com o prompt de exemplo # Function to create a Cloud Storage bucket dentro de um arquivo Python. Também é possível selecionar uma parte do código e, em seguida, solicitar ajuda à Duet AI pelo recurso de chat, além de receber e aceitar ou rejeitar sugestões de código durante a programação.

Comando da Duet AI em um arquivo de código

Crie um arquivo de código novo ou use um já existente. Se você estiver usando o exemplo Python (Flask), faça isso no arquivo front.py: navegue até Explorer > src > frontend e abra o arquivo front.py.
No arquivo de código, em uma nova linha, digite # Function to create a Cloud Storage bucket e 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, a Duet AI gera o código na forma de texto fantasma.
Opcional: para aceitar o código gerado, pressione Tab.

Enviar a Duet AI com o código selecionado usando o chat

A Duet AI pode executar tarefas ou responder a perguntas com base no código selecionado. Para receber o código gerado baseado em uma solicitação com código selecionado, siga estas etapas:

No ambiente de desenvolvimento integrado, abra um arquivo no projeto que contenha o código ou use o mesmo arquivo de código usado nas etapas anteriores.
Na barra de atividades, clique em chat_spark Duet AI para abrir o painel da Duet AI.
No arquivo de código, selecione um bloco.
No campo de texto do painel Duet AI, insira 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:

A Duet AI usa o código selecionado como referência e responde ao comando.

Receber sugestões inline enquanto você programa

Enquanto você escreve o código, a Duet AI faz sugestões de código inline que podem ser aceitas ou ignoradas. Para testar esse recurso, siga estas etapas:

Crie um arquivo de código novo ou use um já existente. Se você estiver usando o exemplo Python (Flask), faça isso no arquivo front.py: navegue até Explorer > src > frontend e abra o arquivo front.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.

A Duet AI sugere código na forma de texto fantasma.
Para aceitar a sugestão de código da Duet AI, 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 na Duet AI, siga estas etapas:

No seu ambiente de desenvolvimento integrado, selecione Code (para MacOS) ou File (para Windows e Linux) e navegue até Configurações > Configurações.
Na guia Usuário da caixa de diálogo Configurações, navegue até Extensões > Cloud Code.
Role até encontrar a lista Cloudcode: Duet AI: Inline Suggestions: Enable Auto e selecione Off.

Isso vai desativar 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.

Usar ações inteligentes

Para aumentar sua produtividade e minimizar a troca de contexto, a Duet AI oferece ações inteligentes com tecnologia de IA diretamente no editor de código. Ao selecionar o código no editor, é possível conferir e selecionar uma ação 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 Mais ações.
Selecione uma ação, como Generate unit testes.

A Duet AI gera uma resposta baseada na ação selecionada.

Testar outros exemplos de comandos

Depois de ler a seção Gerar código com comandos deste documento, tente algumas das instruções 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 Duet AI, insira o comando Explain this code to me.

A Duet AI 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 a que você quer adicionar testes de unidade.
No painel Duet AI, insira 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 Duet AI, insira 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 Duet AI, insira 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 exibir o Duet AI.

Problemas conhecidos

As seções a seguir descrevem os problemas conhecidos da Duet AI no Cloud Code.

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 do 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 sugestões de código.

Para contornar esse problema, pressione i para entrar no modo de inserção e 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 da Duet AI são dispensadas. Esse comportamento é diferente do não Vim, em que pressionar Esc aciona novamente o Duet AI.

Os avisos de recitação de licença não são mantidos entre as sessões

Se esses avisos não persistirem entre as sessões, consulte os registros persistentes:

Clique em Visualizar > Saída.
Selecione Duet AI - Citações.

Problemas de conectividade na janela de saída da Duet AI

Se você vir um erro de conexão ou outros problemas de conectividade na janela de saída da Duet AI, tente o seguinte:

Configure o 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 é usado pelo gRPC.

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 deixar feedback sobre sua experiência, siga estas etapas:

Na barra de status, clique em Duet AI e, no menu Seleção rápida, selecione Enviar feedback.
No formulário, preencha os campos Título e Comentários.
Se quiser compartilhar seus 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.