Как настроить Gemini в Firebase в рабочей области

В Firebase Studio есть функции на базе ИИ, которые помогают при написании кода и разработке.

  • Дополнение кода по мере ввода.

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

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

  • Встроенные подсказки при написании кода.

Вы можете настроить работу Gemini в Firebase, изменив параметры функций и добавив файлы с правилами для ИИ.

Как использовать Gemini в Firebase в рабочей области

Быстрее и эффективнее пишите код, взаимодействуя с Gemini в Firebase через панель чата или встроенные подсказки.

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

    • Чтобы открыть чат, нажмите на значок искры Gemini в нижней части рабочей области.

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

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

    • Подсказки при вводе текста. Система предлагает варианты дополнения кода в редакторе.
    • Индексация базы кода. Позволяет системе давать более точные и полезные советы.

    Вы можете изменить параметры этих функций для рабочей области.

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

Сочетания клавиш для Gemini в Firebase

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

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

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

  2. Выполните поиск по запросу Gemini.

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

Как задать настройки дополнения кода

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

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

Включить или отключить функцию можно следующими способами:

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

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

    1. Нажмите Значок шестеренки Manage (Управление) в левом нижнем углу рабочей области, а затем выберите Settings (Настройки) или нажмите Ctrl+, (Cmd+, на устройстве с macOS).

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

    2. Откройте вкладку Workspace (Рабочая область) и найдите параметр Firebase Studio > AI > Enable Inline Completion (Firebase Studio > ИИ > Включить дополнение кода).

    3. Чтобы отключить эту функцию, снимите флажок Enable inline code completion as you type (Включить дополнение кода при вводе).

Как изменить настройки индексации базы кода

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

Помните, что индексация базы кода включена по умолчанию.

Включить или отключить индексацию можно следующими способами:

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

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

    1. Нажмите Значок шестеренки Manage (Управление) в левом нижнем углу рабочей области, а затем выберите Settings (Настройки) или нажмите Ctrl+, (Cmd+, на устройстве с macOS).

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

    2. Откройте вкладку Workspace (Рабочая область) и найдите параметр Firebase Studio > AI > Enable Inline Completion (Firebase Studio > ИИ > Включить дополнение кода).

    3. Выберите Firebase Studio > AI: Enable Codebase Indexing (Firebase Studio > ИИ: включить индексацию базы кода).

    4. Чтобы отключить индексацию кода, снимите флажок AI: Enable Codebase Indexing (ИИ: включить индексацию базы кода). Эти настройки необходимо обновить для каждой рабочей области.

Как настроить инструкции для Gemini в Firebase с помощью файла правил для ИИ

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

В файле с правилами для ИИ можно передать Gemini специальные запросы, рекомендации и даже важный контекст о проекте. Это позволит:

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

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

Как создать и протестировать файл правил для ИИ

Сделайте следующее:

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

    • Нажмите Ctrl+Shift+E, чтобы открыть Explorer (Проводник). Затем правой кнопкой мыши нажмите на .idx и выберите New file (Создать файл). Назовите файл airules.md и нажмите Ввод.
    • Откройте файл .idx/airules.md в текстовом редакторе через терминал.
  2. Добавьте содержимое в файл. Вы можете указать роль для Gemini (например, "Ты опытный разработчик и полезный помощник, который знает все о Next.js"), стандарты общения и написания кода, а также контекст проекта. Посмотрите пример файла с правилами для ИИ.

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

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

    • Заново создайте рабочую область, обновив страницу. После этого Gemini в Firebase начнет использовать файл правил в чате. Изменения в файле правил для ИИ будут сразу отражаться в чате.
    • Если вы не хотите заново создавать рабочую область, отправьте в чат с 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 влияет на файлы, расположенные в одном с ним каталоге и всех его подкаталогах.

Когда включена индексация базы кода, Gemini не индексирует файлы, скрытые с помощью .aiexclude. Кроме того, .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, которую Gemini в Firebase будет использовать в чате. Выберите встроенную модель, одну из моделей, настроенных в окне чата (в том числе Gemini 2.5), или любую модель Gemini, к которой у вас есть доступ.

Посмотрите список всех доступных моделей Gemini.

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

  1. Откройте рабочую область и нажмите на значок искры Gemini внизу или на вкладке Gemini.

  2. В окне чата с Gemini в Firebase раскройте список названий моделей и нажмите на ссылку Gemini API key (Ключ Gemini API). Откроется окно User Settings (Пользовательские настройки).

  3. В поле IDX > AI: Gemini API Key (IDX > ИИ: ключ Gemini API) введите ключ Gemini API.

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

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

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

  2. В окне чата с Gemini в Firebase нажмите на селектор моделей и выберите Custom model ID (Идентификатор пользовательской модели). Откроется окно User Settings (Пользовательские настройки).

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

  4. Закройте окно чата, а затем снова откройте его, нажав на значок искры Gemini в нижней части рабочей области. Список моделей обновится.

Информация по теме