Use a conclusão e a geração de código

Use a conclusão e a geração de código

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 escrever e gerar 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.

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, 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

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

Ative a conclusão e a geração de código

Para ativar a conclusão e a geração de 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. Na barra de ferramentas, clique no botão  Ajuda-me a programar e selecione as funcionalidades que quer usar.

   
   • O preenchimento de código sugere código enquanto escreve.
   • A geração de código gera código a partir de uma descrição do que pretende.

   Se o botão  Ajuda-me a programar não estiver ativo ou não vir uma lista de funcionalidades quando clicar no botão, consulte o artigo Configure o Gemini no Colab Enterprise para um projeto.

Use a conclusão de código

Para usar a conclusão de código num bloco de notas do Colab Enterprise, 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. Na barra de ferramentas, clique no botão pen_spark Ajuda-me a programar e selecione Conclusão de código se esta opção ainda não estiver selecionada.

5. Numa célula de código do seu bloco de notas, comece a introduzir código. O Colab Enterprise sugere uma forma potencial de concluir o seu código em texto cinzento em itálico.

   Por exemplo, se introduzir import p, o Colab Enterprise pode sugerir uma conclusão de código que importe pandas as pd, seguido de uma linha que lê um ficheiro CSV e armazena o conteúdo num dataframe pandas.
   

6. Para aceitar a conclusão de código sugerida, prima Tab.

Use a geração de código

Para gerar código com o Gemini para Google Cloud:

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. Na barra de ferramentas, clique no botão  Ajuda-me a criar código e selecione Geração de código se esta opção ainda não estiver selecionada.

5. No bloco de notas, adicione uma célula de código em branco ou clique numa célula de código que não tenha código.

6. Clique em  Funcionalidades de IA disponíveis e, de seguida, em Gerar código.

7. No campo  Gerar, introduza uma descrição do código que quer gerar e, de seguida, prima Enter.

8. Para fechar o painel Gerar, clique em Fechar.

Desative a conclusão e a geração de código

Para desativar a conclusão e a geração de código, faça o seguinte:

1. Na barra de ferramentas do Colab Enterprise, clique no botão  Ajuda-me a programar.

2. Desmarque as funcionalidades que quer desativar.

Resolver problemas

Esta secção mostra como resolver problemas com a utilização do Gemini no Colab Enterprise.

As funcionalidades do Gemini não estão a funcionar

Quando escreve num bloco de notas do Colab Enterprise, as sugestões de conclusão de código não são apresentadas. Em alternativa, o botão pen_spark Ajudar a programar não aparece acima de uma célula de código.

Nas definições do Colab Enterprise, pode ter desativado a definição Mostrar conclusões de código baseadas no contexto.

Para resolver este problema, faça o seguinte:

1. Clique em  Ativar/desativar visibilidade de cabeçalho.
2. No menu Ferramentas, clique em Definições.
3. Clique em Editor.
4. Selecione Mostrar conclusões de código baseadas no contexto.
5. Clique em Guardar.

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
  • Explicar células de código
  • Explicar e corrigir erros
  • Use o Data Science Agent

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