Explicar células de código com a ajuda do Gemini

Explicar células de código com a ajuda do Gemini

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

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 células de código 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

O Gemini no Colab Enterprise pode ajudar a explicar células de código num bloco de notas do Colab Enterprise. Pode querer fazê-lo quando estiver a trabalhar com o bloco de notas de outra pessoa e quiser compreender rapidamente o que o código faz. Em alternativa, pode ter de relembrar-se de como funcionam as partes do seu bloco de notas após um longo período sem trabalhar nele.

Depois de receber uma explicação de uma célula de código, pode procurar quaisquer fragmentos de código incluídos e rever as fontes. Também pode usar a caixa de diálogo de chat Explicar código para debater o código e fazer perguntas de seguimento. Para mais detalhes, consulte o artigo Explique uma célula de código.

Antes de começar

Como tecnologia em fase inicial, o Gemini para produtos Google Cloud pode gerar resultados que parecem plausíveis, mas que estão factualmente incorretos. Recomendamos que valide todas as saídas do Gemini para Google Cloud produtos antes de as usar. Para mais informações, consulte o artigo Gemini para Google Cloud e IA responsável.

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

Enable the Vertex AI, Cloud AI Companion, 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

Enable the Vertex AI, Cloud AI Companion, 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 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:

• Utilizador do Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Utilizador do Gemini para o Google Cloud (roles/cloudaicompanion.user)

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.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Explicar uma célula de código

Para explicar uma célula de código com o Gemini para Google Cloud, 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. No bloco de notas, clique numa célula de código que contenha código.

5. Clique em  Funcionalidades de IA disponíveis e, de seguida, em Explicar código.

   É apresentado um diálogo de chat Explicar código que inclui uma explicação do seu código.

6. Leia a explicação, navegue pelos exemplos de fragmentos do código e reveja as fontes. Use esta caixa de diálogo de chat para discutir o código e fazer perguntas de seguimento.

7. Para fechar a caixa de diálogo Explicar código, 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?

• Leia a vista geral do Gemini para Google Cloud o Workspace.

• Para saber mais formas de escrever e editar código com a assistência do Gemini, consulte o seguinte:

  • Converse sobre o seu bloco de notas com o Gemini
  • Use a conclusão de código e a geração de código
  • Explicar e corrigir erros
  • Use o Data Science Agent

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