Crea código con Gemini Code Assist

En este documento, se describe cómo puedes usar Gemini Code Assist, un colaborador potenciado por IA en Google Cloud, para hacer lo siguiente en Cloud Shell:

  • Proporciona orientación para ayudarte a resolver problemas con tu código.

  • Genera un código para tu proyecto.

  • Recibe sugerencias intercaladas mientras codificas.

Gemini no usa tus instrucciones ni sus respuestas como datos para entrenar sus modelos. Para obtener más información, consulta Cómo Gemini para Google Cloud usa tus datos.

Para ayudarte a cumplir con los requisitos de licencia de tu código, Gemini Code Assist proporciona citas de fuente cuando sus sugerencias citas directamente de una fuente específica. Para obtener más información sobre cómo y cuándo Gemini cita fuentes, consulta Cómo te ayuda Gemini a generar código y citas de fuentes.

Este documento está dirigido a desarrolladores de todos los niveles de habilidades. Se supone que tienes conocimientos prácticos del editor de Cloud Shell y que estás familiarizado con Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en Cloud Workstations, Cloud Code para IntelliJ y Cloud Code para VS Code.

Conéctate a Google Cloud y selecciona un proyecto

En esta sección, te conectarás a Google Cloud y seleccionarás un proyecto de la plataforma con la API de Cloud AI Companion habilitada en el editor de Cloud Shell.

Si seleccionas un proyecto de Google Cloud sin la API de Cloud AI Companion habilitada, recibirás una notificación de error y se te indicará que te comuniques con tu administrador. Para obtener más información, consulta Cómo configurar Gemini Code Assist para un proyecto.

Para conectarte a Google Cloud en el Editor de Cloud Shell, sigue estos pasos:

  1. Inicia el editor de Cloud Shell.

  2. Si usas el editor heredado, haz clic en Probar el editor nuevo.

  3. En la barra de estado, haz clic en Cloud Code - Acceder.

    Botón de acceso de Cloud Code en la barra de estado.

  4. Si se te solicita que autorices al editor de Cloud Shell a realizar llamadas a la API de Google Cloud, haz clic en Autorizar.

  5. Sigue las indicaciones para acceder a tu Cuenta de Google.

    Ahora estás conectado a Google Cloud.

Luego, para seleccionar un proyecto de Google Cloud que tenga habilitada la API de Cloud AI Companion, sigue estos pasos:

  1. En la barra de estado de Gemini Code Assist, haz clic en Gemini Code Assist.

    La barra de estado de Gemini está disponible.

  2. En el menú Gemini Code Assist, selecciona Select Gemini Code Assist project.

  3. Selecciona un proyecto de Google Cloud que tenga habilitada la API de Cloud AI Companion.

    Gemini está listo para usarse.

    El ícono de Gemini en la barra de estado se estableció en normal.

Para probar las funciones de Gemini Code Assist, abre una aplicación o crea una de ejemplo en la siguiente sección.

Opcional: Crea una aplicación de muestra

Si prefieres usar una aplicación existente para probar las funciones de Gemini Code Assist, puedes omitir esta sección. De lo contrario, para crear una aplicación de muestra, sigue estos pasos:

  1. En el editor de Cloud Shell, abre la paleta de comandos: presiona Control + Mayúsculas + P (en Windows y Linux) o Comando + Mayúsculas + P (para macOS) y, luego, ejecuta Cloud Code: Nueva aplicación.

  2. Selecciona Kubernetes application.

  3. Selecciona la plantilla de aplicación Python (Flask): Guestbook.

  4. Guarda la aplicación nueva en tu ubicación preferida.

    Una notificación confirma que se creó tu aplicación y se abre una ventana nueva con la aplicación cargada.

Chatea con Gemini Code Assist

En esta sección, aprenderás a abrir el panel Gemini Code Assist y chatear con Gemini Code Assist para obtener una explicación de tu código existente.

Para comenzar a chatear con Gemini, sigue estos pasos:

  1. Crea un archivo de código nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes realizar esta tarea en tu archivo front.py: navega a Explorador > src > frontend y abre el archivo front.py.

  2. En la barra de actividades del Editor de Cloud Shell, haz clic en chat_spark Gemini Code Assist.

  3. En el panel Gemini Code Assist, ingresa el mensaje Explain this code to me y haz clic en Enviar Enviar.

    Gemini usa el código de tu archivo de código como referencia a tu mensaje y responde con una explicación del código.

    Para hacer referencia a un bloque de código específico en lugar de todo el código del archivo, puedes seleccionar el bloque en tu archivo de código y, luego, solicitar Gemini.

