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 tu IDE:

  • Proporcionar orientación para ayudarte a resolver problemas con tu código
  • Genera código para tu proyecto.
  • Recibir sugerencias intercaladas mientras escribes código

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

La personalización de código te permite obtener sugerencias de código basadas en la base de código privada de tu organización directamente desde Gemini Code Assist. Obtén información para configurar la personalización de código.

Este documento está dirigido a desarrolladores de todos los niveles de habilidad. Se supone que tienes conocimientos prácticos de IntelliJ y que conoces Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en VS Code, Cloud Shell Editor y Cloud Workstations.

Antes de comenzar

  1. Antes de probar las funciones de Gemini Code Assist en tu archivo de código, asegúrate de que el lenguaje de programación del archivo sea compatible. Para obtener más información sobre los lenguajes de programación admitidos, consulta Lenguajes de programación admitidos.

  2. Si prefieres usar tu IDE detrás de un proxy, consulta Proxy HTTP.

Instala el complemento Gemini Code Assist

Para instalar el complemento Gemini Code Assist en tu IDE de JetBrains, sigue estos pasos:

  1. Haz clic en settings IDE y configuración del proyecto > Complementos.
  2. En la pestaña Marketplace, busca Gemini Code Assist.
  3. Haz clic en Install para instalar el complemento.
  4. Cuando finalice la instalación, haz clic en Restart IDE.
  5. Cuando se reinicie el IDE, Gemini Code Assist aparecerá en la barra de actividad.

    Aparecerá el ícono de Gemini Code Assist en la barra de actividades.

Ya puedes usar Gemini Code Assist en tu IDE.

Accede a Google y selecciona un proyecto de Google Cloud

En esta sección, accedes a tu Cuenta de Google y, si es la primera vez que usas Gemini Code Assist en tu IDE, seleccionas un proyecto de Google Cloud.

Para acceder a tu Cuenta de Google, sigue estos pasos:

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

  2. Haz clic en Acceder a Google.

  3. En la página que se abre en el navegador web, selecciona tu Cuenta de Google.

  4. En la pantalla que te solicita que te asegures de haber descargado esta app de Google, haz clic en Acceder.

    Gemini Code Assist tiene la autorización para acceder a tu cuenta.

A continuación, si es la primera vez que usas Gemini en tu IDE, debes seleccionar un proyecto de Google Cloud. Para ello, sigue estos pasos:

  1. Regresa a tu IDE. En la ventana de herramientas de Gemini Code Assist, si aceptas permitir que Google habilite las APIs necesarias para usar Gemini Code Assist en tu nombre para el proyecto seleccionado, haz clic en Seleccionar un proyecto de GCP para continuar.

  2. En el diálogo Select Google Cloud Project, busca y selecciona tu proyecto de Google Cloud y, luego, haz clic en OK.

  3. Haz clic en FINALIZAR.

Se seleccionó tu proyecto de Google Cloud con la API de Gemini Code Assist habilitada. Ya puedes usar Gemini en tu IDE.

Chatea con Gemini Code Assist

En esta sección, le pides a Gemini Code Assist que proporcione una explicación de tu código existente.

Para obtener una explicación de tu código, sigue estos pasos:

  1. En tu IDE, abre el archivo de código.

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

    Gemini Code Assist usa el código de tu archivo de código como una referencia a tu instrucción y responde con una explicación de tu código.

    Si solo quieres una explicación de una parte específica de tu código, puedes seleccionar un código determinado y, luego, volver a solicitar Gemini Code Assist. Gemini Code Assist solo usará el código seleccionado como referencia para su respuesta generada.

Estos son algunos otros ejemplos de instrucciones que puedes probar con Gemini Code Assist:

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

Cuando Gemini Code Assist te proporciona código en su respuesta, puedes seleccionar las siguientes opciones que se indican al final de la respuesta:

  • Insertar en el cursor: Inserta el código generado en el archivo actual en la posición actual del cursor.

  • Insertar en archivo nuevo: Abre un archivo nuevo y, luego, inserta el código generado en él.

Gemini enumera las acciones de código al final de una respuesta de código generada.

Estas opciones están disponibles cuando Gemini Code Assist identifica el idioma que se usa en tu bloque de código y si este idioma es compatible con tu IDE actual.

Ve el historial de consultas

Si quieres volver a usar las instrucciones anteriores, puedes encontrarlas en el Historial de consultas de la ventana de herramientas de Gemini Code Assist. Para ello, haz clic en schedule Show Query History.

Historial de consultas de Gemini en la ventana de herramientas.

Tu consulta y el historial de conversaciones persisten en todas las sesiones del IDE. Para borrar el historial de consultas y conversaciones, haz clic en delete Borrar historial de conversaciones.

