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 VS Code y que estás familiarizado con Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en Cloud Workstations, Cloud Code para IntelliJ y el Editor de Cloud Shell.
Antes de comenzar
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 codificación admitidos.
Si aún no lo has hecho, instala la extensión Gemini Code Assist + Cloud Code. Cloud Code se integra con Gemini Code Assist en tu IDE.
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 que te dará la opción de habilitar la API desde el IDE. Selecciona Habilitar la API en la ventana de notificación para habilitar la API para tu proyecto. Para obtener más información, consulta Cómo configurar Gemini Code Assist para un proyecto.
Si prefieres seguir la explicación de Cómo programar con Gemini Code Assist directamente en tu IDE, haz clic en Iniciar VS Code y sigue los pasos de la explicación para conectarte a Google Cloud y activar Gemini Code Assist.
De lo contrario, sigue estos pasos:
Inicia tu IDE.
En la barra de estado, haz clic en Cloud Code - Acceder.
Cuando se te solicite que permitas que Cloud Code abra el sitio web externo, haz clic en Abrir.
Sigue las indicaciones para acceder a tu Cuenta de Google.
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:
En la barra de estado de Gemini Code Assist, haz clic en Gemini Code Assist.
En el menú de Gemini Code Assist, selecciona Seleccionar proyecto de Gemini Code Assist.
Selecciona un proyecto de Google Cloud que tenga habilitada la API de Cloud AI Companion.
Gemini está listo para usarse.
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:
Abre el archivo de código.
En la barra de actividades de tu IDE, haz clic en spark de Gemini Code Assist.
En el panel de Gemini Code Assist, ingresa el mensaje
Explain this code to me
y haz clic en enviar 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.
Para hacer referencia a un bloque de código específico en lugar de a todo el código del archivo, puedes seleccionar el bloque de código y, luego, indicarle a Gemini.
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 tu archivo de código. También puedes seleccionar una parte del código y, luego, pedirle ayuda a Gemini Code Assist a través de la función de chat, así como recibir y aceptar o rechazar las sugerencias de código mientras escribes el código.
Cómo indicarle a Gemini Code Assist en un archivo de código
En una línea nueva del archivo de código, ingresa el comentario
Function to create a Cloud Storage bucket
y, luego, presiona Intro (para Windows y Linux) o Return (para macOS).Para generar código, presiona Control + Intro (para Windows y Linux) o Control + Retorno (para macOS).
Junto al texto de la instrucción en tu archivo de código, Gemini Code Assist genera el código en forma de texto fantasma.
Opcional: Para aceptar el código generado, presiona el Tabulador.
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:
En el IDE, haz clic en File (para Windows y Linux) o Code (para macOS) y, luego, ve a Settings > Keyboard Shortcuts.
En la lista de combinaciones de teclas, desplázate hasta encontrar Cloud Code: Generate code.
Haz clic en Cloud Code: Generar código y, luego, en Editar Cambiar Vinculación de claves.
En el cuadro de diálogo que aparece, ingresa tu propia combinación de teclas.
Presiona Intro (para Windows y Linux) o Intro (para macOS).
Ahora puedes usar la combinación de teclas que acabas de asignar para generar código con Gemini Code Assist.
Si deseas obtener más información sobre cómo cambiar combinaciones de teclas en tu IDE, consulta Keybindings para Visual Studio Code.
Cómo indicarle a Gemini Code Assist con el código seleccionado por medio del chat
Gemini Code Assist puede realizar tareas o responder tus preguntas según el código que selecciones. Para obtener un código generado a partir de una instrucción con el código seleccionado, sigue estos pasos:
En la barra de actividades, haz clic en spark de Gemini Code Assist para abrir el panel de Gemini Code Assist.
En el archivo de código, selecciona un bloque de código.
En el campo de texto del panel de Gemini Code Assist, ingresa un mensaje para el código seleccionado.
Por ejemplo, selecciona una función en tu código y escribe el mensaje
Write a unit test for this function
:Gemini usa el código seleccionado como referencia y responde a tu instrucción.
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:
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.
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.
Opcional: Inhabilita las sugerencias intercaladas
Si prefieres inhabilitar las sugerencias intercaladas en Gemini Code Assist, sigue estos pasos:
En el IDE, selecciona Código (para macOS) o Archivo (para Windows y Linux), y, luego, navega a Configuración > Configuración.
En la pestaña Usuario del diálogo Configuración, navega a Extensiones > Cloud Code.
Desplázate hasta encontrar la lista Cloudcode: Gemini Code Assist: 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 las sugerencias intercaladas de forma manual.
Inhabilitar las sugerencias de código que coincidan con las fuentes citadas
Gemini proporciona información sobre citas cuando cita de forma directa a 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 fuentes citadas, puedes modificar la configuración cloudcode.duetAI.recitation.maxCitedLength
a 0
en un archivo settings.json
:
"cloudcode.duetAI.recitation.maxCitedLength": 0
Usa acciones inteligentes
Para ayudarte a aumentar tu productividad y minimizar el cambio de contexto, Gemini Code Assist proporciona acciones inteligentes potenciadas por IA directamente en tu editor de código. Cuando selecciones el código en el editor de código, podrás ver y seleccionar opciones de una lista de acciones relevantes para tu contexto.
Para usar acciones inteligentes en tu código, sigue estos pasos:
En el archivo de código, selecciona un bloque de código.
Junto al bloque de código seleccionado, haz clic en bombilla Mostrar acciones de código.
Selecciona una acción, como Generate unit tests.
Gemini genera una respuesta que se basa en la acción que seleccionaste.
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.
Obtén una explicación del código
- En el archivo de código, selecciona una función que quieras explicar.
En el panel de Gemini Code Assist, ingresa la instrucción
Explain this code to me
.Gemini usa el código seleccionado como referencia y responde con una explicación de la función seleccionada.
Genera planes de prueba
- En el archivo de código, selecciona el código al que desees agregar pruebas de unidades.
- En el panel de Gemini Code Assist, ingresa la instrucción
Write unit tests for my code
.
Cómo obtener ayuda con la depuración de código
- En el archivo de código, selecciona el código que deseas depurar.
- En el panel de Gemini Code Assist, ingresa la instrucción
Help me debug my code
.
Haz que tu código sea más legible
- En el archivo de código, selecciona el código que desees que sea más legible.
En el panel de Gemini Code Assist, ingresa la instrucción
Make my code more readable
.Si prefieres enfocarte en una parte específica de tu código, selecciona esa parte antes de indicarle a Gemini.
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.
.
Vim: No se pueden aceptar ni descartar sugerencias de generación de código, a menos que estén 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 de IntelliJ y Gemini. Este comportamiento es diferente del comportamiento que no es de VIP, en el que presionar Esc vuelve a activar Gemini.
Se agota el tiempo de espera de los intentos de acceso
Si se agota el tiempo de espera de tus intentos de acceso, agrega la
configuración cloudcode.beta.forceOobLogin
al archivo settings.json
:
"cloudcode.beta.forceOobLogin": true
Las advertencias de consulta de licencias no persisten en las sesiones
Si las advertencias de recopilación de licencias no persisten en todas las 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 de grpc-health-probe
para probar la conectividad. Una verificación correcta da como resultado 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 es exitosa, 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
Enviar comentarios
Para dejar comentarios sobre tu experiencia, sigue estos pasos:
En la barra de estado, haz clic en Gemini Code Assist y, en el menú Selección rápida, selecciona Enviar comentarios.
En el formulario, completa los campos Título y Comentarios.
Si quieres compartir tus registros de Skaffold o AI Companion, asegúrate de seleccionar las opciones Enviar registros de Skaffold o Enviar registros de AI Companion.
Haz clic en Enviar comentarios.
¿Qué sigue?
- Aprende a escribir mejores instrucciones.