Restablecer historial de chat

Gemini Code Assist usa el historial de chat para brindar contexto adicional cuando responde tus mensajes.

Si tu historial de chat ya no es relevante para lo que intentas lograr, puedes restablecerlo. Para ello, en el panel Gemini Code Assist, haz clic en borrar Restablecer chat.

Genera código con instrucciones

En las siguientes secciones, se muestra cómo usar Gemini Code Assist para generar código con el mensaje de ejemplo # Function to create a Cloud Storage bucket dentro de un archivo de Python. También puedes seleccionar una parte de tu código y, luego, solicitar ayuda a Gemini Code Assist a través de la función de chat y recibir y aceptar o rechazar sugerencias de código mientras escribes código.

Solicita a Gemini Code Assist en un archivo de código

  1. Crea un archivo de código nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes hacerlo en tu archivo front.py: navega a Explorer > src > frontend y abre el archivo front.py.

  2. En una línea nueva de tu archivo de código, ingresa # Function to create a Cloud Storage bucket y, luego, presiona Intro (en Windows y Linux) o Return (en macOS).

  3. Para generar código, presiona Control + Intro (en Windows y Linux) o Control + Intro (en macOS).

    Junto al texto de la instrucción en el archivo de Python, Gemini Code Assist genera el código en forma de texto fantasma.

  4. Opcional: Para aceptar el código generado, presiona Tab.

Opcional: Cambia la combinación de teclas para generar código

Si la combinación de teclas predeterminada para generar código no funciona como se describe en la sección anterior, puedes cambiarla siguiendo estos pasos:

  1. En el editor de Cloud Shell, haz clic en Menú Menú y, luego, navega a Archivo > Preferencias > Combinaciones de teclas.

  2. En la lista de combinaciones de teclas, busca Cloud Code: Generate Code.

  3. Haz clic en Cloud Code: Generate Code y, luego, en edit Change Keybinding.

  4. En el cuadro de diálogo que aparece, ingresa tu propia combinación de teclas.

  5. Presiona Intro (en Windows y Linux) o Return (en macOS).

    Ahora puedes usar la combinación de teclas que acabas de asignar para generar código con Gemini.

Enviar solicitud a Gemini Code Assist con el código seleccionado a través del chat

Gemini Code Assist puede realizar tareas o responder tus preguntas según el código que selecciones. Para obtener un código generado basado en un mensaje con el código seleccionado, sigue estos pasos:

  1. En el editor de Cloud Shell, abre un archivo en tu proyecto que contenga código o usa el mismo archivo de código que usaste en los pasos anteriores.

  2. En la barra de actividades, haz clic en chat_spark Gemini Code Assist para abrir el panel Gemini Code Assist.

  3. En el archivo de código, selecciona un bloque de código.

  4. En el campo de texto del panel Gemini Code Assist, ingresa un mensaje para el código seleccionado.

    Por ejemplo, selecciona una función en tu código y, luego, ingresa el mensaje Write a unit test for this function:

    Gemini escribe una prueba de unidades para una función seleccionada.

    Gemini usa el código que seleccionaste como referencia y responde a tu instrucción.

Obtén sugerencias intercaladas mientras escribes código

Mientras escribes código, Gemini Code Assist hace sugerencias de código intercalado que puedes aceptar o ignorar. Para probar esta función, sigue estos pasos:

  1. Crea un archivo de código nuevo o usa uno existente. Si usas la muestra de Python (Flask), puedes hacerlo en tu archivo front.py: navega a Explorer > src > frontend y abre el archivo front.py.

  2. En el archivo de código, en una línea nueva, comienza a escribir una función. Por ejemplo, si estás en un archivo de Python, escribe def.

    Gemini sugiere código en forma de texto fantasma.

  3. Para aceptar la sugerencia de código de Gemini Code Assist, presiona Tab. De lo contrario, para ignorar la sugerencia, presiona Esc o continúa escribiendo el código.

Opcional: Inhabilita las sugerencias intercaladas

Si prefieres inhabilitar las sugerencias intercaladas en Gemini Code Assist, sigue estos pasos:

  1. En el editor de Cloud Shell, selecciona Menú Menú y, luego, navega a Archivo > Preferencias > Configuración.

  2. En la pestaña Usuario del cuadro de diálogo Configuración, navega a Extensiones > Cloud Code.

  3. Desplázate hasta encontrar la lista Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto y, luego, selecciona Off.

    Esta acción desactiva las sugerencias intercaladas. Aún puedes presionar Control + Intro (en Windows y Linux) o Control + Retorno (para macOS) para activar de forma manual las sugerencias intercaladas.

