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 explicar e corrigir erros em um bloco 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 a resolver o problema.

Antes de começar

  1. Verifique se o Gemini no Colab Enterprise está configurado para sua Google Cloud conta de usuário e projeto.
  2. Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.
  3. Enable the Vertex AI, Gemini for Google Cloud, Dataform, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

  4. Enable the Vertex AI, Gemini for Google Cloud, Dataform, and Compute Engine APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

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

Explicar e corrigir um erro

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

  1. No Google Cloud console do, 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 for executada, o Colab Enterprise vai imprimir 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.

    Se você ainda não tiver autorizado o Agente de Ciência de Dados, uma breve caixa de diálogo vai aparecer enquanto o Colab Enterprise autentica sua Conta do Google no Agente de Ciência de Dados.

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

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

    • Se o Gemini fornecer uma edição de código sugerida na resposta, clique em:
      • Aceitar para atualizar o código no notebook.
      • 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 de 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 Usuário do Gemini para Google Cloud (roles/cloudaicompanion.user) desse usuário. Consulte Revogar apenas um papel do IAM.

A seguir