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

  • 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 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 Cloud Shell Editor.

Antes de comenzar

  1. Instala el complemento de Cloud Code si aún no lo has hecho. Gemini Code Assist está integrado en Cloud Code para incorporar al colaborador potenciado por IA en 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 la plataforma con la API de Cloud AI Companion habilitada en tu IDE.

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 tu IDE, sigue estos pasos:

  1. Inicia el 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.

    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.

    Botón de la barra de estado de Gemini.

  2. En el menú 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 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 tu IDE, haz clic en File > New > Project.

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

  3. Selecciona uno de los ejemplos de Guestbook que correspondan al idioma que prefieras y haz clic en Next.

  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 recién creado para su uso.

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 o usa uno existente. Si usas la muestra de Python (Flask), puedes realizar esta tarea en tu archivo front.py. Para ello, en la ventana de herramientas Project, navega al src > frontend y abre el archivo front.py.

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

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

  3. En la ventana de chat Gemini Code Assist, ingresa el mensaje Explain this code to me y haz clic en 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.

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 recibir, 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: en el panel Project, navega a python-Guestbook > 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 Alt + Mayúsculas + \ (en Windows y Linux) o Opción + Mayúsculas + \ (en macOS). De manera alternativa, en el margen de tu archivo de código, haz clic en spark Gemini Code Assist.

    El margen de Cloud Code muestra el ícono de Generar código con 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 Tab. 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 en 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 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 diálogo Combinación 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 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: en el panel Project, navega a python-Guestbook > 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.

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

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.

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

  • 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 de gran tamaño

Para solucionar este problema, selecciona una sección de código más pequeña y agrega 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, pasa al modo de comando VIM y no 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 encuentre en el modo de inserción.

Cuando usas 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 Submit feedback.

  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?