Inhabilitar sugerencias de código que coincidan con las fuentes citadas

Gemini proporciona información de citas cuando cita directamente en detalle otra fuente, como el código abierto existente. Para obtener más información, consulta Cómo y cuándo Gemini cita fuentes.

Para evitar que se sugiera código que coincida con las fuentes citadas, puedes modificar el parámetro de configuración cloudcode.duetAI.recitation.maxCitedLength por 0 en un archivo settings.json:

"cloudcode.duetAI.recitation.maxCitedLength": 0

Cómo usar acciones inteligentes

Para ayudarte a aumentar tu productividad y, al mismo tiempo, minimizar el cambio de contexto, Gemini Code Assist proporciona acciones inteligentes con tecnología de IA directamente en tu editor de código. Cuando seleccionas el código en el editor de código, puedes ver y elegir de una lista de acciones relevantes para tu contexto.

Para usar acciones inteligentes en tu código, sigue estos pasos:

  1. En el archivo de código, selecciona un bloque de código.

  2. Junto al bloque de código seleccionado, haz clic en la bombilla Mostrar acciones de código.

    El ícono de bombilla de Acciones inteligentes aparece después de seleccionar un bloque de código en Shell y estaciones de trabajo.

  3. Selecciona una acción, como Generar pruebas de unidades.

    Gemini genera una respuesta basada en la acción que seleccionaste.

Vista previa: Usa transformaciones de código

Gemini Code Assist ofrece transformaciones de código, que te permiten seleccionar una parte de tu archivo de código y solicitar modificaciones para tu código existente mediante instrucciones en lenguaje natural mediante un cuadro de texto intercalado.

Con las transformaciones de código, puedes hacer lo siguiente:

  • Genera líneas de comentarios para documentar tu código
  • Cómo solucionar problemas de código
  • Mejora la legibilidad del código
  • Haz que el código sea más eficiente

También puedes ver las fuentes de contexto de una respuesta generada en el panel Gemini: Chat.

Solicita a Gemini Code Assist con el cuadro de texto intercalado

El cuadro de texto intercalado te permite interactuar con Gemini Code Assist directamente en el archivo de código.

Para abrir el cuadro de texto intercalado y solicitar Gemini, sigue estos pasos:

  1. En tu archivo de código, presiona Control + I (en Windows y Linux) o Comando + I (en macOS).

  2. Ingresa un mensaje, como Write a function to create a Cloud Storage bucket, y presiona Intro (en Windows y Linux) o Return (en macOS).

    Gemini Code Assist genera el código según tu instrucción.

Ver la diferencia del código refactorizado

Con la vista de diferencias integrada en el cuadro de texto intercalado, puedes ver los cambios que sugiere Gemini y tu código original. Luego, puedes aceptar o descartar los cambios sugeridos.

Para ver la diferencia del código refactorizado desde el cuadro de texto intercalado, sigue estos pasos:

  1. En el archivo de código, selecciona una función y abre el cuadro de texto intercalado. Para ello, presiona Control + I (en Windows y Linux) o Comando + I (en macOS).

  2. Ingresa un mensaje, como Add comments, y presiona Intro (en Windows y Linux) o Return (en macOS).

    Cuando Gemini genera los cambios de código en la función seleccionada, aparece la vista de diferencias.

    Fuentes de contexto enumeradas en el panel de Gemini: Chat

  3. Para aceptar o descartar los cambios, haz clic en Aceptar o Descartar.

Consulta las fuentes de contexto de una respuesta generada

La función de visualización de contexto enumera los archivos de tu proyecto (las fuentes de contexto) que se usaron como referencia para generar respuestas a tus instrucciones. Saber qué archivos se usaron como referencias te ayuda a definir mejor tus instrucciones y obtener respuestas más específicas. Las fuentes de contexto se muestran cada vez que usas el chat de Gemini.

Para ver las fuentes de contexto de la respuesta generada, en el panel Gemini: Chat, desplázate hasta que veas el fragmento de Fuentes de contexto. Expande el fragmento para ver todas las fuentes de contexto.

Fuentes de contexto enumeradas en el panel de Gemini: Chat

Usa comandos inteligentes

Los comandos inteligentes son comandos que puedes usar en el cuadro de texto intercalado para realizar acciones específicas en tu código.

Para obtener una explicación de todo el archivo de código con el comando inteligente /explain, sigue estos pasos:

  1. En tu archivo de código, presiona Control + I (en Windows y Linux) o Command + I (en macOS) para abrir el cuadro de texto intercalado.

  2. Presiona / para ver la lista de comandos inteligentes y sus descripciones.

  3. Seleccione /explain.

    Gemini genera una explicación de todo el archivo de código en el cuadro de texto intercalado.

  4. Opcional: Si deseas ver la respuesta generada en el panel Gemini: Chat, haz clic en Ver en Chat.

