Crea código con Gemini Code Assist

En este documento, se describe cómo puedes usar Gemini Code Assist, una herramienta potenciada por IA de Google Cloud para que te ayude a hacer lo siguiente en Cloud Code:

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

Este documento está dirigido a desarrolladores de todos los niveles de habilidad. Se supone que tienes conocimientos prácticos de VS Code y conocer 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

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

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

  3. 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 Cloud AI Companion habilitada en tu IDE.

Si seleccionas un proyecto de Google Cloud sin Si habilitas la API de Cloud AI Companion, 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.

Si prefieres seguir el 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 conectarse a Google Cloud y activar Gemini Code Assist

Lanzamiento de VS Code

De lo contrario, sigue estos pasos:

  1. Lanza tu o IDE.

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

    Cloud Code - Botón de acceso en la barra de estado.

  3. Cuando se te solicite permitir que Cloud Code abra el sitio web externo, haz clic en Abrir.

  4. Sigue las indicaciones para acceder a tu Cuenta de Google.

  5. Cuando se te pregunte si descargaste Cloud Code de Google, haz clic en Acceder.

    Ya te conectaste a Google Cloud.

Luego, para seleccionar un proyecto de Google Cloud que tenga la API de Cloud AI Companion. habilitado, sigue estos pasos:

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

    La barra de estado de Gemini está disponible.

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

  3. Selecciona un proyecto de Google Cloud que tenga la Se habilitó la API de Cloud AI Companion.

    Gemini está listo para usarse.

    El ícono de Gemini en la barra de estado se estableció en normal.

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 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 IDE, haz clic en spark de Gemini Code Assist.

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

Restablecer historial de chat

Gemini Code Assist usa el historial de chat para obtener contexto adicional a la hora de responder tus instrucciones.

Si tu historial de chat ya no es relevante para lo que quieres lograr, puedes puedes restablecer el historial de chat: 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 Genera 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). 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.

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

  1. En tu IDE, haz clic en File (para Windows y Linux) o Code (para macOS). y, luego, ve a Configuración > Combinaciones de teclas.

  2. En la lista de combinaciones de teclas, desplázate hasta encontrar Cloud Code: Genera el código.

  3. Haz clic en Cloud Code: Generar código y, luego, en edit Cambiar la vinculación de teclas

  4. En el cuadro de diálogo que aparece, ingresa tu propia combinación de teclas.

  5. 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 quieres obtener más información para cambiar atajos 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 preguntas según el código que selecciones. Para obtener un código generado a partir de un con el código seleccionado, sigue estos pasos:

  1. En la barra de actividades, haz clic en spark. Gemini Code Assist para abrir el panel de 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 escribe una prueba de unidades para una función seleccionada.

    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:

  1. En tu 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 IDE, seleccionar Code (para macOS) o File (para Windows y Linux) y, luego, navega a Configuración > Configuración.

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

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

    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.

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

Gemini proporciona información de citas cuando cita directamente a de otra fuente, como un 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 bombilla 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 Generate unit tests.

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

Cómo probar otros ejemplos de instrucciones

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

Obtén 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 que seleccionaste 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 desees 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 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 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 más pequeña de código e incluye un 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 estén en el 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, IntelliJ y Gemini se descartan las sugerencias. Este comportamiento es diferente del comportamiento comportamiento 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 Parámetro de configuración de cloudcode.beta.forceOobLogin en tu archivo settings.json:

"cloudcode.beta.forceOobLogin": true

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 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 u otros problemas 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 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 incluida la habilitación de la API de Cloud AI Companion, es posible que 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 ayudarte. 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ú Selección rápida Selecciona Enviar comentarios.

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

  3. Si quieres compartir tu Skaffold o AI Companion registros, asegúrate de seleccionar Opción Enviar registros de Skaffold o Enviar registros de AI Companion.

  4. Haz clic en Enviar comentarios.

¿Qué sigue?