Escribe código en un notebook de Colab Enterprise con la asistencia de Gemini

Escribe código en un notebook de Colab Enterprise con la asistencia de Gemini

En este documento, se describe cómo puedes usar Gemini en Colab Enterprise, que es un producto de la cartera de Gemini para Google Cloud, para ayudarte a escribir código en un notebook de Colab Enterprise.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Este documento está dirigido a analistas de datos, científicos de datos y desarrolladores de datos que trabajan con Colab Enterprise. Se da por sentado que tienes conocimiento sobre cómo escribir código en un entorno de notebook.

Antes de comenzar

1. Asegúrate de que Gemini en Colab Enterprise esté configurado para tu cuenta de usuario y proyecto de 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

Roles obligatorios

Para garantizar que tu cuenta de usuario tenga los permisos necesarios para escribir código con la asistencia de Gemini en un notebook de Colab Enterprise, pídele a tu administrador que le otorgue a tu cuenta de usuario los siguientes roles de IAM en el proyecto:

• Usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser)
• Usuario de Gemini para Google Cloud (roles/cloudaicompanion.user)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

Configurar Gemini en Colab Enterprise

Como tecnología en etapa inicial, los productos de Gemini para Google Cloudpueden generar resultados que parecen posibles, pero que no son correctos. Te recomendamos validar todos los resultados de Gemini para los productos de Google Cloud antes de usarlos. Para obtener más información, consulta Gemini para Google Cloud y la IA responsable.

Para usar las funciones de Gemini, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En la pestaña Mis notebooks, haz clic en el notebook que deseas abrir. Si aún no creaste un notebook, crea uno.

3. En la barra de herramientas, haz clic en el botón pen_spark Help me code y selecciona las funciones que deseas usar.

   
   • La finalización de código sugiere código mientras escribes.
   • La generación de código genera código a partir de una descripción de lo que deseas y sugiere correcciones para los errores en tu código.

   Si el botón pen_spark Help me code no está activo o no ves una lista de funciones cuando haces clic en el botón, consulta Cómo configurar Gemini en Colab Enterprise para un proyecto.

Usa la finalización de código

Para usar la finalización de código en un notebook de Colab Enterprise, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas abrir.

4. En la barra de herramientas, haz clic en el botón pen_spark Help me code y selecciona Code completion si aún no está seleccionada.

5. En una celda de código de tu notebook, comienza a ingresar código. Colab Enterprise sugiere una posible forma de completar tu código en texto en itálicas gris.

   Por ejemplo, si ingresas import p, Colab Enterprise podría sugerir una finalización de código que importe pandas as pd seguida de una línea que lea un archivo CSV y almacene el contenido en un dataframe de pandas.
   

6. Para aceptar la finalización de código sugerida, presiona Tab.

Usa la generación de código

Para generar código con Gemini para Google Cloud, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas abrir.

4. En la barra de herramientas, haz clic en el botón pen_spark Help me code y selecciona Code generation si aún no está seleccionada.

5. En una celda de código en blanco de tu notebook, haz clic en generar.

6. En el campo pen_spark Generate, escribe una descripción del código que deseas generar y, luego, presiona Intro.

7. Para cerrar el panel Generate, haz clic en Close.

Corrige los errores

Vista previa — Error fixing

Esta función está sujeta a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Para usar Gemini para Google Cloud corregir errores en tu código, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. En la pestaña Mis notebooks, haz clic en el notebook que deseas abrir.

4. En la barra de herramientas, haz clic en el botón pen_spark Help me code y selecciona Code generation si aún no está seleccionada.

5. En una celda de código de tu notebook, ingresa código que contenga un error y, luego, ejecútalo. Por ejemplo, puedes ingresar print(1, al que le falta un paréntesis de cierre.

   Después de que se ejecuta la celda de código, Colab Enterprise imprime un mensaje de error debajo de ella. Si Gemini en Colab Enterprise tiene una sugerencia que podría corregir tu código, aparecerá el botón Corregir error.

6. Haz clic en el botón Corregir error.

   Colab Enterprise te muestra una corrección sugerida para el código.

7. Evalúa la sugerencia y, luego, realiza una de las siguientes acciones:

   • Para aceptar la sugerencia, haz clic en  Aceptar sugerencia.
   • Para rechazar la sugerencia, haz clic en  Rechazar sugerencia.

Cómo desactivar las funciones de Gemini

Para desactivar las funciones de Gemini en Colab Enterprise, haz lo siguiente:

1. En la barra de herramientas de Colab Enterprise, haz clic en el botón pen_spark Help me code.

2. Borra las funciones de Gemini que deseas desactivar.

Solucionar problemas

En esta sección, se muestra cómo resolver problemas relacionados con el uso de Gemini en Colab Enterprise.

Las funciones de Gemini no funcionan

Cuando escribes en un notebook de Colab Enterprise, no aparecen las sugerencias para completar código. O bien, el botón pen_spark Help me code no aparece sobre una celda de código.

Es posible que hayas desactivado la opción Automatically trigger code completions en la configuración de Colab Enterprise.

Para solucionar este problema, haz lo siguiente:

1. Haz clic en  Activar o desactivar la visibilidad del encabezado.
2. En el menú Herramientas, haz clic en Configuración.
3. Haga clic en Editor.
4. Selecciona Activar automáticamente la función de autocompletar códigos.
5. Haz clic en Guardar.

¿Qué sigue?

• Lee la descripción general de Gemini para Google Cloud.

• Descubre cómo Gemini para Google Cloud usa tus datos.