Usa 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 proporcionan 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 comenzar

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

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

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

Formulario Cómo activar Notas y recursos

Chat en lenguaje natural

Ingresa una instrucció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 búsquedas de varios pasos.
  • Puedes pedir más detalles sobre las fuentes, incluidos vínculos a las fuentes específicas.
  • Si destacas o seleccionas código cuando envías un mensaje en el chat, Gemini Code Assist usa ese código para mejorar la personalización del código y la calidad del chat.

Para obtener más información, consulta Chatea con Gemini Code Assist.
Generar código En la barra de selección rápida del IDE, con o sin código seleccionado, presiona Comando+Intro (en macOS) o Control+Intro. Para obtener más información, consulta Genera código con instrucciones.
Transforma el código En la barra de selección rápida del IDE, con o sin código seleccionado, ingresa /fix. Para obtener más información, consulta Genera código con instrucciones.
Autocompletar La personalización del código se activa automáticamente y proporciona sugerencias según lo que escribes.

Ten en cuenta lo siguiente:

  • La finalización de 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 finalización de código verifica si tienes las bibliotecas necesarias para usar ciertos elementos de la función.

Para obtener más información, consulta Cómo obtener sugerencias de código.

Contexto del repositorio remoto
  1. Comienza tu instrucción con el símbolo @. Aparecerá una lista de los repositorios remotos disponibles que están indexados.
  2. En la lista, selecciona el repositorio que deseas usar como contexto. También puedes comenzar a escribir el nombre del repositorio para filtrar la lista.
  3. Después de seleccionar el repositorio, escribe el resto de la instrucción.

Ten en cuenta lo siguiente:

  • Esto es útil cuando trabajas en una tarea que se relaciona principalmente con un conjunto específico de microservicios, bibliotecas o módulos.

Para obtener más información, consulta Obtén sugerencias más relevantes con el contexto del repositorio remoto.

Casos de uso y ejemplos de instrucciones

En la siguiente tabla, se proporcionan orientación y ejemplos sobre el uso de la personalización de código en casos de uso específicos:

Caso de uso Cosas que vale 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 mencionan en tu base de código.
  • Pega tu código, como una firma funcional o código con comentarios TODO, y, luego, pídele a Gemini Code Assist que complete o reemplace los comentarios TODO con código. Agrega comentarios con explicaciones a partir del contexto.

Intenta generar código con las siguientes instrucciones en el chat de Gemini Code Assist:

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

Después de generar código, intenta usar una instrucción adicional para mejorarlo:

  • "Prueba el comando /fix para ajustar el código generado, por ejemplo, errores de sintaxis".
  • "Agrega las importaciones faltantes".
  • "Prueba /fix en el código generado por chat".
Limpieza, simplificación y refactorización del código

Prueba las siguientes instrucciones 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 el nombre de las variables en la función FUNCTION_NAME?"
Legibilidad

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

  • "Escribe la función FUNCTION_NAME en la menor cantidad de líneas de código posible".
  • "Agrega comentarios a la función FUNCTION_NAME".
  • "Quita los espacios en blanco innecesarios en la función FUNCTION_NAME".
  • "Formatea la función FUNCTION_NAME de manera similar al resto del código".
Revisión de código

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

  • "Divide el código en partes y explica cada una con nuestra base de código".
  • "¿Hay variables o palabras clave que podrían ser más cortas y autoexplicativas?"
  • "¿Puedes darme código útil del contexto de REPOSITORY_NAME_PACKAGE_MODULE para este código?"
  • "¿Qué opinas de la función FUNCTION_NAME?"
Depuración

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

  • "Recibo un mensaje de error cuando intento hacer X o agregar Y. ¿Por qué?"
  • "¿Puedes detectar un error en la función FUNCTION_NAME?"
  • "¿Cómo corregirías la función FUNCTION_NAME dado este mensaje de error?"
Aprendizaje e incorporación

