Настройте Gemini в Firebase в рабочих областях

Firebase Studio упрощает рабочие процессы разработки благодаря следующим функциям кода с использованием искусственного интеллекта:

• Предлагаемое завершение кода по мере ввода.

• Помощь искусственного интеллекта в чате, который учитывает рабочую область и полностью интегрирован с вашим кодом. Он может генерировать, переводить и объяснять код. И, после вашего рассмотрения и одобрения, Gemini в Firebase сможет напрямую взаимодействовать с вашим рабочим пространством для обновления файлов, запуска команд терминала, интерпретации вывода команд и определения следующих шагов. Узнайте больше в разделе «Попробуйте пообщаться с Gemini .

• Встроенные действия, которые вы можете выполнять с выбранными фрагментами кода. Например, вы можете попросить Gemini сделать выбранный код более читабельным.

• Встроенная помощь по коду.

Вы можете настроить то, как Gemini в Firebase помогает вам, изменив его настройки и добавив файлы правил AI:

• Настройте параметры завершения кода .
• Настройте параметры индексации кодовой базы .
• Настройте инструкции для Gemini с помощью файла правил AI .
• Исключите файлы из Gemini с помощью файлов .aiexclude .
• Принесите свой ключ: используйте в чате другие модели Близнецов.

Используйте Gemini в Firebase в своем рабочем пространстве

Используйте Gemini в Firebase , чтобы повысить производительность кодирования с помощью панели чата или встроенной помощи по коду .

1. Используйте чат или встроенную помощь по коду в своем рабочем пространстве:

   • Чтобы использовать чат: в открытом рабочем пространстве нажмите «Spark Gemini» в нижней части рабочего пространства.

   • Чтобы использовать встроенную помощь по коду: начните вводить код и нажмите Tab , чтобы принять предложения.

2. Имейте в виду, что по умолчанию включены следующие две опции:

   • Предложения по мере ввода , обеспечивающие встроенное завершение кода.
   • Индексирование кодовой базы , обеспечивающее лучшую настройку и более полезные ответы.

   Чтобы изменить эти параметры для настроек вашего рабочего пространства в будущем:

   • Чтобы обновить настройки завершения кода, см. раздел Настройка параметров завершения кода .
   • Чтобы обновить настройки индексации кода, см. раздел Настройка параметров индексации кода .

   Вы также можете исключить определенные файлы и каталоги из индексации AI. См. раздел Исключение файлов из Gemini с помощью файлов .aiexclude .

Близнецы в ярлыках Firebase

Чтобы быстро открыть чат с Gemini : нажмите Ctrl+Shift+Space (или Cmd+Shift+Space в MacOS).

Чтобы просмотреть команды Gemini из палитры команд:

1. Откройте палитру команд, нажав Ctrl+Shift+P (или Cmd+Shift+P в MacOS).

2. Найдите Gemini .

   Появится список команд Gemini .

Настройте параметры завершения кода

Чтобы помочь вам писать код, Firebase Studio обеспечивает завершение кода AI, которое прогнозирует и автоматически заполняет код в любом открытом файле, как только вы начинаете его печатать.

Имейте в виду, что автодополнение кода включено по умолчанию .

Чтобы включить или выключить автодополнение кода, настройте параметры завершения кода одним из следующих способов:

• Если вы используете файл settings.json , установите для параметра "IDX.aI.enableInlineCompletion" значение true или false .

• Чтобы обновить настройки в рабочей области Firebase Studio :

  1. Нажмите «Управление» (расположено в левом нижнем углу рабочей области), затем выберите «Настройки» или нажмите Ctrl+, ( Cmd+, на Mac).

     Если вы используете App Prototyping agent в Prototyper view, click Switch to Code to open Code view.

  2. Выберите вкладку «Рабочая область» , затем найдите параметр Firebase Studio > AI > «Включить встроенное завершение» .

  3. Чтобы отключить автозавершение кода, снимите флажок «Включить встроенное завершение кода при вводе» .

