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 que te ayude a hacer lo siguiente en Cloud Code:

  • Proporciona orientación que te ayude a resolver problemas con tu código.

  • Genera código para tu proyecto.

  • Recibe sugerencias intercaladas mientras codificas.

Descubre cómo y cuándo 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 fuentes cuando sus sugerencias citan directamente en detalle una fuente específica. Para obtener más información sobre cómo y cuándo Gemini cita fuentes, consulta Cómo Gemini te ayuda a generar código y cita fuentes.

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

Antes de comenzar

  1. Si aún no lo hiciste, instala el complemento de Gemini Code Assist/Cloud Code. Gemini Code Assist se integra en Cloud Code para incorporar al colaborador potenciado por IA a tu IDE local.
  2. Opcional: Si eliges clonar una muestra para las tareas de este documento, instala Git. Se requiere Git para copiar muestras en tu máquina.

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 Google Cloud con la API de Cloud AI Companion habilitada en tu IDE.

Si seleccionas un proyecto de Google Cloud que no tiene habilitada la API de Cloud AI Companion, 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 tu IDE, sigue estos pasos:

  1. Inicia tu IDE.

  2. Haz clic en Herramientas > Google Cloud Code > Acceder a Google Cloud Platform.

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

  4. Cuando se te pregunte si descargaste Cloud Code de Google, haz clic en Acceder.

    Ya te conectaste a Google Cloud.

A continuación, 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.

    Botón de la barra de estado de Gemini.

  2. En el menú de Gemini Code Assist, selecciona Configuración.

  3. En el campo Proyecto de Cloud, haz clic en more_horiz Seleccionar proyecto de Google Cloud y selecciona un proyecto que tenga habilitada la API de Cloud AI Companion.

    Gemini está listo para usarse.

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

Opcional: Crea una aplicación de ejemplo

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

  1. En el IDE, haz clic en File > New > Project.

  2. En el panel izquierdo de la ventana New Project, selecciona Cloud Code: Kubernetes.

  3. Selecciona una de las muestras de Guestbook que corresponda a tu lenguaje preferido y, luego, haz clic en Siguiente.

  4. Ingresa un nombre para el proyecto y elige una ubicación.

  5. Haz clic en Crear.

    Cloud Code clona la plantilla de Python (Flask) y abre el proyecto que acabas de crear para usarlo.

Chatea con Gemini Code Assist

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

Para comenzar a chatear con Gemini, sigue estos pasos:

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

  2. En la barra de estado, haz clic en Gemini Code Assist y, luego, selecciona Abrir chat.

    El botón de Gemini de la barra de estado de Cloud Code muestra la opción Abrir chat.

  3. En la ventana de chat de Gemini Code Assist, ingresa la instrucción Explain this code to me y haz clic en Enviar.

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

Restablecer historial de chat

Gemini Code Assist usa el historial de chat para obtener contexto adicional cuando responde tus instrucciones.

Si tu historial de chat ya no es relevante para lo que quieres 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 la instrucción de ejemplo # Function to create a Cloud Storage bucket dentro de un archivo de Python. También puedes recibir y aceptar o rechazar las sugerencias de código mientras lo escribes.

Cómo indicarle 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. Para ello, en el panel Project, navega a python-Guest > src > frontend y abre el archivo front.py.

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

  3. Para generar código, presiona Alt + Mayúsculas + \ (para Windows y Linux) o bien Opción + Mayúsculas + \ (macOS). Como alternativa, en el margen del archivo de código, haz clic en spark de Gemini Code Assist.

    El margen en Cloud Code muestra el ícono de Generate Code with Gemini.

    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 el Tabulador. Si prefieres aceptar una sola línea del código generado, presiona Mayúsculas + Intro.

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 tu IDE, haz clic en File (para Windows y Linux) o IntelliJ IDEA (para macOS), y, luego, navega a Settings > Keymap > Plugins > Google Cloud Code.

  2. En la lista de combinaciones de teclas, desplázate hasta encontrar Generar código.

  3. Haz clic con el botón derecho en Generar código y, luego, selecciona Agregar combinación de teclas.

  4. En el cuadro de diálogo Combinaciones de teclas, haz doble clic en la combinación de teclas actual y, luego, ingresa tu propia combinación de teclas.

  5. Haz clic en OK.

  6. Haz clic en Apply y, luego, en OK.

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

Si quieres obtener más información para cambiar combinaciones de teclas en tu IDE, consulta Cómo configurar combinaciones de teclas.

Obtén sugerencias intercaladas mientras escribes código

Mientras escribes código, Gemini Code Assist hace sugerencias intercaladas 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. Para ello, en el panel Project, navega a python-Guest > src > frontend y abre el archivo front.py.

  2. En tu 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 tu código.

Cómo probar otros ejemplos de instrucciones

Después de leer la sección Genera código con instrucciones de este documento, prueba algunas de las siguientes instrucciones de ejemplo.

En el panel de chat de Gemini Code Assist, ingresa cualquiera de las siguientes instrucciones:

  • Explain this code to me.
  • Write unit tests for my code.
  • Help me debug my code.
  • Make my code more readable.

Problemas conocidos

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

Es posible que las respuestas de Chat se trunquen cuando incluyan una versión actualizada de un archivo abierto grande

Para solucionar este problema, selecciona una sección de código más pequeña e incluye una directiva adicional en el mensaje de chat, como only output the selected code..

IdeaVim: El complemento no muestra la sugerencia de Gemini Code Assist cuando se presiona Esc para descartar la sugerencia de IntelliJ

Cuando usas el complemento IdeaVim en IntelliJ, si presionas Esc para descartar la sugerencia de IntelliJ, se pasa al modo de comando VIM y no se muestra la sugerencia de Gemini Code Assist.

Gemini Code Assist funciona según lo previsto en el modo de inserción.

IdeaVim: No se pueden aceptar sugerencias de generación de código, a menos que se esté en modo de inserción

Cuando utilizas el complemento IdeaVim en modo normal, no puedes aceptar sugerencias de código.

Para solucionar este problema, presiona i para ingresar al modo de inserción y, luego, presiona Tab para aceptar la sugerencia.

Para descartar la sugerencia, presiona Esc.

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ú, selecciona Enviar comentarios.

  2. En el formulario, ingresa tus comentarios en el campo de texto superior.

  3. Si quieres compartir tus registros de Gemini Code Assist, asegúrate de seleccionar las opciones de registro.

  4. Haz clic en Enviar comentarios.

¿Qué sigue?