Escrever código em um notebook do Colab Enterprise com a ajuda do Gemini
Este documento descreve como usar o Gemini no Colab Enterprise, que é um produto no portfólio Gemini para Google Cloud, para ajudar você a escrever código em um notebook do Colab Enterprise.
Saiba como e quando o Gemini para Google Cloud usa seus dados.
Este documento é destinado a analistas, cientistas e desenvolvedores de dados que trabalham com o Colab Enterprise. Ele pressupõe que você saiba como escrever código em um ambiente de notebook.
Antes de começar
- Verifique se o Gemini no Colab Enterprise está configurado para sua conta de usuário e projeto Google Cloud .
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.
-
Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.
Funções exigidas
Para receber as permissões necessárias para escrever código com a assistência do Gemini em um bloco do Colab Enterprise, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Usuário do Colab Enterprise (
roles/aiplatform.colabEnterpriseUser) -
Usuário da API Gemini para o Google Cloud (
roles/cloudaicompanion.user)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Configurar o Gemini no Colab Enterprise
Para usar os recursos do Gemini:
-
No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.
-
Na barra de ferramentas, clique no botão pen_spark Quero ajuda para programar e selecione os recursos que você quer usar.
- O preenchimento de código sugere código enquanto você digita.
- A geração de código gera código com base em uma descrição do que você quer e sugere correções para erros no código.
Se o botão pen_spark Help me code não estiver ativo ou se você não encontrar uma lista de recursos ao clicar nele, consulte Configurar o Gemini no Colab Enterprise para um projeto.
Usar o preenchimento automático de código
Para usar a conclusão de código em um notebook do Colab Enterprise, faça o seguinte:
-
No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.
-
No menu Região, selecione a região que contém o notebook.
-
Clique no notebook que você quer abrir.
- Na barra de ferramentas, clique no botão pen_spark Help me code e selecione Código conclusão, caso ainda não esteja selecionado.
-
Em uma célula de código do seu notebook, comece a digitar o código. O Colab Enterprise sugere uma possível maneira de concluir seu código em texto itálico cinza.
Por exemplo, se você digitar
import p, o Colab Enterprise poderá sugerir uma conclusão de código que importepandas as pdseguida por uma linha que leia um arquivo CSV e armazene o conteúdo em um DataFrame do Pandas.
-
Para aceitar a sugestão de preenchimento de código, pressione Tab.
Usar a geração de código
Para gerar código usando o Gemini para Google Cloud:
-
No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.
-
No menu Região, selecione a região que contém o notebook.
-
Clique no notebook que você quer abrir.
-
Na barra de ferramentas, clique no botão pen_spark Quero ajuda para codificar e selecione Gerar código, caso ainda não esteja selecionado.
-
Em uma célula de código em branco do seu notebook, clique em generate.
-
No campo pen_spark Generate, digite uma descrição do código que você quer gerar e pressione Enter.
-
Para fechar o painel Generate, clique em Close.
Corrigir erros
Para usar o Gemini para Google Cloud ajudar a corrigir erros no código:
-
No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.
-
No menu Região, selecione a região que contém o notebook.
-
Clique no notebook que você quer abrir.
-
Na barra de ferramentas, clique no botão pen_spark Quero ajuda para codificar e selecione Gerar código, caso ainda não esteja selecionado.
-
Em uma célula de código do seu notebook, insira um código que contém um erro e execute a célula. Por exemplo, você pode digitar
print(1, que não tem um parêntese de fechamento.Depois que a célula de código é executada, o Colab Enterprise mostra uma mensagem de erro abaixo dela. Se o Gemini no Colab Enterprise tiver uma sugestão que possa corrigir seu código, um botão Corrigir erro vai aparecer.
-
Clique no botão Corrigir erro.
O Colab Enterprise mostra uma correção sugerida para o código.
-
Avalie a sugestão e siga um destes procedimentos:
- Para aceitar a sugestão, clique em Aceitar sugestão.
- Para recusar a sugestão, clique em Recusar sugestão.
Desativar os recursos do Gemini
Para desativar os recursos do Gemini no Colab Enterprise, faça o seguinte:
Na barra de ferramentas do Colab Enterprise, clique no botão pen_spark Help me code.
Desmarque os recursos do Gemini que você quer desativar.
Resolver problemas
Nesta seção, mostramos como resolver problemas com o uso do Gemini no Colab Enterprise.
Os recursos do Gemini não estão funcionando
Quando você digita em um bloco do Colab Enterprise, as sugestões de preenchimento do código não aparecem. Ou o botão pen_spark Help me code não aparece acima de uma célula de código.
Nas configurações do Colab Enterprise, talvez você tenha desativado a configuração Mostrar sugestões de preenchimento de código com base no contexto.
Para resolver esse problema, faça o seguinte:
- Clique em Alternar visibilidade do cabeçalho.
- No menu Ferramentas, clique em Configurações.
- Clique em Editor.
- Selecione Mostrar sugestões de preenchimento de código com base no contexto.
- Clique em Salvar.