Chatea con Gemini Code Assist Standard y Enterprise

Este documento describe cómo puede utilizar Gemini Code Assist Standard y Enterprise, un colaborador impulsado por IA en su IDE, para ayudarlo a hacer lo siguiente en VS Code o IntelliJ y otros IDE de JetBrains compatibles :

  • Reciba orientación para ayudarle a resolver problemas con su código.
  • Genera código para tu proyecto.
  • Administre el contexto de su proyecto especificando archivos y carpetas.
  • Crea comandos y reglas personalizados.

La personalización de código te permite obtener sugerencias basadas en la base de código privada de tu organización directamente desde Gemini Code Assist Enterprise. Aprende a configurar la personalización de código .

Este documento está dirigido a desarrolladores de todos los niveles. Se asume que tiene conocimientos prácticos de VS Code o IntelliJ y otros IDE compatibles con JetBrains, y que está familiarizado con Google CloudSi lo prefieres, también puedes explorar Gemini Code Assist en Cloud Shell Editor , Cloud Workstations y Android Studio .

Antes de empezar

Código VS

  1. Configure Gemini Code Assist Standard o Enterprise , si aún no lo ha hecho.

  2. Antes de probar las funciones de Gemini Code Assist en su archivo de código, asegúrese de que el lenguaje de codificación sea compatible. Para obtener más información sobre los lenguajes de codificación compatibles, consulte Lenguajes de codificación compatibles .

  3. Si prefiere utilizar su IDE detrás de un proxy, consulte Conexiones de red en Visual Studio Code .

IntelliJ

  1. Configure Gemini Code Assist Standard o Enterprise , si aún no lo ha hecho.

  2. Antes de probar las funciones de Gemini Code Assist en su archivo de código, asegúrese de que el lenguaje de codificación sea compatible. Para obtener más información sobre los lenguajes de codificación compatibles, consulte Lenguajes de codificación compatibles .

  3. Si prefiere utilizar su IDE detrás de un proxy, consulte Proxy HTTP .

Utilice el chat de Gemini Code Assist para explicar su código

En esta sección, le solicita a Gemini Code Assist que proporcione una explicación de su código existente.

Código VS

Para obtener una explicación de su código, siga estos pasos:

  1. Abra su archivo de código.

  2. En la barra de actividades de su IDE, haga clic en spark Gemini Code Assist .

  3. En el panel de asistencia de Gemini Code , ingrese el mensaje Explain this code to me y haga clic en send Enviar .

    Gemini Code Assist utiliza el código de su archivo de código como referencia a su solicitud y responde con una explicación de su código.

    Para hacer referencia a un bloque de código específico en lugar de a todo el código del archivo, puede seleccionar el bloque en su archivo de código y luego solicitar Gemini Code Assist.

IntelliJ

Para obtener una explicación de su código, siga estos pasos:

  1. En su IDE, abra su archivo de código.

  2. En la ventana de la herramienta Gemini Code Assist, ingrese el mensaje Explain this code to me y haga clic en Enviar .

Gemini Code Assist utiliza el código de su archivo de código como referencia a su solicitud y responde con una explicación de su código.

Si solo desea una explicación de una parte específica de su código, puede seleccionarlo y volver a solicitarle ayuda a Gemini Code Assist. Gemini Code Assist solo usará el código seleccionado como referencia para la respuesta generada.

Cuando Gemini Code Assist le proporciona código en su respuesta, puede seleccionar las siguientes opciones que aparecen al final de su respuesta:

  • Insertar en el cursor : inserta el código generado en el archivo actual en la posición actual del cursor.

  • Insertar en nuevo archivo : abre un nuevo archivo e inserta el código generado en el nuevo archivo.

    Gemini enumera las acciones del código al final de una respuesta de código generada.

Estas opciones están disponibles cuando Gemini Code Assist identifica el idioma utilizado en su bloque de código y si este idioma es compatible con su IDE actual.

Ver historial de consultas

Si desea volver a utilizar sus indicaciones anteriores, puede encontrarlas en su Historial de consultas en la ventana de la herramienta Gemini Code Assist haciendo clic en schedule Mostrar historial de consultas .

Historial de consultas de Gemini en la ventana de herramientas.

Crear múltiples chats

Puedes crear varios chats con Gemini Code Assist, cada uno con su propio contexto, separado de los demás. Tu historial de chats muestra tu primer chat y la fecha y hora de la última actualización. Hay un límite de 20 chats. Una vez alcanzado este límite, el chat más antiguo se elimina automáticamente al añadir uno nuevo.