Prueba las siguientes instrucciones 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".
  • "¿Cómo llamar a la función FUNCTION_NAME?"
  • "¿Cómo ejecutar la función principal en el entorno ENVIRONMENT_NAME?"
  • "¿Cuál es la principal mejora técnica que podemos implementar para que este código tenga un mejor rendimiento?"
  • "Muéstrame la implementación de FUNCTION_OR_CLASS_NAME para obtener mejores resultados y agrega 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 instrucciones en el chat de Gemini Code Assist:

  • "Dame una estrategia para migrar FILE_NAME de LANGUAGE_1 a LANGUAGE_2", por ejemplo, de Go a Python.
  • "Dada la función FUNCTION_NAME en el repositorio REPOSITORY_NAME, búscame 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 instrucciones:

  1. "Toma el código de FILENAME_COMPONENT ya 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 llevarlo al estado que desees.
    • Prueba las siguientes instrucciones:
      • "¿Hay algo que se pueda mejorar?"
      • "Dame posibles dificultades".
      • "¿Cómo probarías este código si esa migración es correcta?"
Generación de documentación

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

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

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

  • "Genera pruebas de unidades para FILENAME".
  • "Agrega los casos de prueba más relevantes para la función FUNCTION_NAME".
  • "Quita 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 pertinentes. Esto guía la personalización del código hacia los ejemplos más pertinentes.
  • Usa los repositorios de índices que quieras escalar y evita agregar funciones obsoletas. La personalización de código ayuda a escalar el estilo, los patrones, la semántica, el conocimiento y las implementaciones del código en toda la base de código. Los malos ejemplos de repositorios para escalar son las funcionalidades obsoletas, el código generado y las implementaciones heredadas.
  • Para los casos de uso de recuperación de código, usa la funcionalidad de generación de código en lugar de la de finalización de código. Usa instrucciones con un lenguaje como "Según 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 deseas recuperar en el archivo para mejorar la conciencia contextual de Gemini.
  • Ejecuta solo una acción por instrucción. Por ejemplo, si quieres recuperar código y que este se implemente en una función nueva, sigue estos pasos en dos instrucciones.
  • Para los casos de uso en los que deseas algo más que solo código (como una explicación del código, un plan de migración o una explicación de errores), usa la personalización de código para el chat, en la que tienes una conversación con Gemini con tu base de código en contexto.
  • Ten en cuenta que la generación de modelos de IA no es determinística. Si no te satisface la respuesta, ejecutar la misma instrucción nuevamente podría generar un mejor resultado.
  • Ten en cuenta que, por lo general, la generación de pruebas de unidades funciona mejor si abres el archivo de forma local y, luego, desde el chat, pides que se generen pruebas de unidades para ese archivo o una función específica.

Obtén sugerencias más relevantes con el contexto del repositorio remoto

Puedes obtener sugerencias de código más pertinentes y con mayor contexto si le indicas a Gemini Code Assist que se enfoque en repositorios remotos específicos. Si usas el símbolo @ en el chat, puedes seleccionar uno o más repositorios para que se usen como fuente principal de contexto para tus instrucciones. Esto es útil cuando trabajas en una tarea que se relaciona 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. Comienza tu instrucción con el símbolo @. Aparecerá una lista de los repositorios remotos disponibles que están indexados.
  2. En la lista, selecciona el repositorio que deseas usar como contexto. También puedes comenzar a escribir el nombre del repositorio para filtrar la lista.
  3. Después de seleccionar el repositorio, escribe el resto de la instrucción.

Luego, Gemini priorizará el repositorio seleccionado cuando genere una respuesta.

Ejemplos de instrucciones

Estos son algunos ejemplos de cómo puedes usar esta función:

  • Para comprender un repositorio, haz lo siguiente:
    • "@REPOSITORY_NAME ¿Cuál es la estructura general de este repositorio?"
    • "@REPOSITORY_NAME Soy un miembro nuevo del equipo. ¿Puedes darme una descripción general del propósito y los módulos clave de este repositorio?"
  • Para la generación y modificación de 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 las pruebas, haz lo siguiente:
    • "@UNIT_TEST_FILE_NAME Genera pruebas de unidades para MODULE según los ejemplos del archivo seleccionado".

Si usas repositorios remotos como una fuente de contexto enfocada, puedes obtener sugerencias más precisas y pertinentes de Gemini Code Assist, lo que te ayudará a escribir código de manera más rápida y eficiente.