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
Configure Gemini Code Assist Standard o Enterprise , si aún no lo ha hecho.
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 .
Si prefiere utilizar su IDE detrás de un proxy, consulte Conexiones de red en Visual Studio Code .
IntelliJ
Configure Gemini Code Assist Standard o Enterprise , si aún no lo ha hecho.
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 .
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:
Abra su archivo de código.
En la barra de actividades de su IDE, haga clic en spark Gemini Code Assist .
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:
En su IDE, abra su archivo de código.
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.
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 .
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
- 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.
- 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.
- 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:
Vaya a Configuración > Extensiones > Gemini Code Assist .
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 :
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
En la barra de actividades, haga clic en spark Gemini Code Assist para abrir el panel Gemini Code Assist .
En su archivo de código, seleccione un bloque de código.
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
En la barra de actividades, haga clic en Spark Gemini Code Assist para abrir la ventana de herramientas Gemini Code Assist .
En su archivo de código, seleccione un bloque de código.
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.
Para obtener una explicación de las diferencias entre dos archivos en su base de código, siga estos pasos:
En la barra de actividades, haga clic en spark Gemini Code Assist .
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.
Para obtener una explicación de las diferencias entre dos archivos en su base de código, siga estos pasos:
En la barra de actividades, haga clic en spark Gemini Code Assist .
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
En la barra de actividades de su IDE, haga clic en spark Gemini Code Assist .
Para ver los archivos y carpetas en su Cajón de contexto, haga clic en Elementos de contexto .
Para eliminar elementos del Cajón de contexto, haga clic close Eliminar .
IntelliJ
En la barra de actividades, haga clic en spark Gemini Code Assist.
Para ver los archivos y carpetas en su Cajón de contexto, haga clic en Contexto .
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
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 .
En el menú, busque y seleccione Preferencias: Abrir Configuración (IU) .
En el campo Configuración de búsqueda , ingrese
Geminicodeassist: Custom Commands
.En el cuadro Comandos personalizados , seleccione Agregar elemento .
En el campo Elemento , ingrese
add-comments
como nombre del comando.En el campo Valor , ingrese
add comments to all functions without comments in my code
como se indica en el mensaje.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
En su IDE, navegue a Configuración > Herramientas > Gemini > Biblioteca de indicaciones .
En la ventana Biblioteca de indicaciones , haga clic en add Agregar .
Nombre su comando personalizado
add-comments
.En el cuadro de texto de la Biblioteca de indicaciones, ingrese la indicación:
Add comments to all functions without comments in this code
.Seleccione la casilla de verificación Mostrar en el aviso del editor si no está seleccionada.
Haga clic en Aceptar para guardar el comando personalizado en la Biblioteca de indicaciones.
En el archivo de código, resalte el código que desea modificar.
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:
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 .
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
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 .
En el menú, busque y seleccione Preferencias: Abrir Configuración (IU) .
En el campo Configuración de búsqueda , ingrese
Geminicodeassist: Rules
.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 archivosettings.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:
Haga clic en Ver > Salida .
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
ycloudaicompanion.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:
En la barra de estado, haga clic en spark Gemini Code Assist y luego seleccione Enviar comentarios .
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
En la barra de estado, haga clic en spark Gemini Code Assist y, luego, en el menú Selección rápida , seleccione Enviar comentarios .
En el formulario, rellene los campos Título y Comentarios .
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 .
Haga clic en Enviar comentarios .
IntelliJ
En la barra de estado, haga clic en spark Gemini Code Assist y, luego, en el menú, seleccione Enviar comentarios .
En el campo de texto en la parte superior del formulario, ingrese sus comentarios.
Si desea compartir sus registros de Gemini Code Assist, asegúrese de seleccionar los archivos de registro.
Haga clic en Enviar comentarios .
¿Qué sigue?
- Aprenda a escribir mejores indicaciones .
- Descubre cómo funciona Géminis Google Cloud utiliza sus datos
- Obtenga más información sobre los precios de Gemini Code Assist .
- Obtenga más información sobre Google Cloud cumplimiento .