Configura Gemini en Firebase en espacios de trabajo

Firebase Studio facilita tus flujos de trabajo de desarrollo con las siguientes funciones de código asistidas por IA:

  • Finalización de código sugerida a medida que escribes.

  • Asistencia de IA con chat, que reconoce el espacio de trabajo y está completamente integrada en tu código Puede generar, traducir y explicar código. Además, con tu revisión y aprobación, Gemini en Firebase puede interactuar directamente con tu espacio de trabajo para actualizar archivos, ejecutar comandos de la terminal, interpretar el resultado de los comandos y determinar los próximos pasos. Obtén más información en Probar chat con Gemini.

  • Acciones intercaladas que puedes realizar en fragmentos de código seleccionados. Por ejemplo, puedes pedirle a Gemini que haga que el código seleccionado sea más legible.

  • Asistencia de código intercalado

Puedes personalizar la forma en que Gemini te ayuda en Firebase ajustando su configuración y agregando archivos de reglas de IA:

Usa Gemini en Firebase en tu lugar de trabajo

Usa Gemini en Firebase para aumentar tu productividad de programación a través del panel de chat o la asistencia de código intercalado.

  1. Usa la asistencia por chat o intercalada en tu espacio de trabajo:

    • Para usar el chat, en tu espacio de trabajo abierto, haz clic en spark Gemini en la parte inferior del espacio de trabajo.

    • Para usar la asistencia de código intercalado, comienza a escribir el código y presiona Tab para aceptar las sugerencias.

  2. Ten en cuenta que las siguientes dos opciones están habilitadas de forma predeterminada:

    • Sugerencias a medida que escribes, que proporciona la finalización de código intercalado
    • Indexación de la base de código, que proporciona una mejor personalización y respuestas más útiles.

    Para cambiar estas selecciones de la configuración de tu lugar de trabajo en el futuro, haz lo siguiente:

    También puedes excluir archivos y directorios específicos de la indexación de IA. Consulta Cómo excluir archivos de Gemini con archivos .aiexclude.

Accesos directos de Gemini en Firebase

Para abrir rápidamente el chat con Gemini, presiona Ctrl+Shift+Space (o Cmd+Shift+Space en macOS).

Para ver los comandos Gemini desde la paleta de comandos, haz lo siguiente:

  1. Para abrir la paleta de comandos, presiona Ctrl+Shift+P (o Cmd+Shift+P en MacOS).

  2. Busca Gemini.

    Aparecerá una lista de comandos Gemini.

Cómo ajustar la configuración de finalización de código

Para ayudarte a escribir código, Firebase Studio proporciona la finalización de código con IA que predice y completa automáticamente el código en cualquier archivo abierto en cuanto comienzas a escribir.

Ten en cuenta que la finalización de código está activada de forma predeterminada.

Para activar o desactivar la finalización de código, ajusta la configuración de finalización de código con uno de los siguientes métodos:

  • Si usas un archivo settings.json, configura "IDX.aI.enableInlineCompletion" como true o false.

  • Para actualizar la configuración en el lugar de trabajo de Firebase Studio, sigue estos pasos:

    1. Haz clic en Ícono de ajustes Administrar (ubicado en la parte inferior izquierda del lugar de trabajo) y, luego, elige Configuración o presiona Ctrl+, (Cmd+, en Mac).

      Si usas App Prototyping agent en Prototyper view, click Code switch icon Switch to Code to open Code view.

    2. Selecciona la pestaña Workspace y, luego, busca la configuración Firebase Studio > AI > Enable Inline Completion.

    3. Para desactivar la finalización de código, anula la selección de la opción Habilita la finalización de código intercalado mientras escribes.

Ajusta la configuración de indexación de tu base de código

Puedes controlar si Gemini indexa tu código. Indexar tu código proporciona resultados más útiles cuando usas la asistencia de IA intercalada o por chat.

Ten en cuenta que la indexación de la base de código está activada de forma predeterminada.

