Cómo guardar y administrar instrucciones con la biblioteca de instrucciones

Usa la Biblioteca de instrucciones para guardar y administrar las instrucciones que usas con frecuencia, y recuperarlas rápidamente cuando las necesites. Si hay una instrucción que usas a menudo para diferentes archivos o secciones de código, puedes usar una variable de plantilla de instrucción que se reemplaza automáticamente por el código o el archivo seleccionado durante la ejecución de la instrucción. Este flujo de trabajo optimizado elimina la necesidad de volver a escribir las instrucciones más usadas, lo que te ahorra tiempo y esfuerzo.

La biblioteca de instrucciones en Android Studio, que muestra una lista de instrucciones guardadas.
Figura 1: La biblioteca de instrucciones en Android Studio.

Para abrir la Biblioteca de instrucciones, ve a File (Android Studio en macOS) > Settings > Tools > Gemini > Prompt Library.

Cómo guardar una instrucción

Para agregar una instrucción, sigue estos pasos:

  1. Para abrir la Biblioteca de instrucciones, haz clic en File (Android Studio en macOS) > Settings > Tools > Gemini > Prompt Library.
  2. Establece el alcance de la instrucción con el menú desplegable Alcance:
    • Las reglas a nivel del IDE son privadas y se pueden usar en varios proyectos.
    • Las reglas a nivel del proyecto se pueden compartir entre los miembros del equipo que trabajan en el mismo proyecto.
  3. Haz clic en Agregar para agregar una instrucción nueva.
  4. Asigna un nombre a la instrucción. Este nombre es el que aparece en el menú de la Biblioteca de instrucciones si quieres aplicar la instrucción desde el editor.
  5. Ingresa la instrucción en el campo proporcionado. Si la instrucción implica hacer referencia a código específico, puedes agregar el código pertinente durante la ejecución de la instrucción usando las siguientes variables:
    • $SELECTION: Representa el texto seleccionado o el texto que rodea el cursor si no se seleccionó ningún texto.
    • $CURRENT_FILE: Representa todo el texto del archivo que está activo en el editor.
  6. Opcional: Desmarca la casilla de verificación Mostrar en el menú de la Biblioteca de instrucciones si no quieres que la instrucción aparezca en el menú de la Biblioteca de instrucciones.
  7. Haz clic en el botón Aplicar para guardar los cambios y seguir configurando los parámetros. Para guardar los cambios y salir del diálogo de configuración de inmediato, haz clic en el botón Aceptar.

También puedes hacer clic con el botón derecho en una instrucción del chat para guardarla y usarla más tarde. Para aplicar una instrucción guardada, haz clic con el botón derecho en el editor y ve a Gemini > Biblioteca de instrucciones para aplicar la instrucción.

El menú contextual "Add to Prompt Library" en Android Studio.
Figura 2: Guarda una instrucción desde el editor.

Cómo usar una instrucción guardada

Para usar una instrucción de la biblioteca, sigue estos pasos:

  1. Destaca el código pertinente, si corresponde a la instrucción que planeas usar. Si la instrucción no hace referencia a un código específico, no importa dónde se encuentre el cursor en el archivo.
  2. Para obtener tu lista de instrucciones, haz clic con el botón derecho en el editor y ve a Gemini > Biblioteca de instrucciones.
  3. Para enviar la instrucción a Gemini, selecciónala en el menú.

Comparte y administra instrucciones a nivel del proyecto

Puedes compartir y administrar instrucciones a nivel del proyecto con los miembros del equipo que trabajan en el mismo proyecto. Cuando guardas una instrucción a nivel del proyecto en la Biblioteca de instrucciones, esta se almacena en <project-root>/.idea/project.prompts.xml. Para compartir y administrar instrucciones a nivel del proyecto, agrega la carpeta .idea a tu sistema de control de versiones.