Escrever código em um notebook do Colab Enterprise com a ajuda do Gemini

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

1. Verifique se o Gemini no Colab Enterprise está configurado para sua conta de usuário e projeto Google Cloud .
2. 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.

3. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

4. Enable the Vertex AI, Cloud AI Companion, Dataform, and Compute Engine APIs.

   Enable the APIs

Funções exigidas

Para garantir que sua conta de usuário tenha 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 à sua conta de usuário os seguintes papéis do IAM no projeto:

• Usuário do Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Usuário da 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.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas ou outros papéis predefinidos.

Um ou mais dos papéis necessários incluem a permissão dataform.repositories.list. Os usuários que recebem a permissão dataform.repositories.list ou o papel de criador de código (roles/dataform.codeCreator) em um projeto podem listar os nomes dos recursos de código nesse projeto usando a API Dataform ou a interface de linha de comando (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver os recursos de código que criaram ou que foram compartilhados com eles.

Configurar o Gemini no Colab Enterprise

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

Para usar os recursos do Gemini:

1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

   Acessar "Meus cadernos"

2. 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:

1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

   Acessar "Meus notebooks"

2. No menu Região, selecione a região que contém o notebook.

3. Clique no notebook que você quer abrir.

4. 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.

5. 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 importe pandas as pd seguida por uma linha que leia um arquivo CSV e armazene o conteúdo em um DataFrame do Pandas.
   

6. 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:

1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

   Acessar "Meus cadernos"

2. No menu Região, selecione a região que contém o notebook.

3. Clique no notebook que você quer abrir.

4. 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.

5. Em uma célula de código em branco do seu notebook, clique em generate.

6. No campo pen_spark Generate, digite uma descrição do código que você quer gerar e pressione Enter.

7. Para fechar o painel Generate, clique em Close.

Corrigir erros

Preview — Error fixing

This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Para usar o Gemini para Google Cloud ajudar a corrigir erros no código:

1. No console do Google Cloud, acesse a página Meus notebooks do Colab Enterprise.

   Acessar "Meus cadernos"

2. No menu Região, selecione a região que contém o notebook.

3. Clique no notebook que você quer abrir.

4. 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.

5. 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.

6. Clique no botão Corrigir erro.

   O Colab Enterprise mostra uma correção sugerida para o código.

7. 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:

1. Na barra de ferramentas do Colab Enterprise, clique no botão pen_spark Help me code.

2. 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 funcionam

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:

1. Clique em  Alternar visibilidade do cabeçalho.
2. No menu Ferramentas, clique em Configurações.
3. Clique em Editor.
4. Selecione Mostrar sugestões de preenchimento de código com base no contexto.
5. Clique em Salvar.

A seguir

• Leia a visão geral do Gemini para Google Cloud.

• Saiba como o Gemini para Google Cloud usa seus dados.