Explicar e corrigir erros com a ajuda do Gemini

Este documento descreve como usar o Gemini no Colab Enterprise, um produto do portfólio Gemini para Google Cloud, para explicar e corrigir erros 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.

Visão geral

Quando você executa um código que gera um erro, o Gemini no Colab Enterprise pode sugerir uma correção ou explicar o erro para ajudar você a resolver o problema.

Para erros de sintaxe, um botão Corrigir erro aparece. Clique neste botão para conferir uma correção sugerida para seu código. Para mais detalhes, consulte Corrigir erros.

Para outros tipos de erros, um botão Explicar erro aparece. Clique nesse botão para ver uma explicação do erro e possíveis maneiras de resolvê-lo. Para mais detalhes, consulte Usar explicações de erro.

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.

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

    Enable the APIs

    5.

Funções exigidas

Para receber as permissões necessárias a fim de usar o Gemini no Colab Enterprise, peça que o administrador conceda a você os seguintes papéis do IAM no projeto:

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.

Usar explicações de erro

Para usar o Gemini para Google Cloud explicar erros no código:

  1. No Google Cloud console, 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. Em uma célula de código do seu notebook, insira um código que contenha um erro e execute a célula. Por exemplo, você pode inserir print(a + random()) sem definir a.

    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 explicação para esse erro, o botão Explain error vai aparecer.

  5. Clique no botão Explicar erro.

    O Colab Enterprise abre uma caixa de diálogo de chat que contém uma explicação do erro. A caixa de diálogo também pode incluir recomendações e mudanças sugeridas para resolver o problema.

  6. Depois de avaliar o conteúdo, você pode fazer o seguinte:

    • Para copiar uma mudança sugerida, clique no botão  Copiar. Em seguida, cole o código em uma célula de código no seu notebook.
    • Para adicionar uma célula de código ao notebook com a mudança sugerida, clique no botão  Adicionar célula de código. Adicionar a célula de código não remove a célula de código original com o erro.
    • Use a caixa de diálogo de chat para discutir o erro com o Gemini.

  7. Para fechar a caixa de diálogo do chat, clique em  Fechar.

Corrigir erros

Para usar o Gemini no Google Cloud e corrigir erros de sintaxe no código:

  1. No Google Cloud console, 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. Em uma célula de código do seu notebook, insira um código que contenha 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.

  5. Clique no botão Corrigir erro.

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

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

Desative o Gemini no Colab Enterprise

Para desativar o Gemini no Colab Enterprise em um projeto Google Cloud , um administrador precisa desativar a API Gemini para o Google Cloud. Consulte Como desativar serviços.

Para desativar o Gemini no Colab Enterprise para um usuário específico, um administrador precisa revogar o papel Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user) para esse usuário. Consulte Revogar um único papel do IAM.

A seguir