Crea código con Gemini Code Assist Standard y Enterprise

En este documento, se describe cómo puedes usar Gemini Code Assist Standard y Enterprise, un colaborador potenciado por IA en tu IDE, para ayudarte a hacer lo siguiente en VS Code o IntelliJ y otros IDE de JetBrains compatibles:

  • Genera código para tu proyecto con la transformación de código.
  • Recibir finalización de código mientras escribes
  • Usa acciones inteligentes.

Si usas Gemini Code Assist Enterprise, puedes usar la personalización de código, que te permite obtener sugerencias de código basadas en la base de código privada de tu organización directamente desde Gemini Code Assist Enterprise. 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 da por sentado que tienes conocimientos prácticos de VS Code o IntelliJ y otros IDE de JetBrains compatibles, y que conoces Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en el editor de Cloud Shell, Cloud Workstations y Android Studio.

Antes de comenzar

VS Code

  1. Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.

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

  3. Si prefieres usar tu IDE detrás de un proxy, consulta Conexiones de red en Visual Studio Code.

IntelliJ

  1. Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.

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

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

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, pedirle 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 con transformación de código

La transformación de código te permite usar comandos o instrucciones en lenguaje natural en el menú Quick Pick para solicitar modificaciones en tu código y te proporciona una vista de diferencia para mostrar los cambios pendientes en tu código. Para solicitar a Gemini Code Assist que realice la transformación de código, sigue estos pasos:

VS Code

  1. En el archivo de código, en una línea nueva, presiona Control + I (para Windows y Linux) o Command + I (para macOS) para abrir el menú Gemini Code Assist Quick Pick.

  2. En el menú, con el comando /generate, ingresa /generate function to create a Cloud Storage bucket y, luego, presiona Intro (para Windows y Linux) o Retorno (para macOS).

    Gemini Code Assist genera código con el comando /generate.

    Gemini Code Assist genera el código según tu instrucción en una vista de diferencias.

    Gemini Code Assist abre una vista de diferencias para mostrar el código generado.

  3. Opcional: Para aceptar estos cambios, haz clic en Aceptar.

IntelliJ

  1. En el archivo de código, en una línea nueva, presiona Alt+\ (para Windows y Linux) o Cmd+\ (para macOS) para abrir el menú Selección rápida de Gemini Code Assist.

  2. En el menú, con el comando /generate, ingresa /generate function to create a Cloud Storage bucket y, luego, presiona Intro (para Windows y Linux) o Intro (para macOS).

    Función de generación de transformación de código en IntelliJ Gemini Code Assist

    Gemini Code Assist genera el código según tu instrucción en una vista de diferencias.

    Vista de diferencia de transformación de código en Gemini Code Assist de IntelliJ

  3. Opcional: Para aceptar estos cambios, haz clic en Aceptar cambios.

    Puedes usar los siguientes comandos de transformación de código en tu IDE:

    • /fix: Corrige problemas o errores en tu código. Ejemplo: /fix potential NullPointerExceptions in my code.
    • /generate: Genera código. Ejemplo: /generate a function to get the current time.
    • /doc: Agrega documentación a tu código. Ejemplo: /doc this function.
    • /simplify: Simplifica tu código. Ejemplo: /simplify if statement in this code.

Cómo enviar una instrucción a Gemini Code Assist en un archivo de código con un comentario

Si lo prefieres, también puedes usar un comentario para indicarle a Gemini Code Assist que realice una acción en tu archivo de código. Para ello, sigue estos pasos:

VS Code

  1. En una línea nueva, ingresa el comentario Function to create a Cloud Storage bucket y, luego, presiona Intro (para Windows y Linux) o Retorno (para macOS).

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

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

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

IntelliJ

  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:

VS Code

  1. En tu IDE, haz clic en File (para Windows y Linux) o Code (para macOS) y, luego, ve a Settings > Keyboard Shortcuts.

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

  3. Haz clic en Gemini Code Assist: 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 (para Windows y Linux) o Retorno (para macOS).

    Ahora puedes usar la combinación de teclas asignada recientemente para generar código con Gemini Code Assist.

Para obtener más información sobre cómo cambiar las combinaciones de teclas en tu IDE, consulta Vinculaciones de teclas para Visual Studio Code.

IntelliJ

  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 bien 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 obtener finalizaciones de código

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

VS Code

  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 Python, escribe def.

    Gemini Code Assist sugiere código en forma de texto fantasma.

  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.

IntelliJ

  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 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 combinación de teclas 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 acceso directo y aceptar una sugerencia intercalada.

Opcional: Inhabilita la finalización de código

La finalización de código está habilitada de forma predeterminada. Si quieres inhabilitar la finalización de código, sigue estos pasos:

VS Code

  1. En tu IDE, haz clic en Code (para macOS) o File (para Windows y Linux) y, luego, ve a Settings > Settings.

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

  3. Desplázate hasta encontrar la lista Duet AI: Inline Suggestions: Enable Auto y, luego, selecciona Desactivado.

    Esto desactiva las sugerencias intercaladas. Puedes presionar Control + Intro (para Windows y Linux) o Control + Intro (para macOS) para activar manualmente las sugerencias intercaladas.

IntelliJ

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 ya no hace sugerencias intercaladas hasta que vuelvas a habilitar la configuración.

Cómo usar 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:

VS Code

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

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

    El ícono de bombilla de acciones inteligentes aparece después de seleccionar un bloque de código en VS Code.

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

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

IntelliJ

  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 Gemini Code Assist.

Usa la corrección rápida de transformación de código

Si hay un error en tu código, Gemini Code Assist te brinda la opción de aplicar una solución rápida al error con la transformación de código.

Para aplicar una solución rápida en el archivo de código, sigue estos pasos:

VS Code

  1. En el archivo de código, mantén el puntero sobre la línea de error con líneas onduladas y selecciona Quick Fix y, luego, /fix.

    Corrección rápida de transformación de código en el IDE

  2. Cuando se aplica la corrección rápida, aparece una vista de diferencias. Para aceptar estos cambios, haz clic en Aceptar.

IntelliJ

  1. En el archivo de código, haz clic en el ícono de bombilla de error rojo, que indica un error en el código, y selecciona Corregir con Gemini.

    Opción de transformación de código para corregir con Gemini en el IDE.

  2. Cuando se aplica la corrección, aparece una vista de diferencias. Para aceptar estos cambios, haz clic en Aceptar.

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

Gemini Code Assist proporciona información de cita cuando cita de forma directa y extensa de otra fuente, como el código de código abierto existente. Para obtener más información, consulta Cómo y cuándo Gemini cita fuentes.

Para evitar que se te sugiera código que coincida con las fuentes citadas, haz lo siguiente:

  1. En la barra de actividades de tu IDE, haz clic en Administrar > Configuración.

  2. En la pestaña Usuario de la ventana de configuración, navega a Extensiones > Gemini Code Assist.

  3. Desplázate hasta encontrar Duet AI > Recitation: Max Cited Length.

  4. Establece el valor en 0.

    Gemini Code Assist ya no te sugiere código que coincida con las fuentes citadas.

Problemas conocidos

En esta sección, se describen los problemas conocidos de Gemini Code Assist:

VS Code

  • Es posible que las respuestas del chat se truncen cuando incluyen una versión actualizada de un archivo abierto grande.

    Para solucionar este problema, selecciona una sección más pequeña de código y, luego, incluye una directiva adicional en la instrucción del chat, como only output the selected code..

  • Vim: No se pueden aceptar ni descartar sugerencias de generación de código, a menos que se esté en el modo de inserción.

    Cuando usas el complemento Vim en modo normal, no puedes aceptar ni descartar las 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.

  • Vim: Comportamiento incoherente cuando se presiona Esc para descartar sugerencias

    Cuando presionas Esc, se descartan las sugerencias del IDE y Gemini Code Assist. Este comportamiento es diferente del comportamiento no de Vim, en el que presionar Esc vuelve a activar Gemini Code Assist.

  • Los intentos de acceso se agotan

    Si los intentos de acceso siguen agotando el tiempo de espera, intenta agregar la configuración cloudcode.beta.forceOobLogin a tu archivo settings.json:

     "cloudcode.beta.forceOobLogin": true
    
  • Las advertencias de recitación de licencias no persisten entre sesiones

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

    1. Haz clic en Ver > Resultado.

    2. Selecciona Gemini Code Assist - Citations.

  • 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 usa gRPC.

    Puedes usar la herramienta 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

    Si la verificación no se realiza correctamente, se muestra el siguiente resultado:

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

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

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    
  • La opción "Activar Gemini Code Assist" sigue apareciendo después de seleccionar el proyecto de Gemini Code Assist

    Si seleccionaste tu proyecto según las instrucciones de esta guía, lo que incluye habilitar la API de Gemini para Google Cloud, es posible que haya un problema con el servidor de LS.

    Para obtener más detalles sobre tu problema, realiza las siguientes acciones:

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

    2. Haz clic en Mostrar en cualquiera de los archivos de registro para ver más detalles y solucionar el problema.

IntelliJ

No hay problemas conocidos con Gemini Code Assist para IntelliJ y otros IDE de JetBrains compatibles.

Enviar comentarios

Para dejar comentarios sobre tu experiencia, sigue estos pasos:

VS Code

  1. En la barra de estado, haz clic en spark Gemini Code Assist y, luego, en el menú Quick Pick, selecciona Send feedback.

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

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

  4. Haz clic en Enviar comentarios.

IntelliJ

  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 aparece 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?