Código VS

  1. Para agregar un nuevo chat, haz clic en "Agregar nuevo chat" e introduce tu mensaje en el campo de texto. Después de introducirlo, Gemini Code Assist creará el nuevo chat.
  2. Para acceder a tu chat anterior, haz clic en Historial > Reanudar chat anterior . Aparecerá una lista de tus chats. Selecciona el chat que quieras ver.
  3. Para eliminar un hilo de chat, haga clic en Reanudar chat anterior y luego haga clic en Eliminar junto al chat que desea eliminar.

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains compatibles en este momento.

Restablecer el historial de chat

Gemini Code Assist usa el historial de chat para obtener más contexto al responder a tus indicaciones. Si tu historial de chat ya no es relevante para lo que intentas lograr, puedes restablecerlo .

Administra tu chat

Puedes administrar la configuración de chat de Gemini Code Assist haciendo lo siguiente:

Configurar el desplazamiento automático

Código VS

De forma predeterminada, Gemini Code Assist se desplaza automáticamente por el chat. Para desactivar este comportamiento, realice lo siguiente:

  1. Vaya a Configuración > Extensiones > Gemini Code Assist .

  2. Busque la configuración de Desplazamiento automático y desmarque la casilla de verificación.

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.

Detener el chat en curso

Código VS

Puedes detener una respuesta de chat en curso presionando detener Detener :

Botón para detener la respuesta del chat en curso de Gemini Code Assist

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains.

Ayuda rápida con el código Gemini con el código seleccionado mediante el chat

Gemini Code Assist puede realizar tareas o responder a tus preguntas según el código que selecciones. Para generar el código según una solicitud con el código seleccionado, sigue estos pasos:

Código VS

  1. En la barra de actividades, haga clic en spark Gemini Code Assist para abrir el panel Gemini Code Assist .

  2. En su archivo de código, seleccione un bloque de código.

  3. En el campo de texto del panel Gemini Code Assist , ingrese una solicitud para el código seleccionado.

    Por ejemplo, seleccione una función en su código e ingrese el mensaje Write a unit test for this function .

    Gemini utiliza el código seleccionado como referencia y responde a tu solicitud.

IntelliJ

  1. En la barra de actividades, haga clic en Spark Gemini Code Assist para abrir la ventana de herramientas Gemini Code Assist .

  2. En su archivo de código, seleccione un bloque de código.

  3. En el campo de texto de la ventana de la herramienta Gemini Code Assist , ingrese una solicitud para el código seleccionado.

    Por ejemplo, seleccione una función en su código e ingrese el mensaje Write a unit test for this function.

    Gemini Code Assist utiliza el código seleccionado como referencia y responde a su solicitud.

Solicitar archivos y carpetas específicos en su espacio de trabajo con conocimiento de la base de código local

El conocimiento de la base de código local le ayuda a obtener sugerencias de código de alta calidad que son sintácticamente correctas y semánticamente significativas dentro del contexto más amplio de su base de código, cuando especifica archivos o carpetas para que Gemini Code Assist los use como contexto.

Cuando especifica una carpeta, Gemini Code Assist utiliza los archivos de la carpeta así como los archivos de las subcarpetas como contexto.

Código VS

Para especificar archivos o carpetas en el mensaje de chat, escriba @ y seleccione el archivo o la carpeta que desea especificar.

Especifique archivos y carpetas con reconocimiento de base de código local para VS Code.

Para obtener una explicación de las diferencias entre dos archivos en su base de código, siga estos pasos:

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

  2. En el panel Gemini Code Assist , introduzca la indicación Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 y pulse Intro (para Windows y Linux), Retorno (para macOS) o Tabulador . También puede hacer clic en el nombre del archivo en la lista para seleccionarlo. Al hacer clic en el nombre del archivo, este se añade al contexto de la indicación y se abre en el IDE.

Gemini Code Assist responde a tu solicitud 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 ha especificado esos archivos, puede continuar haciendo preguntas o indicaciones adicionales en el mismo historial de chat, sin tener que especificar los archivos nuevamente.

Por ejemplo: en el panel Gemini Code Assist , ingrese el mensaje How can I improve YOUR_FILE_NAME_1? (sin el símbolo @ ) y presione Entrar (para Windows y Linux) o Retorno (para macOS).

Gemini Code Assist responde a su consulta sobre el archivo que especificó en su solicitud.

IntelliJ

Para especificar archivos o carpetas en el mensaje de chat, escriba @ y seleccione los archivos o carpetas que desea especificar.

Especifique archivos con reconocimiento de base de código local para IntelliJ.

Para obtener una explicación de las diferencias entre dos archivos en su base de código, siga estos pasos:

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

  2. En el panel Gemini Code Assist , introduzca la indicación Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 y pulse Intro (para Windows y Linux), Retorno (para macOS) o Tabulador . También puede hacer clic en el nombre del archivo en la lista para seleccionarlo. Al hacer clic en el nombre del archivo, este se añade al contexto de la indicación y se abre en el IDE.

