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 el editor de base de Cloud Workstations:

• Proporcionar orientación para ayudarte 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 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 Cloud Workstations y que estás familiarizado con Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en Cloud Code para VS Code, Cloud Code para IntelliJ y Editor de Cloud Shell.

Antes de comenzar

1. Asegúrate de tener el rol de administrador de Cloud Workstations Rol de IAM en el proyecto para que puedas crear una estación de trabajo parámetros de configuración.

   Ir a IAM

2. Configuración tu estación de trabajo, si aún no lo has hecho, y asegúrate de Editor básico (Code-OSS) en la configuración.

   Importante: Para usar Gemini Code Assist, debes seleccionar Editor base (Code-OSS) cuando creas la configuración de tu estación de trabajo
3. Antes de probar las funciones de Gemini Code Assist en tu código asegúrate de que el lenguaje de programación sea compatible con tu archivo. Más información sobre lenguajes de programación compatibles, consulta Lenguajes de programación admitidos.

Cómo conectarse a Google Cloud y seleccionar 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 estación de trabajo.

Si seleccionas un proyecto de Google Cloud sin Si habilitas la API de Gemini para Google Cloud, recibirás una notificación la opción para habilitar la API desde el IDE. Selecciona Habilitar la API 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.

Sugerencia: Puedes definir el entorno GEMINI_DEFAULT_PROJECT variable en la configuración de tu estación de trabajo para establecer automáticamente la Proyecto de la API de Gemini para Google Cloud en todas las estaciones de trabajo.

Para conectarte a Google Cloud en tu estación de trabajo, sigue estos pasos:

1. En la consola de Google Cloud, inicia tu estación de trabajo.

   Inicia la estación de trabajo.

2. En la barra de estado, haz clic en Cloud Code - Acceder.

   

3. Cuando se te solicite que accedas, haz clic en Proceed to sign in.

4. Para iniciar el flujo de acceso de Google Cloud, presiona Control (para Windows y Linux) o Comando (para macOS) y haz clic en la URL en la consola.

5. Si se te solicita permitir que Cloud Workstations abra el sitio web externo, haz clic en Abrir.

6. Para acceder a tu cuenta, sigue las indicaciones.

   Si se te solicita que te asegures de haber descargado esta app de Google, haz clic en Acceder.

   Se abrirá una pestaña nueva en tu navegador que mostrará tu código de verificación para acceder a Cloud Code.

7. Copia el código de verificación y pégalo en la terminal donde dice Enter authorization code y, luego, presiona Intro (para Windows y Linux) o Volver (para macOS).

   Ya te conectaste a Google Cloud.

A continuación, para seleccionar un proyecto de Google Cloud que tenga la API de Gemini para Google Cloud habilitado, sigue estos pasos:

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

   

2. En el menú Gemini Code Assist, selecciona Seleccionar proyecto de Gemini Code.

3. Selecciona un proyecto de Google Cloud que tenga habilitada la API de Gemini para Google Cloud.

   Gemini está listo para usarse.

   

Chatea con Gemini Code Assist

Como tecnología en etapa inicial, los productos de Gemini para Google Cloud pueden generar resultados que parecen posibles, pero que no son correctos. Te recomendamos validar todos los resultados de Gemini para los productos de Google Cloud antes de usarlos. Para obtener más información, consulta Gemini para Google Cloud y la IA responsable.

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 código.

Para comenzar a chatear con Gemini, sigue estos pasos:

1. Abre el archivo de código.

2. En la barra de actividades de la estación de trabajo, haz clic en spark de Gemini Code Assist.

3. 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 a tu 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 al código del archivo, puedes puedes seleccionar el bloque de tu archivo de código y, luego, indicarle a Gemini.

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

Nota: El historial de chat se restablece automáticamente cuando cambias de espacio de trabajo o sales de tu estación de trabajo.

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, solicitar ayuda a Gemini Code Assist a través de la función de chat recibir y aceptar o rechazar sugerencias de código mientras escribes.

Cómo indicarle a Gemini Code Assist en un archivo de código

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

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.

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:

1. En tu estación de trabajo, haz clic en menú Menú y, a continuación, ve a Archivo > Preferencias > Combinaciones de teclas.

2. En la lista de combinaciones de teclas, busca Cloud Code: Generate Code.

3. Haz clic en Cloud Code: 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.

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

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

3. 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 seleccionado como referencia y responde a tu instrucción.

Obtén sugerencias intercaladas mientras escribes código