Настройте параметры индексации кодовой базы

Вы можете контролировать, будет ли Gemini индексировать ваш код. Индексирование вашего кода дает более полезные результаты при использовании чата или встроенной помощи искусственного интеллекта.

Имейте в виду, что индексирование кодовой базы включено по умолчанию .

Чтобы включить или выключить индексацию кода, настройте параметры индексации базы кода одним из следующих способов:

• Если вы используете файл settings.json , установите для "IDX.aI.enableCodebaseIndexing" значение true или false .

• Чтобы обновить настройки в рабочей области Firebase Studio :

  1. Нажмите «Управление» (расположено в левом нижнем углу рабочей области), затем выберите «Настройки» или нажмите Ctrl+, ( Cmd+, на Mac).

     Если вы используете App Prototyping agent в Prototyper view, click Switch to Code to open Code view.

  2. Выберите вкладку «Рабочая область» , затем найдите параметр Firebase Studio > AI > «Включить встроенное завершение» .

  3. Выберите Firebase Studio > AI: включить индексацию кодовой базы .

  4. Чтобы отключить индексацию кода, снимите флажок AI: Включить индексацию кодовой базы . Вам необходимо обновить настройки индексации кода для каждого из ваших рабочих пространств.

Настройте инструкции для Gemini в Firebase с помощью файла правил AI.

Вы можете добавить информацию о контексте и системных подсказках, создав файл правил AI ( .idx/airules.md ). Gemini в Firebase использует ваши правила в качестве системных инструкций и контекста, гарантируя, что его ответы будут настроены для вашего варианта использования.

Используйте файл правил AI, чтобы делиться с Gemini пользовательскими подсказками, лучшими практиками и даже важным контекстом вашего проекта для достижения таких целей, как:

• Влияние на личность Gemini и специализация на их опыте.
• Применение стандартов всего проекта, таких как стиль кодирования, соглашения и технологические предпочтения.
• Уменьшите объем информации, которой вам нужно поделиться в коде или в чате, за счет предоставления необходимого контекста вашего проекта.

Правила, которые вы настроите, будут использоваться Gemini в чате .

Создайте и протестируйте файл правил AI.

Чтобы создать и протестировать файл правил AI:

1. Создайте новый файл .idx/airules.md в рабочей области Firebase Studio (в том же каталоге, что и ваш файл dev.nix ). Вы можете использовать один из следующих вариантов:

   • В проводнике ( Ctrl+Shift+E ) щелкните правой кнопкой мыши .idx и выберите «Новый файл» . Назовите файл airules.md и нажмите Enter.
   • В терминале используйте предпочитаемый вами текстовый редактор, чтобы открыть .idx/airules.md .

2. Добавьте содержимое в файл. Возможно, вы захотите добавить информацию о том, какой образ Gemini должен использовать (например, «Вы опытный разработчик и полезный помощник, который знает все о Next.js»), стандартах кодирования и общения, а также контекст проекта. В следующем примере приведен пример файла правил AI.

3. Сохраните файл и откройте Gemini в Firebase .

4. Чтобы начать использовать правила ИИ, вы можете выполнить одно из следующих действий:

   • Перестройте рабочую область, обновив страницу. После перестройки Gemini в Firebase будет использовать файл правил в чате. Изменения в файле правил AI должны немедленно отражаться в чате.
   • Если вы не хотите перестраивать свое рабочее пространство, вы можете попросить Gemini в чате load airules.md . Если вы вносите изменения в файл во время текущего сеанса, вам может потребоваться повторно предложить Gemini загрузить файл правил еще раз.

5. Задавайте вопросы о своем коде. Gemini отвечает, используя информацию, которую вы включили в файл правил, в качестве контекста.

Пример

Ниже приведен базовый пример файла правил, который вы можете использовать для казуальной игры, разработанной с помощью 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.

Исключение файлов из Gemini с помощью файлов .aiexclude

