Usar la personalización de código de Gemini Code Assist

En este documento se describe cómo usar la personalización de código de Gemini Code Assist y se ofrecen algunas prácticas recomendadas. Esta función te permite recibir recomendaciones de código que se basan en las bibliotecas internas, las APIs privadas y el estilo de programación de tu organización.

Antes de empezar

  1. Configura Gemini Code Assist con una suscripción Enterprise.
  2. Configura la personalización del código de Gemini Code Assist.

Cómo usar la personalización de código

En la siguiente tabla se indican las formas de usar la personalización de código de Gemini Code Assist:

Formulario Cómo activar Notas y recursos

Chat de lenguaje natural

Introduce una petición en lenguaje natural en el chat de Gemini Code Assist en el IDE.

Ten en cuenta lo siguiente:

  • El historial de chat no está disponible. Evita las consultas de varios pasos.
  • Puedes pedir más detalles sobre las fuentes, incluidos enlaces a las fuentes específicas.
  • Si resaltas o seleccionas código al enviar un mensaje en el chat, Gemini Code Assist usará ese código para mejorar la personalización del código y la calidad del chat.

Para obtener más información, consulta el artículo Chatear con Gemini Code Assist.

Generar código En la barra de selección rápida de tu IDE, con o sin código seleccionado, pulsa Comando + Intro (en macOS) o Control + Intro. Para obtener más información, consulta Generar código con peticiones.
Transformar código En la barra de selección rápida de tu IDE, con o sin código seleccionado, introduce /fix. Para obtener más información, consulta Generar código con peticiones.
Autocompletar La personalización del código se activa automáticamente y proporciona sugerencias basadas en lo que escribes.

Ten en cuenta lo siguiente:

  • La función de autocompletar código necesita un cierto nivel de confianza para proponer una sugerencia. Asegúrate de que haya una cantidad considerable de código disponible para que se recuperen los fragmentos pertinentes.
  • La función de autocompletar código comprueba si tienes las bibliotecas necesarias para usar determinados elementos de la función.

Para obtener más información, consulta Obtener finalizaciones de código.

Contexto de repositorio remoto
  1. Empieza la petición con el símbolo @. Aparecerá una lista de repositorios remotos indexados disponibles.
  2. Selecciona el repositorio que quieras usar como contexto de la lista. También puedes empezar a escribir el nombre del repositorio para filtrar la lista.
  3. Después de seleccionar el repositorio, escribe el resto del prompt.

Ten en cuenta lo siguiente:

  • Esto resulta útil cuando trabajas en una tarea que está relacionada principalmente con un conjunto específico de microservicios, bibliotecas o módulos.

Para obtener más información, consulta el artículo Recibir sugerencias más pertinentes con el contexto del repositorio remoto.

Casos prácticos y ejemplos de peticiones

En la siguiente tabla se ofrecen directrices y ejemplos sobre cómo usar la personalización de código en casos prácticos específicos:

Caso práctico Cosas que merece la pena probar
Escribir código nuevo

Prueba lo siguiente para generar código en tu IDE o en el chat de Gemini Code Assist:

  • Genera código que use términos que ya se hayan mencionado en tu base de código.
  • Pega el código, como una firma funcional o código con TODO comentarios, y pide a Gemini Code Assist que rellene o sustituya TODO los comentarios con código. Añade comentarios con explicaciones del contexto.

Prueba a generar código con las siguientes peticiones en la conversación de Gemini Code Assist:

  • "Escribe una función principal en la que se cree una conexión con DATABASE. Incluye comprobaciones del estado."
  • "Escribe un FUNCTION_OR_CLASS con la siguiente estructura: EXPLAIN_STRUCTURE".

Después de generar código, prueba a usar una petición de seguimiento para mejorarlo:

  • "Prueba el comando /fix para ajustar el código generado, por ejemplo, si hay errores de sintaxis".
  • "Añadir importaciones que faltan".
  • "Prueba /fix en el código generado por la IA".
Limpiar, simplificar y refactorizar código

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "¿Puedes combinar IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS en este archivo?"
  • "¿Cómo simplificarías la función FUNCTION_NAME?"
  • "¿Puedes combinar FUNCTION_NAME_1 y FUNCTION_NAME_2 en una sola función?"
  • "¿Podrías insertar algunas variables en FUNCTION_NAME?"
  • "¿Podrías simplificar los nombres de las variables de la función FUNCTION_NAME?"
Legibilidad

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Escribe la función FUNCTION_NAME en menos líneas de código, si es posible".
  • "Añade comentarios a la función FUNCTION_NAME."
  • "Elimina los espacios en blanco innecesarios de la función FUNCTION_NAME".
  • "Da formato a la función FUNCTION_NAME de forma similar al resto del código".
Revisión de código

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Divide el código en partes y explica cada parte usando nuestra base de código".
  • "¿Hay variables o palabras clave que se puedan acortar y que sean más explicativas?"
  • "¿Puedes darme código útil del REPOSITORY_NAME_PACKAGE_MODULE contexto para este código?"
  • "¿Qué opinas de la función FUNCTION_NAME?"
Depuración

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Aparece un error cuando intento hacer X o añadir Y. ¿Por qué?"
  • "¿Puedes detectar un error en la función FUNCTION_NAME?"
  • "¿Cómo corregirías la función FUNCTION_NAME dado este error message?"
Aprendizaje y formación inicial

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Divide este código en partes y explica cada una de ellas usando nuestra base de código".
  • "Muéstrame cómo llamar a la función FUNCTION_NAME"
  • "Muéstrame cómo ejecutar la función principal en el entorno de ENVIRONMENT_NAME".
  • "¿Cuál es la mejora técnica clave que podemos hacer para que este código tenga un mejor rendimiento?"
  • "Muéstrame la implementación de FUNCTION_OR_CLASS_NAME para obtener mejores resultados y añade qué es ese elemento específico", por ejemplo, "Muéstrame la implementación de la función foo, donde foo es el nombre de la función".