Para activar o desactivar la indexación de código, ajusta la configuración de indexación de tu base de código con uno de los siguientes métodos:

  • Si usas un archivo settings.json, configura "IDX.aI.enableCodebaseIndexing" como true o false.

  • Para actualizar la configuración en el lugar de trabajo de Firebase Studio, sigue estos pasos:

    1. Haz clic en Ícono de ajustes Administrar (ubicado en la parte inferior izquierda del lugar de trabajo) y, luego, elige Configuración o presiona Ctrl+, (Cmd+, en Mac).

      Si usas App Prototyping agent en Prototyper view, click Code switch icon Switch to Code to open Code view.

    2. Selecciona la pestaña Workspace y, luego, busca la configuración Firebase Studio > AI > Enable Inline Completion.

    3. Selecciona Firebase Studio > IA: Habilita el indexado de la base de código.

    4. Para desactivar la indexación de código, anula la selección de IA: Habilita la indexación de la base de código. Debes actualizar la configuración de indexación de código para cada uno de tus espacios de trabajo.

Personaliza las instrucciones para Gemini en Firebase con un archivo de reglas de IA

Puedes agregar información de contexto y de instrucciones del sistema si creas un archivo de reglas de IA (.idx/airules.md). Gemini en Firebase usa tus reglas como instrucciones y contexto del sistema, lo que garantiza que sus respuestas se personalicen para tu caso de uso.

Usa el archivo de reglas de IA para compartir instrucciones personalizadas, prácticas recomendadas y hasta contexto importante sobre tu proyecto con Gemini para lograr objetivos como los siguientes:

  • Influir en el arquetipo de Gemini y especializar su experiencia
  • Aplicar estándares de todo el proyecto, como el estilo de codificación, las convenciones y las preferencias de tecnología
  • Proporcionar contexto esencial sobre tu proyecto para reducir la cantidad de información que debes compartir de forma explícita en el código o el chat

Gemini usa las reglas que configures en el chat.

Crea y prueba tu archivo de reglas de IA

Para crear y probar tu archivo de reglas de IA, sigue estos pasos:

  1. Crea un archivo nuevo en .idx/airules.md en tu espacio de trabajo Firebase Studio (en el mismo directorio que el archivo dev.nix). Puedes usar una de las siguientes opciones:

    • En el Explorador (Ctrl+Shift+E), haz clic con el botón derecho en .idx y selecciona Archivo nuevo. Asigna el nombre airules.md al archivo y presiona Intro.
    • Desde la terminal, usa tu editor de texto preferido para abrir .idx/airules.md.

  2. Agrega contenido al archivo. Te recomendamos que agregues información sobre el arquetipo que debería usar Gemini (como “Eres un desarrollador experto y un asistente útil que sabe todo sobre Next.js”), los estándares de codificación y conversación, y el contexto del proyecto. Consulta el siguiente ejemplo para ver un archivo de reglas de IA de ejemplo.

  3. Guarda el archivo y abre Gemini en Firebase.

  4. Para comenzar a usar tus reglas de IA, puedes hacer una de las siguientes acciones:

    • Actualiza la página para volver a compilar el espacio de trabajo. Después de volver a compilar, Gemini en Firebase usará el archivo de reglas dentro del chat. Los cambios en el archivo de reglas de IA deberían reflejarse en el chat de inmediato.
    • Si no quieres volver a crear tu espacio de trabajo, puedes pedirle a Gemini que lo haga por chat a load airules.md. Si realizas cambios en el archivo durante la sesión actual, es posible que debas volver a solicitar a Gemini que cargue el archivo de reglas.

  5. Haz preguntas sobre tu código. Gemini responde con la información que incluiste en el archivo de reglas como contexto.

Ejemplo

El siguiente es un ejemplo básico de un archivo de reglas que podrías usar para un juego casual desarrollado con Next.js:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

Excluir archivos de Gemini con archivos .aiexclude

Puedes controlar qué archivos de tu base de código deben mantenerse ocultos para Gemini. Para ello, incluye archivos .aiexclude en tu proyecto. Esto te permite controlar de forma detallada el contexto del proyecto que compartes con Gemini.

