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 sugerencias de finalización de código mientras escribes
- Usar 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 más información para configurar la personalización del código.
Este documento está dirigido a desarrolladores de todos los niveles de habilidad. Se supone 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
Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.
Antes de probar las capacidades 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.
Si prefieres usar tu IDE detrás de un proxy, consulta Conexiones de red en Visual Studio Code.
IntelliJ
Configura Gemini Code Assist Standard o Enterprise si aún no lo hiciste.
Antes de probar las capacidades 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.
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 programas.
Instruye a Gemini Code Assist con transformación de código
La transformación de código te permite usar comandos o mensajes en lenguaje natural en el menú Quick Pick para solicitar modificaciones en tu código y te proporciona una vista de diferencias para mostrar los cambios pendientes en tu código. Para solicitarle a Gemini Code Assist una transformación de código, sigue estos pasos:
VS Code
En tu archivo de código, en una línea nueva, presiona Control + I (para Windows y Linux) o Comando + I (para macOS) para abrir el menú Gemini Code Assist Quick Pick.
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 el código según tu instrucción en una vista de comparación.
Opcional: Para aceptar estos cambios, haz clic en Aceptar.
IntelliJ
En tu 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.
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 el código según tu instrucción en una vista de comparación.
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 los 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
.
Envía una instrucción a Gemini Code Assist en un archivo de código con un comentario
Si lo prefieres, también puedes darle una instrucción a Gemini Code Assist en tu archivo de código con un comentario siguiendo estos pasos:
VS Code
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).Para generar código, presiona Control + Intro (en Windows y Linux) o Control + Retorno (en 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.
Opcional: Para aceptar el código generado, presiona Tab.
IntelliJ
En tu archivo de código, ingresa el comentario
Function to create a Cloud Storage bucket
en una línea nueva.Para generar código, presiona Alt + G (para Windows y Linux) o Option + G (para macOS). Como alternativa, puedes hacer clic con el botón derecho junto al comentario y seleccionar Generar código.
Gemini Code Assist genera el código debajo de tu comentario en forma de texto fantasma.
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 indica en la sección anterior, puedes cambiarla.
Obtén 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 sugerencias de código, sigue estos pasos:
VS Code
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 Code Assist sugiere código en forma de texto fantasma.
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
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 Code Assist sugiere código en forma de sugerencia intercalada.
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: Si prefieres usar otra tecla de acceso directo para aceptar la sugerencia intercalada, mantén el puntero sobre la sugerencia intercalada y haz clic en el menú desplegable Tab que aparece. Luego, selecciona el atajo que prefieras o haz clic en Personalizado para ingresar tu propio atajo.
Opcional: Inhabilita la finalización de código
La finalización de código está habilitada de forma predeterminada. Si quieres inhabilitar la función de autocompletado de código, sigue estos pasos:
VS Code
En tu IDE, haz clic en Code (para macOS) o File (para Windows y Linux) y, luego, navega a Settings > Settings.
En la pestaña Usuario del diálogo Configuración, navega a Extensiones > Gemini Code Assist.
Desplázate hasta que encuentres la lista Duet AI: Inline Suggestions: Enable Auto y, luego, selecciona Off.
Esta acción desactiva las sugerencias intercaladas. Aún puedes presionar Control + Intro (para Windows y Linux) o Control + Retorno (para macOS) para activar manualmente las sugerencias intercaladas.
IntelliJ
En la barra de estado del IDE, haz clic en spark Gemini Code Assist: Activo y selecciona Habilitar la finalización de código con IA.
Esto inhabilita el parámetro de configuración de finalización de código, y Gemini Code Assist ya no hará sugerencias intercaladas hasta que vuelvas a habilitar el parámetro de configuración.
Cómo usar las 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
En tu archivo de código, selecciona un bloque de código.
Junto al bloque de código seleccionado, haz clic en lightbulb Mostrar acciones de código.
Selecciona una acción, como Generar pruebas de unidades.
Gemini Code Assist genera una respuesta basada en la acción que seleccionaste.
IntelliJ
En tu archivo de código, selecciona una línea o un bloque de código.
Haz clic con el botón derecho en el código seleccionado y elige una acción inteligente, como Generar pruebas de unidades.
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.
Cómo usar 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 corrección rápida al error con una transformación de código.
Para aplicar una corrección rápida en tu archivo de código, sigue estos pasos:
VS Code
En el archivo de código, mantén el puntero sobre la línea de error ondulada, selecciona Quick Fix y, luego, /fix.
Cuando se aplica la corrección rápida, aparece una vista de diferencias. Para aceptar estos cambios, haz clic en Aceptar.
IntelliJ
En tu archivo de código, haz clic en el ícono de bombilla de error rojo, que indica un error en tu código, y selecciona Corregir con Gemini.
Cuando se aplica la corrección, aparece una vista de diferencias. Para aceptar estos cambios, haz clic en Aceptar.
Excluye archivos del contexto local
De forma predeterminada, Gemini Code Assist excluye los archivos del uso local en el contexto para la finalización, la generación, la transformación y el chat de código si los archivos se especifican en un archivo .aiexclude
o .gitignore
.
Para obtener información sobre cómo excluir archivos del uso local, consulta Cómo excluir archivos del uso de Gemini Code Assist.
Inhabilita las sugerencias de código que coinciden con las fuentes citadas
Gemini Code Assist proporciona información de citas cuando cita directamente y de forma extensa otra fuente, como 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:
En la barra de actividades del IDE, haz clic en Administrar > Configuración.
En la pestaña Usuario de la ventana de configuración, navega a Extensiones > Gemini Code Assist.
Desplázate hasta encontrar Geminicodeassist > Recitation: Max Cited Length.
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
Las respuestas del chat pueden truncarse cuando incluyen una versión actualizada de un archivo abierto grande
Para solucionar este problema, selecciona una sección de código más pequeña y agrega una directiva adicional en la instrucción de 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 de Vim en modo normal, no puedes aceptar ni descartar 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 tanto el IDE como las sugerencias de Gemini Code Assist. Este comportamiento es diferente del comportamiento que no es de Vim, en el que presionar Esc vuelve a activar Gemini Code Assist.
Los intentos de acceso se agotan
Si tus intentos de acceso siguen agotando el tiempo de espera, intenta agregar el parámetro de configuración
cloudcode.beta.forceOobLogin
a tu archivosettings.json
:"cloudcode.beta.forceOobLogin": true
Las advertencias sobre la recitación de licencias no persisten entre sesiones
Si las advertencias de recitación de licencias no persisten entre sesiones, consulta los registros persistentes:
Haz clic en Ver > Salida.
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 tu firewall para permitir el acceso a
oauth2.googleapis.com
ycloudaicompanion.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 exitosa 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 mostrará 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
"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, que incluyen habilitar la API de Gemini para Google Cloud, es posible que haya un problema con el servidor LS.
Para obtener más detalles sobre tu problema, realiza las siguientes acciones:
En la barra de estado, haz clic en spark Gemini Code Assist y, luego, selecciona Enviar comentarios.
Haz clic en Mostrar en cualquiera de los archivos de registro para ver más detalles y solucionar el problema.
IntelliJ
No se conocen problemas 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
Puedes dejar comentarios de cualquiera de las siguientes maneras:
- En la barra de estado, haz clic en spark Gemini Code Assist y, luego, en el menú Quick Pick, selecciona Enviar comentarios.
- Abre la Paleta de comandos (
Ctrl
/Command
+Shift
+P
) y, luego, selecciona Gemini Code Assist: Send Feedback.
En el formulario, completa los campos Título y Comentarios.
En el formulario Comentarios sobre Gemini Code Assist, selecciona una opción en los menús desplegables Categoría de comentarios y Tipo.
Escribe una descripción detallada de tu experiencia en el campo Comentario.
Asegúrate de incluir tus registros de Gemini Code Assist en el informe de comentarios. De forma predeterminada, esta opción está seleccionada.
Marca o desmarca cualquiera de las otras opciones, según tus preferencias.
Haz clic en Enviar comentarios.
IntelliJ
En la barra de estado, haz clic en spark Gemini Code Assist.
Después de solicitarle ayuda a Gemini Code Assist en el chat, si no te satisface la respuesta, haz clic en thumb_down Negativo y, luego, selecciona Proporcionar comentarios.
En el campo de texto que se encuentra en la parte superior del formulario, ingresa tus comentarios.
Si quieres compartir tus registros de Gemini Code Assist, asegúrate de seleccionar los archivos de registro.
Haz clic en Enviar comentarios.
¿Qué sigue?
- Obtén más información para escribir mejores instrucciones.
- Descubre cómo Gemini para Google Cloud usa tus datos.
- Obtén más información sobre los precios de Gemini Code Assist.
- Obtén más información sobre el cumplimiento deGoogle Cloud .