Migración

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Dime una estrategia para migrar FILE_NAME de LANGUAGE_1 a LANGUAGE_2". Por ejemplo, de Go a Python.
  • "Dada la función FUNCTION_NAME del repositorio REPOSITORY_NAME, busca una función equivalente en el lenguaje LANGUAGE_NAME que pueda usar".

Prueba el siguiente flujo de trabajo de transformación basado en chat o generación de código con peticiones:

  1. "Toma el código FILENAME_COMPONENT que ya está escrito en LANGUAGE_1, refactorízalo y migra a LANGUAGE_2". Por ejemplo, de Go a Python.
  2. Después de migrar parte del código, prueba lo siguiente:
    • Selecciona fragmentos más pequeños y usa /fix para ponerlo en el estado que quieras.
    • Prueba las siguientes peticiones:
      • "¿Hay algo que se pueda mejorar?"
      • "Dime posibles problemas".
      • "¿Cómo probarías este código si la migración es correcta?"
Generación de documentación

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Resume el código del paquete o la carpeta X y proporciona documentación sobre los cinco métodos más importantes".
  • "Genera documentación para FUNCTION_OR_CLASS_NAME".
  • "Acorta la documentación sin perder la información clave".
Generación de pruebas unitarias

Prueba las siguientes peticiones en el chat de Gemini Code Assist:

  • "Genera pruebas unitarias para FILENAME".
  • "Añade los casos de prueba más relevantes para la función FUNCTION_NAME".
  • "Elimina los casos de prueba que creas que no aportan mucho valor".

Prácticas recomendadas

  • Usa nombres de variables y funciones o fragmentos de código relevantes. De esta forma, la personalización del código se centra en los ejemplos más pertinentes.
  • Usa los repositorios de índices que quieras escalar y no añadas funciones obsoletas. La personalización del código ayuda a adaptar el estilo, los patrones, la semántica, el conocimiento y las implementaciones del código a toda la base de código. Entre los ejemplos de repositorios que no se pueden escalar se incluyen las funciones obsoletas, el código generado y las implementaciones antiguas.
  • Para los casos prácticos de recuperación de código, utiliza la función de generación de código en lugar de la de finalización de código. Pídele que use expresiones como "Usando la definición de FUNCTION_NAME, genera la misma función" o "Genera la implementación exacta de FUNCTION_NAME".
  • Incluye o importa el código que quieras recuperar en el archivo para mejorar la contextualización de Gemini.
  • Ejecuta solo una acción por cada petición. Por ejemplo, si quieres obtener código e implementarlo en una función nueva, sigue estos pasos en dos peticiones.
  • Si quieres usarlo en casos prácticos en los que necesites algo más que código (como explicaciones de código, planes de migración o explicaciones de errores), usa la personalización de código para el chat, donde puedes conversar con Gemini con tu base de código en contexto.
  • Ten en cuenta que la generación de modelos de IA no es determinista. Si no estás satisfecho con la respuesta, puedes volver a ejecutar la misma petición para obtener un mejor resultado.
  • Ten en cuenta que, por lo general, es mejor generar pruebas unitarias si abres el archivo localmente y, a continuación, le pides al chat que genere pruebas unitarias para ese archivo o para una función específica.

Recibir sugerencias más relevantes con el contexto del repositorio remoto

Puedes obtener sugerencias de código más contextuales y relevantes indicándole a Gemini Code Assist que se centre en repositorios remotos específicos. Si usas el símbolo @ en la conversación, puedes seleccionar uno o varios repositorios para que se usen como fuente principal de contexto para tus peticiones. Esto resulta útil cuando trabajas en una tarea que está relacionada principalmente con un conjunto específico de microservicios, bibliotecas o módulos.

Para usar un repositorio remoto como contexto, sigue estos pasos en el chat de tu IDE:

  1. Empieza la petición con el símbolo @. Aparecerá una lista de los repositorios remotos indexados disponibles.
  2. Selecciona el repositorio que quieras usar como contexto de la lista. También puedes empezar a escribir el nombre del repositorio para filtrar la lista.
  3. Después de seleccionar el repositorio, escribe el resto del prompt.

Gemini priorizará el repositorio seleccionado al generar una respuesta.

Ejemplos de peticiones

A continuación se muestran algunos ejemplos de cómo puedes usar esta función:

  • Para entender un repositorio, sigue estos pasos:
    • "@REPOSITORY_NAME ¿Cuál es la estructura general de este repositorio?"
    • "@REPOSITORY_NAME Soy un nuevo miembro del equipo. ¿Me puedes hacer un resumen del propósito de este repositorio y de sus módulos clave?"
  • Para generar y modificar código:
    • "@REPOSITORY_NAME Implementa una función de autenticación similar a la de este repositorio".
    • "@REPOSITORY_NAME Refactoriza el siguiente código para que siga las convenciones del repositorio seleccionado".
    • "@REPOSITORY_A_NAME ¿Cómo puedo usar las funciones más recientes de este repositorio para mejorar mi código en REPOSITORY_B_NAME?"
  • Para probarlo:
    • "@UNIT_TEST_FILE_NAME Genera pruebas unitarias para MODULE a partir de los ejemplos del archivo seleccionado".

Al usar repositorios remotos como fuente de contexto específica, puedes obtener sugerencias más precisas y relevantes de Gemini Code Assist, lo que te ayudará a escribir código de forma más rápida y eficiente.