Al igual que un archivo .gitignore, un archivo .aiexclude realiza un seguimiento de los archivos que no se deben compartir con Gemini, incluida la experiencia de chat y las funciones de IA que operan en el editor. Un archivo .aiexclude opera en archivos en el directorio que lo contiene o debajo de él.

Gemini no indexará los archivos cubiertos por .aiexclude cuando se habilite el indexado de la base de código. Además, .aiexclude afectará la asistencia intercalada para los archivos cubiertos de las siguientes maneras:

  • Asistencia por chat: Gemini no podrá responder preguntas ni ofrecer sugerencias sobre los archivos cubiertos por .aiexclude.
  • Finalización de código: Las finalizaciones de código sugeridas no estarán disponibles cuando se editen archivos cubiertos.
  • Asistencia intercalada: Podrás generar código nuevo, pero no modificar el código existente cuando edites archivos cubiertos.

Es posible que otros entornos de desarrollo, como Android Studio, también admitan archivos .aiexclude.

Cómo escribir archivos .aiexclude

Un archivo .aiexclude tiene la misma sintaxis que un archivo .gitignore, con las siguientes diferencias:

  • Un archivo .aiexclude vacío bloquea todos los archivos de su directorio y todos los subdirectorios. Esto es lo mismo que un archivo que contiene **/*.
  • Los archivos .aiexclude no admiten la negación (agregar un prefijo ! a los patrones).

Ejemplos

Estos son algunos ejemplos de parámetros de configuración de archivos .aiexclude:

  • Bloquea todos los archivos llamados apikeys.txt en el directorio que contiene el archivo .aiexclude o debajo de él:

    apikeys.txt

  • Bloquea todos los archivos con la extensión .key en el directorio que contiene el archivo .aiexclude o debajo de él:

    *.key

  • Bloquea solo el archivo apikeys.txt en el mismo directorio que .aiexclude, pero no en ningún subdirectorio:

    /apikeys.txt

  • Bloquea todos los archivos del directorio my/sensitive/dir y todos los subdirectorios. La ruta de acceso debe ser relativa al directorio que contiene el archivo .aiexclude:

    my/sensitive/dir/

Usa tu propia clave: Usa otros modelos de Gemini en el chat

Puedes configurar el modelo Gemini que usa Gemini en el chat de Firebase. Puedes elegir entre el modelo integrado, los modelos configurados en la ventana de chat (incluidos los modelos Gemini 2.5) o cualquier modelo Gemini al que tengas acceso.

Para obtener una lista de todos los modelos disponibles, consulta Modelos de Gemini.

Para configurar tu clave y seleccionar un modelo Gemini diferente, sigue estos pasos:

  1. En tu espacio de trabajo abierto, haz clic en spark Gemini en la parte inferior del espacio de trabajo (o en la pestaña Gemini).

  2. En la ventana de chat de Gemini en Firebase, haz clic en el menú desplegable del nombre del modelo y, luego, en el vínculo Clave Gemini API. Aparecerá la Configuración del usuario.

  3. En el campo IDX > AI: Gemini Api Key, ingresa tu clave Gemini API.

Ahora puedes seleccionar cualquiera de los modelos Gemini preconfigurados en el chat.

Para configurar un modelo Gemini que no está en el menú desplegable, haz lo siguiente:

  1. Identifica el modelo Gemini que deseas usar en el chat en la lista de modelos Gemini. Por ejemplo, ingresarías gemini-2.0-flash-lite para usar el modelo Gemini 2.0 Flash‑Lite estable más reciente.

  2. En la ventana de chat de Gemini en Firebase, haz clic en el selector de modelos y, luego, elige ID de modelo personalizado. Se abrirá la Configuración del usuario.

  3. Copia el nombre del modelo que seleccionaste en el campo IDX > AI: Gemini Model.

  4. Cierra la ventana de chat y, luego, vuelve a abrirla haciendo clic en spark Gemini en la parte inferior del lugar de trabajo para actualizar la lista de modelos.

Próximos pasos