Mientras escribes código, Gemini Code Assist te ofrece sugerencias de código intercaladas que puedes aceptar o ignorar. Para probar esta función, sigue estos pasos:

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

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

1. En tu estación de trabajo, selecciona menú Menu y, luego, navega a File > Preferences > Settings.

2. En la pestaña User del cuadro de diálogo Settings, navega a Extensions > Cloud Code.

3. Desplázate hasta encontrar Cloudcode: Gemini Code Assist: Inline Suggestions: Enable Lista automática y, luego, selecciona Desactivar.

   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.

Cómo solicitar archivos específicos en tu lugar de trabajo con conocimiento de la base de código local

El reconocimiento de la base de código local te ayuda con sugerencias de código de alta calidad sintácticamente correcta y semánticamente significativo en el contexto más amplio de tu base de código, cuando especificas archivos para que Gemini Code Assist haga lo siguiente usar 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 de dos archivos en tu base de código, sigue estos pasos: estos pasos:

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

2. 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. También puedes hacer clic en el nombre del archivo de 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 ambos los 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 Gemini Code Assist, ingresa el mensaje How can I improve YOUR_FILE_NAME_1? (sin el símbolo @) y presiona Intro (para Windows y Linux) o Retorno (para macOS).

Gemini Code Assist responde tu consulta sobre el archivo que especificadas en tu instrucción.

Nota: Si borras tu historial de chat, Gemini Code Assist no usa tus archivos para dar contexto y debes volver a especificarlos en el chat con el símbolo @ si quieres realizar más consultas sobre el .

Opcional: Excluye archivos del contexto con un archivo .aiExclude

Puedes excluir archivos para que Gemini Code Assist no los considere para obtener contexto creando 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 el que se colocan el prefijo a los patrones con un signo de exclamación (!).
• Un archivo .aiexclude coincide de manera codiciosa con 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 .aiexclude, crea un archivo titulado .aiexclude en la raíz de tu Workspace. Si quieres colocar este archivo fuera de la raíz del espacio de trabajo, o cambiarle el nombre al archivo, puedes establecer la ruta de acceso 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 con el nombre apikeys.txt en el directorio del lugar 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 los subdirectorios:

  /apikeys.txt
  

• Bloquea todos los archivos en el 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

Usa acciones inteligentes

Para ayudarte a ser más productivo y, al mismo tiempo, minimizar el cambio de contexto, Gemini Code Assist proporciona directamente acciones inteligentes potenciadas por IA 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:

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.

   

3. Selecciona una acción, como Generate unit tests.

   Gemini genera una respuesta que se basa en la acción que seleccionaste.

Versión preliminar: Usa transformaciones de código

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Gemini Code Assist proporciona transformaciones de código, que te permiten seleccionar una parte de tu archivo de código y solicitar modificaciones en tu código existente a través de instrucciones en lenguaje natural, con un cuadro de texto intercalado.

Con las transformaciones de código, puedes hacer lo siguiente:

• Genera líneas de comentarios para documentar tu código
• Soluciona problemas relacionados con el código
• Mejora la legibilidad del código
• Cómo hacer que el código sea más eficiente

También puedes ver las fuentes de contexto de una respuesta generada en Gemini: Chat.

Cómo solicitar Gemini Code Assist con el cuadro de texto intercalado

El cuadro de texto intercalado te permite interactuar con Gemini Code Assist directamente en tu archivo de código

Para abrir el cuadro de texto intercalado y solicitar Gemini, sigue estos pasos:

1. En el archivo de código, presiona Control + I (para Windows y Linux) o Comando + I (para macOS).

2. Ingresa un mensaje, como Write a function to create a Cloud Storage bucket, y presiona Intro (para Windows y Linux) o Retorno (para macOS).

   Gemini Code Assist genera el código en función de tu instrucción.

Ver la diferencia del código refactorizado

Con la vista de diferencias integrada en el cuadro de texto intercalado, puedes ver los cambios que Gemini sugiere y tu código original. Luego, puedes aceptar o descartar los cambios sugeridos.

Para ver la diferencia del código refactorizado desde el cuadro de texto intercalado, sigue estos pasos:

1. En tu archivo de código, selecciona una función y abre el cuadro de texto intercalado presionando las teclas Control + I (para Windows y Linux) o Comando + I (para macOS).

2. Ingresa un mensaje, como Add comments, y presiona Intro (para Windows y Linux) o Retorno (para macOS).

   Cuando Gemini genera los cambios de código en la función selecionada, aparece la vista de diferencias.

   