Вы можете контролировать, какие файлы в вашей кодовой базе должны быть скрыты от Gemini , включив в свой проект файлы .aiexclude . Это позволяет вам детально контролировать контекст проекта, которым вы делитесь с Gemini .

Подобно файлу .gitignore , файл .aiexclude отслеживает файлы, которыми не следует делиться с Gemini , включая чат, а также функции искусственного интеллекта, которые работают в редакторе. Файл .aiexclude работает с файлами в каталоге, в котором он содержится, или ниже.

Файлы, покрытые расширением .aiexclude , не будут индексироваться Gemini , если включено индексирование кодовой базы . Кроме того, .aiexclude повлияет на встроенную помощь для защищенных файлов следующим образом:

• Помощь в чате : Gemini не сможет отвечать на вопросы или предлагать предложения по файлам, охватываемым .aiexclude .
• Дополнение кода : предлагаемые варианты завершения кода не будут доступны при редактировании закрытых файлов.
• Встроенная помощь : вы сможете создавать новый код, но не изменять существующий код при редактировании закрытых файлов.

Другие среды разработки, такие как Android Studio, также могут использовать файлы .aiexclude .

Как писать файлы .aiexclude

Файл .aiexclude имеет тот же синтаксис, что и файл .gitignore , со следующими отличиями:

• Пустой файл .aiexclude блокирует все файлы в своем каталоге и во всех подкаталогах. Это то же самое, что файл, содержащий **/* .
• Файлы .aiexclude не поддерживают отрицание (префикс шаблонов с ! ).

Примеры

Вот несколько примеров конфигураций файлов .aiexclude :

• Заблокируйте все файлы с именем apikeys.txt в каталоге, содержащем файл .aiexclude , или ниже:

  apikeys.txt
  

• Заблокируйте все файлы с расширением .key в каталоге, содержащем файл .aiexclude , или ниже:

  *.key
  

• Заблокируйте только файл apikeys.txt в том же каталоге, что и .aiexclude , но не какие-либо подкаталоги:

  /apikeys.txt
  

• Заблокируйте все файлы в каталоге my/sensitive/dir и во всех подкаталогах. Путь должен быть относительным к каталогу, содержащему файл .aiexclude :

  my/sensitive/dir/
  

Принесите свой ключ: используйте в чате другие модели Близнецов.

Вы можете настроить модель Gemini , которую использует Gemini в чате Firebase . У вас есть выбор встроенной модели, модели, настроенной в окне чата (включая модели Gemini 2.5 ), или любой модели Gemini , к которой у вас есть доступ.

Список всех доступных моделей см. в разделе Модели Gemini .

Чтобы настроить ключ и выбрать другую модель Gemini :

1. В открытом рабочем пространстве нажмите «Spark Gemini» в нижней части рабочего пространства (или вкладки «Gemini» ).

2. В окне чата Gemini в Firebase щелкните раскрывающийся список названия модели, затем щелкните ссылку ключа Gemini API . Появятся настройки пользователя .

3. В поле IDX > AI: Gemini Api Key введите свой ключ Gemini API .

Теперь вы можете выбрать любую из предварительно настроенных моделей Gemini в чате.

Чтобы настроить модель Gemini , которой нет в раскрывающемся списке:

1. Определите модель Gemini , которую вы хотите использовать в чате, из списка моделей Gemini . Например, вы должны ввести gemini-2.0-flash-lite для использования последней стабильной модели Gemini 2.0 Flash‑Lite .

2. В окне чата Gemini в Firebase нажмите на селектор модели, затем выберите «Пользовательский идентификатор модели» . Откроются настройки пользователя .

3. Скопируйте выбранное вами имя модели в поле IDX > AI: Gemini Model .

4. Закройте окно чата, затем откройте его снова, нажав кнопку «Spark Gemini» в нижней части рабочей области, чтобы обновить список моделей.

Следующие шаги

• Попробуйте Gemini в Firebase .