Explique e corrija erros com a assistência do Gemini

Este documento descreve como pode usar o Gemini no Colab Enterprise, que é um produto no portefólio do Gemini para Google Cloud, para ajudar a explicar e corrigir erros num bloco de notas do Colab Enterprise.

Saiba como e quando o Gemini para Google Cloud usa os seus dados.

Este documento destina-se a analistas, cientistas e programadores de dados que trabalham com o Colab Enterprise. Parte do princípio de que tem conhecimentos sobre como escrever código num ambiente de bloco de notas.

Vista geral

Quando executa 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. Certifique-se de que o Gemini no Colab Enterprise está configurado para a sua Google Cloud conta de utilizador e projeto.
  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, 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

  5. Funções necessárias

    Para receber as autorizações de que precisa para usar o Gemini no Colab Enterprise, peça ao seu administrador que lhe conceda as seguintes funções de IAM no projeto:

    Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

    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. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

      Aceda a Os meus notebooks

    2. No menu Região, selecione a região que contém o seu bloco de notas.

    3. Clique no bloco de notas que quer abrir.

    4. Numa célula de código do seu bloco de notas, introduza código que contenha um erro e, em seguida, execute a célula. Por exemplo, pode introduzir print(a + random()) sem definir a.

      Depois de executar a célula de código, o Colab Enterprise imprime uma mensagem de erro abaixo da célula de código. Se o Gemini no Colab Enterprise tiver uma explicação para este erro, é apresentado um botão Explicar erro.

    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 alterações sugeridas sobre como resolver o problema.

    6. Depois de avaliar o conteúdo, pode fazer qualquer uma das seguintes ações:

      • Se o Gemini fornecer uma edição de código sugerida na respetiva resposta, pode clicar em:
        • Aceite para atualizar o código no bloco de notas.
        • Aceitar e executar para atualizar e executar o código.
        • Cancelar para rejeitar a edição.
      • Use a caixa de diálogo do chat para discutir o erro com o Gemini.
    7. Para fechar a caixa de diálogo do chat, clique em  Fechar.

    Desative o Gemini no Colab Enterprise

    Para desativar o Gemini no Colab Enterprise para um Google Cloud projeto, um administrador tem de desativar a API Gemini para o Google Cloud. Consulte a secção Desativar serviços.

    Para desativar o Gemini no Colab Enterprise para um utilizador específico, um administrador tem de revogar a função Utilizador do Gemini para o Google Cloud (roles/cloudaicompanion.user) desse utilizador. Consulte o artigo Revogue uma única função do IAM.

    O que se segue?