Explicar e corrigir erros com a ajuda do Gemini

Este documento descreve como usar o Gemini no Colab Enterprise, um produto do portfólio do Gemini para Google Cloud, para ajudar você a 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. É necessário saber 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 ver 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 erros.

Antes de começar

  1. Verifique se o Gemini no Colab Enterprise está configurado para sua conta de usuário e projeto do 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 para usar o Gemini no Colab Enterprise, peça ao administrador para conceder 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 erros

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

    1. No console 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. Em uma célula de código do 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 imprime uma mensagem de erro abaixo dela. Se o Gemini no Colab Enterprise tiver uma explicação para esse erro, um botão Explicar erro vai aparecer.

    5. Clique no botão Explicar erro.

      O Colab Enterprise abre uma caixa de diálogo de chat com 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 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 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 para Google Cloud e corrigir erros de sintaxe no código:

    1. No console 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. Em uma célula de código do 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 imprime 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 rejeitar a sugestão, clique em  Rejeitar sugestão.

    Desativar o Gemini no Colab Enterprise

    Para desativar o Gemini no Colab Enterprise em um Google Cloud projeto, um administrador precisa desativar a API Gemini para 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 de Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user) desse usuário. Consulte Revogar um único papel do IAM.

    A seguir