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 cumplan con los requisitos de licencia de tu código Gemini Code Assist proporciona citas de fuentes cuando sus sugerencias cita directa y en detalle de una fuente específica. Para obtener más información sobre cómo y cuando Gemini cita fuentes, consulta Cómo te ayuda Gemini 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 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 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 programación admitidos.
Instala el Gemini Code Assist + extensión de Cloud Code si aún no lo hiciste. Cloud Code se integra en Gemini Code Assist en tu IDE.
Si prefieres usar tu IDE detrás de un proxy, consulta Conexiones de red en Visual Studio Code.
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 Gemini para Google Cloud habilitada en tu IDE.
Si seleccionas un proyecto de Google Cloud sin la API de Gemini para Google Cloud habilitada, 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 de tu proyecto. Para obtener más información, consulta Cómo configurar Gemini Code Assist para un proyecto.
Si prefieres seguir la explicación sobre cómo crear código con Gemini Code Assist directamente en tu IDE, haz clic en Launch 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 permitir 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 Gemini para Google Cloud, 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 Gemini Code proyecto.
Selecciona un proyecto de Google Cloud que tenga la API de Gemini para Google Cloud habilitado.
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 de 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 la IDE, haz clic en spark de Gemini Code Assist.
En el panel de Gemini Code Assist, ingresa la instrucción
Explain this code to me
y haz clic en send Enviar.Gemini usa el código de tu archivo de código como referencia para lo siguiente: la instrucción y responde con una explicación de tu código.
Para hacer referencia a un bloque de código específico en lugar de todo el código del archivo, puedes seleccionar el bloque en el archivo de código y, luego, solicitarle a Gemini que lo haga.
Restablecer historial de chat
Gemini Code Assist usa el historial de chat para obtener contexto adicional a la hora de responder tus instrucciones.
Si el historial de chat ya no es relevante para lo que intentas lograr, puedes restablecerlo: en el panel de Gemini Code Assist, haz clic en delete Restablecer chat.
Genera código con instrucciones
En las siguientes secciones, se muestra cómo usar Gemini Code Assist para realizar transformaciones de código, como function to create a Cloud Storage
bucket
, con la barra de selección rápida.
La transformación de código te permite usar comandos o instrucciones de lenguaje natural en la barra de Selección rápida para solicitar modificaciones a tu código y te proporciona una vista de diferencias para mostrar los cambios pendientes en tu código.
También puedes seleccionar una parte del código y, luego, Gemini Code Assist te brinda ayuda a través de Gemini Code Assist y recibir y aceptar o rechazar sugerencias de código mientras escribes.
Cómo indicarle a Gemini Code Assist con la transformación de código
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 la barra de 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 diferencias.
Opcional: Para aceptar estos cambios, haz clic en Aceptar.
Opcional: Instruye 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:
En una línea nueva, ingresa el comentario
Function to create a Cloud Storage bucket
. y, luego, presiona Intro (para Windows y Linux) o Intro. (para macOS).Para generar código, presiona Control+Intro (para Windows y Linux). Control + Retorno (para macOS).
Junto al texto de la instrucción del 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 cambiar la combinación de teclas siguiendo estos pasos: pasos:
En tu IDE, haz clic en File (para Windows y Linux) o Code (para macOS). y, luego, ve a Configuración > Combinaciones de teclas.
En la lista de combinaciones de teclas, desplázate hasta encontrar Cloud Code: Generar código.
Haz clic en Cloud Code: Generar código y, luego, en edit Cambiar la vinculación de teclas
En el cuadro de diálogo que aparece, ingresa tu propia combinación de teclas.
Presiona Intro (para Windows y Linux) o Retorno (para macOS).
Ahora puedes usar la combinación de teclas que acabas de asignar 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.
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:
En la barra de actividades, haz clic en spark Gemini Code Assist para abrir el panel 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 una instrucción 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 que seleccionaste como referencia y responda a tu mensaje.
Obtén sugerencias intercaladas mientras escribes código
Mientras escribes código, Gemini Code Assist crea código intercalado que puedes aceptar o ignorar. Para probar esta función, sigue estos pasos:
En el archivo de código, en una línea nueva, comienza a escribir una función. Por ejemplo, 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. seguir escribiendo tu código.
Opcional: Inhabilita las sugerencias intercaladas
Si prefieres inhabilitar las sugerencias intercaladas en Gemini Code Assist, sigue estos pasos:
En tu IDE, seleccionar Code (para macOS) o File (para Windows y Linux) y, luego, navega a Configuración > Configuración.
En la pestaña User del cuadro de diálogo Settings, navega a Extensions > Cloud Code.
Desplázate hasta encontrar la lista Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Auto y, luego, selecciona Desactivado.
Esto 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.
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 tu archivo de código, sigue estos pasos:
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.
Cuando se aplica la corrección rápida, aparece una vista de diferencias. Para aceptar estos cambios, Haz clic en Aceptar.
Solicita instrucciones con archivos específicos de tu lugar de trabajo mediante reconocimiento de la base de código local.
El conocimiento de la base de código local te ayuda con sugerencias de código de alta calidad que son correctas sintácticamente y significativas semánticamente dentro del contexto más amplio de tu base de código, cuando especificas archivos para que Gemini Code Assist los use como contexto.
Para especificar archivos en tu instrucción de chat, escribe @ y selecciona los archivos que deseas especificar.
Para obtener una explicación sobre las diferencias entre dos archivos de tu base de código, sigue estos pasos:
En la barra de actividades, haz clic en spark Gemini Code Assist.
En el panel de Gemini Code Assist, ingresa la instrucción
Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2
y presiona Intro (para Windows y Linux) o Return (para macOS) o Tab. Puedes también haz clic en el nombre del archivo en la lista para seleccionarlo. Si haces clic en el nombre del archivo, este se agregará al contexto de la instrucción y se abrirá en tu IDE.Gemini Code Assist responde a tu instrucción mientras usa los dos archivos que especificaste para el contexto. Gemini Code Assist también incluye los archivos que especificaste en Fuentes de contexto.
Ahora que especificaste esos archivos, puedes seguir solicitando instrucciones preguntas o instrucciones en el mismo historial de chat, sin tener que especificar la archivos de nuevo.
Por ejemplo, en el panel de Gemini Code Assist, ingresa la instrucción How can I
improve YOUR_FILE_NAME_1?
(sin el símbolo @) y presiona
Intro (para Windows y Linux) o Return (para macOS).
Gemini Code Assist responde tu consulta sobre el archivo que especificadas en tu instrucción.
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
sigue la
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. 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 con voraz en el carácter*
. Esto hará coincidir de forma indiscriminada los directorios y los archivos. Este archivo.aiexclude
no diferencia entre**
o*
en relación con las carpetas o los archivos.
Por el momento, solo se admite un archivo .aiexclude
. Para configurar tu archivo .aiexclude
, crea un archivo titulado .aiexclude
en la raíz de la carpeta de tu lugar de trabajo. Si deseas colocar este archivo fuera de la raíz del lugar de trabajo o cambiarle el nombre, la ruta de acceso se puede establecer en la configuración de VS Code, en “Archivo de exclusión de contexto”. El valor de ruta proporcionado en este parámetro de configuración resolverá
en relación con la carpeta raíz de tu espacio de trabajo abierto.
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/*
Inhabilitar las sugerencias de código que coincidan con las fuentes citadas
Gemini proporciona información de cita cuando cita de forma directa y en detalle una fuente, como el código de código abierto existente. Para ver 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
el parámetro de configuración cloudcode.duetAI.recitation.maxCitedLength
como 0
, en una
Archivo settings.json
:
"cloudcode.duetAI.recitation.maxCitedLength": 0
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 selecciones tu código en el editor de código, podrás ver y elige 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 lightbulb Mostrar acciones de código.
Selecciona una acción, como Generar pruebas de unidades.
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.
Obtener 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 para el que deseas 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 deseas 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 del código, selecciona la parte preferida del código 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 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 modo de inserción.
Cuando usas el complemento Vim en modo normal, no puedes aceptar ni descartar el código. sugerencias.
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, tanto el IDE como Gemini se descartan las sugerencias. Este comportamiento es diferente del comportamiento no de Vim, en el que presionar Esc vuelve a activar Gemini.
Los intentos de acceso se agotan
Si se agota el tiempo de espera de tus intentos de acceso, agrega la
Parámetro de configuración cloudcode.beta.forceOobLogin
para tu archivo settings.json
:
"cloudcode.beta.forceOobLogin": true
Las advertencias de recitación de la licencia no persisten entre sesiones.
Si las advertencias de recitación de la licencia no persisten en las sesiones, consulta los registros persistentes:
Haz clic en Ver >. Resultado:
Selecciona Gemini Code Assist - Citations.
Problemas de conectividad en la ventana de salida de Gemini Code Assist
Si ves un error de conexión u otros problemas 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
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. Si la verificación es correcta, se muestra 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
"Activa 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:
En la barra de estado, haz clic en spark Gemini Code Assist y, luego, selecciona Send feedback.
Haz clic en Mostrar en cualquiera de los archivos de registro para ver más detalles y ayudarte. solucionar el problema.
Enviar comentarios
Para dejar comentarios sobre tu experiencia, sigue estos pasos:
En la barra de estado, haz clic en Gemini Code Assist y, luego, en la pestaña Quick Menú de selección y, luego, 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 la opción Send Skaffold logs o Send AI Companion logs.
Haz clic en Enviar comentarios.
¿Qué sigue?
- Obtén más información para escribir mejores instrucciones.