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 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 conocimiento práctico de en el editor de Cloud Shell y estás familiarizado con Google Cloud. Si lo prefieres, también puedes explorar Gemini Code Assist en Cloud Workstations Cloud Code para IntelliJ y Cloud Code para VS Code.
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 el editor de Cloud Shell.
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.
Para conectarte a Google Cloud en el editor de Cloud Shell, sigue estos pasos:
Si usas el editor heredado, haz clic en Probar el nuevo editor.
En la barra de estado, haz clic en Cloud Code - Acceder.
Si se te solicita que autorices al editor de Cloud Shell para que realice llamadas a la API de Google Cloud, haz clic en Autorizar.
Sigue las indicaciones para acceder a tu Cuenta de Google.
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:
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 habilitada la API de Gemini para Google Cloud.
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 código.
Para comenzar a chatear con Gemini, sigue estos pasos:
Abre el archivo de código.
En la barra de actividades del Editor de Cloud Shell, haz clic en spark Gemini Code Assist.
En el panel de Gemini Code Assist, ingresa la instrucción
Explain this code to mey 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 todo el código del archivo, puedes seleccionar el bloque en el archivo de código y, luego, solicitarle a Gemini que lo haga.
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.
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
En una línea nueva del archivo de código, ingresa el comentario
Function to create a Cloud Storage buckety, luego, presiona Intro (para Windows y Linux). o Return (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 el editor de Cloud Shell, haz clic en menu Menú y, luego, navega a File > Preferences > Keyboard Shortcuts.
En la lista de combinaciones de teclas, busca Cloud Code: Generate Code.
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
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 un código generado a partir de un con el 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 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 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.
Para aceptar la sugerencia de código de Gemini Code Assist, presiona Tab. De lo contrario, para ignorar la sugerencia, presiona Esc o continúa escribiendo el código.
Opcional: Inhabilita las sugerencias intercaladas
Si prefieres inhabilitar las sugerencias intercaladas en Gemini Code Assist, sigue estos pasos:
En el editor de Cloud Shell, seleccionar menu Menú y, luego, navega a Archivo > Preferencias > 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.
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 sigue la
una sintaxis similar a la de un archivo .gitignore, con las siguientes diferencias:
- Un archivo
.aiexcludevacío o inexistente no bloquea ningún archivo en su directorio. en todos los subdirectorios. - Un archivo
.aiexcludeno admite la negación, en la que se antepone un signo de exclamación (!) a los patrones. - Un archivo
.aiexcludecoincide de manera codiciosa con el carácter*. Esto coincidirá indiscriminadamente en directorios y archivos. Este archivo.aiexcludeno diferenciar entre**o*con respecto a las carpetas o los archivos
Actualmente, solo se admite un solo 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 renombrar el archivo, 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 se 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.txten el directorio del espacio de trabajo o debajo de él:apikeys.txtBloquea todos los archivos con la extensión de archivo
.keyen el espacio de trabajo o debajo de él directorio:*.keyBloquea solo el archivo apikeys.txt en el mismo directorio que el archivo
.aiexclude, pero no en ningún subdirectorio:/apikeys.txtBloquea todos los archivos del directorio
my/sensitive/diry 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 citas cuando cita directamente a de otra fuente, como un código abierto existente. Para obtener más información, consulta Cómo y cuándo Gemini cita fuentes.
Para evitar que se sugiera código que coincida con las fuentes citadas, puedes modificar el parámetro de configuración cloudcode.duetAI.recitation.maxCitedLength a 0 en un archivo settings.json:
"cloudcode.duetAI.recitation.maxCitedLength": 0
Cómo usar 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:
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.
Usar la transformación de código
Gemini Code Assist proporciona transformación de código, que te permite 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 la transformación de código, puedes hacer lo siguiente:
- Genera líneas de comentarios para documentar tu código
- Cómo solucionar problemas 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 enviar instrucciones a 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:
En el archivo de código, presiona Control + I (para Windows y Linux) o Comando + I (para macOS).
Ingresa una instrucción, como
Write a function to create a Cloud Storage bucket, y presiona Intro (para Windows y Linux) o Return (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 Gemini sugiere y tu código original. Luego, puedes aceptar o descartar los cambios sugeridos.
Para ver la diferencia del código refactorizado en el cuadro de texto intercalado, realiza la los siguientes pasos:
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).
Ingresa un mensaje, como
Add comments, y presiona Intro (para Windows). y Linux) o Return (para macOS).Cuando Gemini genera los cambios de código en la función selecionada, aparece la vista de diferencias.
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 visualización de contexto muestra 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 el panel Gemini: Chat, desplázate hasta que veas el fragmento Fuentes de contexto. Expande 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 la aplicación inteligente /explain
sigue estos pasos:
En el archivo de código, presiona Control + I (para Windows y Linux) o Comando + I (para macOS) para abrir el cuadro de texto intercalado.
Presiona / para ver la lista de comandos inteligentes y sus descripciones.
Selecciona
/explain.Gemini genera una explicación de todo el archivo de código en el cuadro de texto intercalado.
Opcional: Si quieres ver la respuesta generada en Gemini: Chat haz clic en Ver en Chat.
Ver historial de instrucciones
Acceder al historial de instrucciones te ahorra tiempo cuando necesitas ingresar lo mismo mensajes 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 presionando 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 los 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:
En el archivo de código, selecciona el código al que deseas agregar comentarios.
Abre el cuadro de texto intercalado presionando Control + I (para Windows y Linux) o Comando + I (para macOS).
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 muestra la diferencia entre estas sugerencias.
Para aceptar o descartar estos cambios de tu código, haz clic en Aceptar. Descartar.
Cómo probar otros ejemplos de instrucciones
Después de leer el En la sección Generate code with prompts, 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 que seleccionaste 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.
Obtén ayuda para depurar 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 Gemini Code Assist
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 menu Menú > Ver > Salida.
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.comycloudaicompanion.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 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
"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 Enviar comentarios.
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?
- Aprende a escribir mejores instrucciones.