Botón para borrar el historial de conversaciones en la ventana de herramientas de Gemini.

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 tu archivo de código. 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ómo solicitar Gemini Code Assist en un archivo de código con un comentario

  1. En el archivo de código, en una línea nueva, ingresa el comentario Function to create a Cloud Storage bucket.

  2. Para generar código, presiona Alt + G (para Windows y Linux) o Opción + G (para macOS). Como alternativa, puedes hacer clic con el botón derecho junto al comentario y seleccionar Generate Code.

    Gemini Code Assist genera el código debajo de tu comentario en forma de texto fantasma.

  3. 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. Navega a settings IDE and Project Settings > Settings > Keymap > Gemini Code Assist.

  2. Haz clic con el botón derecho en Gemini Code Assist y selecciona Add Keyboard Shortcut.

  3. Ingresa la combinación de teclas que prefieras y, luego, haz clic en Aceptar.

  4. Haz clic con el botón derecho en Gemini Code Assist y selecciona Remove Alt+G (para Windows y Linux) o Remove Option+G (para macOS).

    Ahora puedes usar tu nueva combinación de teclas para generar código en un archivo de código.

Cómo enviar una instrucción 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 código generado que se base en una instrucción con código seleccionado, sigue estos pasos:

  1. En la barra de actividades, haz clic en spark Gemini Code Assist para abrir la ventana de herramientas Gemini Code Assist.

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

  3. En el campo de texto de la ventana de herramientas Gemini Code Assist, ingresa una instrucción 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 Code Assist usa el código que seleccionaste como referencia y responde a tu instrucción.

Cómo obtener finalizaciones de código

Mientras escribes código, Gemini Code Assist te ofrece sugerencias de código intercaladas, llamadas finalizaciones de código, que puedes aceptar o ignorar. Para obtener la finalización de código, sigue estos pasos:

  1. 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 Code Assist sugiere código en forma de sugerencia intercalada.

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

  3. Opcional: Si prefieres usar una tecla de acceso directo diferente para aceptar la sugerencia intercalada, coloca el puntero sobre ella y haz clic en el menú desplegable Tab que aparece. Luego, selecciona el atajo que prefieras o haz clic en Personalizado para ingresar uno propio.

    Gemini proporciona un menú desplegable para cambiar el atajo y aceptar una sugerencia intercalada.

La finalización de código está habilitada de forma predeterminada. Si quieres inhabilitar la finalización de código, en la barra de estado de tu IDE, haz clic en spark Gemini Code Assist: Active y selecciona Enable AI Code Completion.

Botón de finalización de código de Gemini en la barra de estado de IntelliJ.

Esto inhabilita la configuración de finalización de código, y Gemini Code Assist deja de hacer sugerencias intercaladas hasta que vuelvas a habilitar la configuración.

Usa acciones inteligentes

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

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

  1. En el archivo de código, selecciona una línea o un bloque de código.

  2. Haz clic con el botón derecho en el código seleccionado y selecciona una acción inteligente, como Generate unit tests.

    Si seleccionas la acción inteligente, Gemini Code Assist generará automáticamente una respuesta a la instrucción en la ventana de herramientas de Gemini Code Assist.

Opcional: Excluye archivos del contexto con un archivo .aiexclude

Puedes excluir archivos para que Gemini Code Assist no los considere para el contexto. Para ello, crea un archivo .aiexclude. Un archivo .aiexclude tiene una sintaxis similar a la de un archivo .gitignore, con las siguientes diferencias:

  • Un archivo .aiexclude vacío o inexistente no bloquea ningún archivo en su directorio ni en todos los subdirectorios.
  • Un archivo .aiexclude no admite la negación, en la que se antepone un signo de exclamación (!) a los patrones.
  • Un archivo .aiexclude coincide de manera codiciosa con el carácter *. Esto hará coincidir de manera indiscriminada los directorios y los archivos. Este archivo .aiexclude no diferencia entre ** o * en relación con las carpetas o los archivos.

Actualmente, solo se admite un solo archivo .aiexclude. Para configurar tu archivo .aiexclude, crea un archivo titulado .aiexclude en la raíz de la carpeta de tu lugar de trabajo.

Ejemplos

En los siguientes ejemplos, se muestra cómo puedes configurar un archivo .aiexclude:

  • Bloquea todos los archivos llamados apikeys.txt en el directorio del espacio de trabajo o debajo de él:

    apikeys.txt
    
  • Bloquea todos los archivos con la extensión .key en el directorio del espacio de trabajo o debajo de él:

    *.key
    
  • Bloquea solo el archivo apikeys.txt en el mismo directorio que el archivo .aiexclude, pero no en ningún subdirectorio:

    /apikeys.txt
    
  • Bloquea todos los archivos del directorio my/sensitive/dir y todos los subdirectorios. La ruta de acceso debe ser relativa al directorio raíz del lugar de trabajo.

    my/sensitive/dir/*
    

Enviar comentarios

Para dejar comentarios sobre tu experiencia, sigue estos pasos:

  1. En la barra de estado, haz clic en spark Gemini Code Assist y, luego, en el menú, selecciona Enviar comentarios.

  2. En el campo de texto que se encuentra en la parte superior del formulario, ingresa tus comentarios.

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

  4. Haz clic en Enviar comentarios.

¿Qué sigue?