Ver historial de mensajes

El acceso al historial de instrucciones te ahorra tiempo cuando necesitas ingresar las mismas instrucciones en un archivo de código grande.

Para acceder al historial de instrucciones, en el archivo de código, abre el cuadro de texto intercalado mediante Control + I (en Windows y Linux) o Comando + I (en macOS) y, luego, presiona Control + flecha hacia arriba (en Windows y Linux) o Comando + flecha hacia arriba (en macOS). Esto te permite desplazarte por tus instrucciones anteriores y volver a usarlas cuando sea necesario.

Se mejoró la legibilidad del código para hablantes no nativos de inglés.

Si no eres un hablante nativo de inglés y dependes de aplicaciones de traducción, puedes usar el cuadro de texto intercalado para generar comentarios en otros idiomas.

Sigue estos pasos para convertir comentarios en inglés a otro idioma o agregar comentarios nuevos en otro idioma:

  1. En tu archivo de código, selecciona el código al que quieras agregar comentarios.

  2. Abre el cuadro de texto intercalado. Para ello, presiona Control + I (en Windows y Linux) o Comando + I (en macOS).

  3. Ingresa un mensaje, como Add spanish comments, y presiona Intro (en Windows y Linux) o Return (en macOS).

    Gemini genera comentarios en el lenguaje que especificaste en la instrucción y ve la diferencia de estas sugerencias.

  4. Para aceptar o descartar estos cambios en tu código, haz clic en Aceptar o Descartar.

Prueba otros ejemplos de instrucciones

Después de leer la sección Cómo generar código con instrucciones de este documento, prueba alguna de las siguientes indicaciones de ejemplo.

Obtén una explicación del código

  1. En tu archivo de código, selecciona una función que quieras explicar.

  2. En el panel Gemini Code Assist, ingresa el mensaje Explain this code to me.

    Gemini usa el código que seleccionaste como referencia y responde con una explicación de la función seleccionada.

Genera planes de prueba

  1. En el archivo de código, selecciona el código al que deseas agregar pruebas de unidades.
  2. En el panel Gemini Code Assist, ingresa el mensaje Write unit tests for my code.

Cómo obtener ayuda con la depuración de código

  1. En tu archivo de código, selecciona el código que deseas depurar.
  2. En el panel Gemini Code Assist, ingresa el mensaje Help me debug my code.

Haz que tu código sea más legible

  1. En tu archivo de código, selecciona el código que desees que sea más legible.

  2. En el panel Gemini Code Assist, ingresa el mensaje Make my code more readable.

    Si prefieres enfocarte en una parte específica de tu código, selecciona la que prefieras antes de enviar una solicitud a Gemini.

Problemas conocidos

En las siguientes secciones, se describen los problemas conocidos de Gemini Code Assist.

Las advertencias de recitación de licencias no persisten en todas las sesiones

Si las advertencias de recitación de licencias no persisten en todas las sesiones, consulta los registros persistentes:

  1. Haz clic en Menú Menú > Ver > Salida.

  2. Selecciona Gemini Code Assist - Citas.

Problemas de conectividad en la ventana de salida de Gemini Code Assist

Si ves un error de conexión o algún otro problema de conectividad en la ventana de salida de Gemini Code Assist, prueba lo siguiente:

  • Configura el firewall para permitir el acceso a oauth2.googleapis.com y cloudaicompanion.googleapis.com.

  • Configura tu firewall para permitir la comunicación a través de HTTP/2, que gRPC usa.

Puedes usar la herramienta de grpc-health-probe para probar la conectividad. Una verificación correcta genera el siguiente resultado:

$ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

Una verificación incorrecta da como resultado el siguiente resultado:

timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

Para obtener más detalles, ejecuta lo siguiente antes del grpc-health-probe:

export GRPC_GO_LOG_SEVERITY_LEVEL=info

Enviar comentarios

Para dejar comentarios sobre tu experiencia, sigue estos pasos:

  1. En la barra de estado, haz clic en Gemini Code Assist y, luego, en el menú Selección rápida, selecciona Enviar comentarios.

  2. En el formulario, completa los campos Título y Comentarios.

  3. Si deseas compartir tus registros de Skaffold o AI Companion, asegúrate de seleccionar la opción Enviar registros de Skaffold o Enviar registros de AI Companion.

  4. Haz clic en Enviar comentarios.

¿Qué sigue?