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.

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. 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 usando papéis personalizados ou outros papéis predefinidos.

Explicar e corrigir um erro

Para usar o Gemini para Google Cloud explicar e corrigir um erro no seu código, faça o seguinte:

  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:

    • Se o Gemini sugerir uma edição de código na resposta, clique em:
      • Clique em Aceitar para atualizar o código no notebook.
      • Clique em Aceitar e executar para atualizar e executar o código.
      • Cancelar para rejeitar a edição.
    • 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.

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