Gemini Code Assist responde a tu solicitud 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 ha especificado esos archivos, puede continuar haciendo preguntas o indicaciones adicionales en el mismo historial de chat, sin tener que especificarlos nuevamente.

Por ejemplo: en el panel Gemini Code Assist , ingrese el mensaje How can I improve YOUR_FILE_NAME_1? (sin el símbolo @ ) y presione Entrar (para Windows y Linux) o Retorno (para macOS).

Gemini Code Assist responde a su consulta sobre el archivo que especificó en su solicitud.

Administrar archivos y carpetas en el cajón de contexto

Después de especificar un archivo o carpeta que se utilizará como contexto para sus indicaciones de Gemini Code Assist , estos archivos y carpetas se colocan en el Cajón de contexto , donde puede verlos y eliminarlos del contexto de la indicación.

Para administrar los archivos y carpetas en su cajón de contexto, realice las siguientes tareas:

Código VS

  1. En la barra de actividades de su IDE, haga clic en spark Gemini Code Assist .

  2. Para ver los archivos y carpetas en su Cajón de contexto, haga clic en Elementos de contexto .

    Cajón de contexto para Gemini Code Assist para VS Code

  3. Para eliminar elementos del Cajón de contexto, haga clic close Eliminar .

IntelliJ

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

  2. Para ver los archivos y carpetas en su Cajón de contexto, haga clic en Contexto .

    Cajón de contexto para Gemini Code Assist para IntelliJ

  3. Para eliminar archivos y carpetas del Cajón de contexto, haga clic close Eliminar .

Excluir archivos del contexto local

De forma predeterminada, Gemini Code Assist excluye los archivos del uso local en el contexto de finalización de código, generación de código, transformación de código y chat si los archivos se especifican en un archivo .aiexclude o .gitignore .

Para saber cómo excluir archivos del uso local, consulte Excluir archivos del uso de Gemini Code Assist .

Crear comandos personalizados

De forma predeterminada, Gemini Code Assist proporciona comandos como /generate para VS Code y Generate Code para IntelliJ y otros IDE compatibles con JetBrains . También puedes crear tus propios comandos personalizados para completar tareas repetitivas más rápidamente en tu IDE.

En esta sección, creará un comando personalizado llamado add-comments , que añade comentarios al código de su archivo. Para IntelliJ y otros IDE de JetBrains compatibles, creará, guardará y ejecutará el comando personalizado desde la biblioteca de indicaciones y desde la indicación del editor.

Código VS

  1. En su archivo de código, presione Control+I (para Windows y Linux) o Comando+I (para macOS) para abrir el menú de selección rápida de Gemini Code Assist .

  2. En el menú, busque y seleccione Preferencias: Abrir Configuración (IU) .

  3. En el campo Configuración de búsqueda , ingrese Geminicodeassist: Custom Commands .

  4. En el cuadro Comandos personalizados , seleccione Agregar elemento .

  5. En el campo Elemento , ingrese add-comments como nombre del comando.

  6. En el campo Valor , ingrese add comments to all functions without comments in my code como se indica en el mensaje.

  7. Haga clic en Aceptar .

Ahora puede usar el comando personalizado add-comments en su IDE. El comando aparece en la lista de comandos del menú de selección rápida de Gemini Code Assist ( Control+I (para Windows y Linux) o Comando+I (para macOS)).

IntelliJ

  1. En su IDE, navegue a Configuración > Herramientas > Gemini > Biblioteca de indicaciones .

    Biblioteca de indicaciones para IntelliJ Gemini Code Assist

  2. En la ventana Biblioteca de indicaciones , haga clic en add Agregar .

  3. Nombre su comando personalizado add-comments .

  4. En el cuadro de texto de la Biblioteca de indicaciones, ingrese la indicación: Add comments to all functions without comments in this code .

  5. Seleccione la casilla de verificación Mostrar en el aviso del editor si no está seleccionada.

  6. Haga clic en Aceptar para guardar el comando personalizado en la Biblioteca de indicaciones.

  7. En el archivo de código, resalte el código que desea modificar.

  8. Haga clic con el botón derecho en el código resaltado y navegue a Gemini > Biblioteca de indicaciones y luego seleccione el comando personalizado add-comments .

    Gemini Code Assist ejecuta el comando add-comments y agrega comentarios al código resaltado.

También puede invocar el comando personalizado con el indicador del editor realizando las siguientes tareas:

  1. En el archivo de código, resalte el código que desea modificar y presione Alt+\ (para Windows y Linux) o Cmd+\ (para macOS) para abrir el menú de selección rápida de Gemini Code Assist .

  2. En el menú, seleccione su comando personalizado add-comments .

    Gemini Code Assist ejecuta el comando add-comments y agrega comentarios al código resaltado.

Crear reglas

Puedes crear reglas para que Gemini Code Assist las siga, y las reglas se incluyen en cada mensaje de chat que ingresas.