3. Para aceptar o descartar los cambios, haz clic en Aceptar o Descartar.

Cómo ver las fuentes de contexto de una respuesta generada

La función de pantalla de contexto enumera los archivos de tu proyecto (las fuentes de contexto). que se usaron como referencia para generar respuestas a tus instrucciones. Saber cuál archivos usados como referencia te ayuda a definir mejor tus instrucciones y a obtener más respuestas específicas. Se muestran fuentes de contexto cada vez que usas chat de Gemini.

Para ver las fuentes de contexto de la respuesta generada, en Gemini: Chat desplázate hasta que veas el fragmento Context Sources. Expandir el fragmento para ver todas las fuentes de contexto.

Cómo usar los Comandos inteligentes

Los comandos inteligentes son comandos que puedes usar en el cuadro de texto intercalado para realizar acciones específicas en tu código.

Para obtener una explicación de todo el archivo de código con el comando inteligente /explain, sigue estos pasos:

1. En el archivo de código, presiona Control + I para abrir el cuadro de texto intercalado. (para Windows y Linux) o Command + I (para macOS).

2. Presiona / para ver la lista de comandos inteligentes y sus descripciones.

3. Selecciona /explain.

   Gemini genera una explicación de todo el archivo de código en el cuadro de texto intercalado.

4. Opcional: Si quieres ver la respuesta generada en el panel Gemini: Chat, haz clic en Ver en Chat.

Cómo ver el historial de instrucciones

Acceder al historial de instrucciones te ahorra tiempo cuando necesitas ingresar las mismas instrucciones en un archivo de código grande.

Para acceder al historial de instrucciones, en el archivo de código, abre el cuadro de texto intercalado. Para ello, haz lo siguiente: presionar Control + I (para Windows y Linux) o Comando + I (para macOS) y, luego, presiona Control + flecha hacia arriba (para Windows y Linux) o Comando + flecha hacia arriba (para macOS). Esto te permite alternar entre tus instrucciones anteriores y reutilizarlas cuando sea necesario.

Mejora la legibilidad del código para hablantes no nativos de inglés

Si no hablas inglés de tu idioma y usas aplicaciones de traducción, puedes usar el cuadro de texto intercalado para generar comentarios en otros idiomas.

Para convertir comentarios en inglés a otro idioma o agregar comentarios nuevos en otro idioma, sigue estos pasos:

1. En el archivo de código, selecciona el código al que deseas agregar comentarios.

2. Abre el cuadro de texto intercalado presionando Control + I (para Windows y Linux) o Comando + I (para macOS).

3. Ingresa un mensaje, como Add spanish comments, y presiona Intro (para Windows y Linux) o Retorno (para macOS).

   Gemini genera comentarios en el idioma que especificaste. en la instrucción y ve las diferencias de estas sugerencias.

4. Para aceptar o descartar estos cambios de tu código, haz clic en Aceptar. Descartar.

Prueba otras instrucciones de ejemplo

Después de leer las En la sección Generate code with prompts, documento, prueba algunas de las siguientes instrucciones de ejemplo.

Obtener una explicación del código

1. En el archivo de código, selecciona una función que quieras explicar.

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

1. En el archivo de código, selecciona el código al que desees agregar pruebas de unidades.
2. 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

1. En el archivo de código, selecciona el código que deseas depurar.
2. 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

1. En el archivo de código, selecciona el código que deseas que sea más legible.

2. 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 la parte que prefieras antes de solicitarle a Gemini que la analice.

Problemas conocidos

En las siguientes secciones, se describen los problemas conocidos Gemini Code Assist

Las advertencias de consulta de licencias no persisten en las sesiones

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

1. Haz clic en el menú Menú > Ver. > Salida.

2. Selecciona Gemini Code Assist - Citas.

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 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 de grpc-health-probe para probar la conectividad. Se completó correctamente la verificación 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 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

Gemini Code Assist y JetBrains Gateway

Gemini Code Assist no se ejecuta a través de JetBrains Gateway. Como resultado, Gemini Code Assist no se ejecuta en los IDE de Cloud Workstations que requieren la puerta de enlace de JetBrains para conectarse.

"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 de Google Cloud, incluida la habilitación de la API de Gemini para Google Cloud, un problema con el servidor 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.

Enviar comentarios

Para dejar comentarios sobre tu experiencia, sigue estos pasos:

1. En la barra de estado, haz clic en 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.

¿Qué sigue?

• Obtén más información para escribir mejores instrucciones.