Código VS

  1. En su archivo de código, presione Control+I (para Windows y Linux) o Comando+I (para macOS) para abrir el menú de selección rápida de Gemini Code Assist .

  2. En el menú, busque y seleccione Preferencias: Abrir Configuración (IU) .

  3. En el campo Configuración de búsqueda , ingrese Geminicodeassist: Rules .

  4. En el campo de texto, introduzca una regla como: Always generate unit tests when creating a new function . También puede agregar una o más reglas con varias líneas en el campo de texto.

    Después de agregar reglas en la configuración de Reglas, Gemini Code Assist considera la regla para cada indicación o solicitud que realice.

    Para eliminar la regla, elimine el contenido del campo de texto Reglas.

IntelliJ

Esta función no es compatible con Gemini Code Assist para IntelliJ y otros IDE de JetBrains compatibles en este momento.

Problemas conocidos

En esta sección se describen los problemas conocidos de Gemini Code Assist:

Código VS

  • Las respuestas del chat pueden truncarse cuando incluyen una versión actualizada de un archivo abierto grande

    Para solucionar este problema, seleccione una sección de código más pequeña e incluya una directiva adicional en el mensaje de chat, como por ejemplo only output the selected code.

  • Vim: No se pueden aceptar ni rechazar sugerencias de generación de código a menos que esté en modo de inserción

    Al utilizar el complemento Vim en modo normal, no puedes aceptar ni rechazar sugerencias de código.

    Para solucionar este problema, presione i para ingresar al modo de inserción y luego presione Tab para aceptar la sugerencia.

  • Vim: Comportamiento inconsistente al presionar Esc para descartar sugerencias

    Al presionar Esc , se descartan las sugerencias del IDE y de Gemini Code Assist. Este comportamiento es diferente al comportamiento sin Vim, donde al presionar Esc se reactiva Gemini Code Assist.

  • Los intentos de inicio de sesión siguen agotando el tiempo

    Si sus intentos de inicio de sesión siguen agotando el tiempo de espera, intente agregar la configuración cloudcode.beta.forceOobLogin a su archivo settings.json :

     "cloudcode.beta.forceOobLogin": true
    
  • Las advertencias de recitación de licencias no persisten entre sesiones

    Si las advertencias de recitación de licencia no persisten entre sesiones, consulte los registros persistentes:

    1. Haga clic en Ver > Salida .

    2. Seleccione Gemini Code Assist - Citas .

  • Problemas de conectividad en la ventana de salida de Gemini Code Assist

    Si ve un error de conexión u otros problemas de conectividad en la ventana de salida de Gemini Code Assist, intente lo siguiente:

    • Configure su firewall para permitir el acceso a oauth2.googleapis.com y cloudaicompanion.googleapis.com .

    • Configure su firewall para permitir la comunicación a través de HTTP/2, que utiliza gRPC.

    Puede usar la herramienta grpc-health-probe para probar la conectividad. Una comprobació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

    Una verificación fallida da como resultado el siguiente resultado:

    timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

    Para obtener más detalles, ejecute lo siguiente antes de grpc-health-probe :

    export GRPC_GO_LOG_SEVERITY_LEVEL=info
    
  • 'Activar Gemini Code Assist' todavía aparece después de seleccionar el proyecto Gemini Code Assist

    Si seleccionó su proyecto según las instrucciones de esta guía, que incluye la habilitación de la API de Gemini para Google Cloud, es posible que haya un problema con el servidor LS.

    Para obtener más detalles sobre su problema, realice las siguientes acciones:

    1. En la barra de estado, haga clic en spark Gemini Code Assist y luego seleccione Enviar comentarios .

    2. Haga clic en Mostrar cualquiera de los archivos de registro para ver más detalles y ayudar a solucionar el problema.

IntelliJ

No hay problemas conocidos para Gemini Code Assist para IntelliJ y otros IDE de JetBrains compatibles.

Deja un comentario

Para dejar un comentario sobre tu experiencia sigue estos pasos:

Código VS

  1. En la barra de estado, haga clic en spark Gemini Code Assist y, luego, en el menú Selección rápida , seleccione Enviar comentarios .

  2. En el formulario, rellene los campos Título y Comentarios .

  3. Si desea compartir sus registros de Skaffold o AI Companion, asegúrese de seleccionar la opción Enviar registros de Skaffold o Enviar registros de AI Companion .

  4. Haga clic en Enviar comentarios .

IntelliJ

  1. En la barra de estado, haga clic en spark Gemini Code Assist y, luego, en el menú, seleccione Enviar comentarios .

  2. En el campo de texto en la parte superior del formulario, ingrese sus comentarios.

  3. Si desea compartir sus registros de Gemini Code Assist, asegúrese de seleccionar los archivos de registro.

  4. Haga clic en Enviar comentarios .

¿Qué sigue?