Как принудительно включить режим "Только шаблоны"


Вы можете включить режим только шаблонов для проекта Firebase, чтобы все запросы Gemini API через Firebase AI Logic использовали шаблоны запросов на сервере.

Если запрос заблокирован, возвращается ошибка 403: unauthorized.

Важные примечания

При использовании режима "Только шаблоны" необходимо учитывать следующее:

Когда применяется режим "Только шаблоны"

Если включен режим "Только шаблоны", учитывайте следующее:

  • Это общепроектная настройка для Firebase AI Logic.

    • Оно применяется ко всем приложениям, зарегистрированным в проекте.
    • Оно применяется только к проекту, в котором оно действует.

  • Эта настройка применяется ко всем запросам, отправленным через Firebase AI Logic как в Gemini Developer API, так и в Agent Platform Gemini API (formerly Vertex AI).

  • Этот параметр блокирует любые запросы через Firebase AI Logic, в которых не используются шаблоны запросов на сервере. В частности, блокируются запросы из вашего приложения, в которых используются пока не поддерживаемые возможности шаблонов запросов на сервере.

  • Эта настройка не блокирует запросы Gemini API в вашем проекте, которые отправляются не через Firebase AI Logic.

  • Если вы используете REST API Firebase AI Logic:

    • Эта настройка не блокирует запросы на вывод, в которых используются шаблоны подсказок сервера (например, templateGenerateContent или templateStreamGenerateContent).
    • Этот параметр не блокирует запросы уровня управления (например, для управления шаблонами и конфигурациями).

  • Эта настройка не блокирует запросы к countTokens (Count Tokens API).

Перед включением режима "Только шаблоны"

Прежде чем включить режим "Только шаблоны", обратите внимание на следующее:

  • Если у вас есть версии приложения, в которых не используются шаблоны подсказок на сервере:

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

  • Если в вашем приложении используются функции, которые пока не поддерживаются в шаблонах запросов на сервере:

    • Этот параметр будет блокировать запросы через Firebase AI Logic для этих пока не поддерживаемых возможностей, поскольку они не используют (и не могут использовать) шаблоны запросов сервера.
    • Прежде чем включить режим только шаблонов, убедитесь, что ваше приложение (включая все предыдущие версии) не использует неподдерживаемые функции.

Как управлять настройкой режима "Только шаблоны"

Управлять режимом "Только шаблоны" можно в консоли Firebase.

Необходимые разрешения и роли IAM

Для управления режимом "Только шаблоны" требуется разрешение firebasevertexai.configs.update, которое по умолчанию включено в следующие роли IAM: владелец, редактор, администратор Firebase и администратор Firebase AI Logic.

Принудительно включить режим "Только шаблоны"

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

  1. Если вы ещё этого не сделали, ознакомьтесь с важными примечаниями о режиме "Только шаблоны" в начале этого руководства.

  2. В консоли Firebase перейдите в раздел AI Services (Сервисы ИИ) > AI Logic (Логика ИИ) > Settings (Настройки).

  3. В разделе Режим шаблона установите переключатель Принудительно использовать режим шаблона в положение Принудительно.

  4. В диалоговом окне подтверждения нажмите Подтвердить.

Как отключить принудительное использование режима "Только шаблоны"

Если вы отключите принудительное применение режима "Только шаблоны", произойдет следующее:

  • Запросы через Firebase AI Logic, в которых не используются шаблоны запросов на сервере, будут разрешены.
  • Это настройка Firebase AI Logic на уровне проекта.

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

  1. В консоли Firebase перейдите в раздел AI Services (Сервисы ИИ) > AI Logic (Логика ИИ) > Settings (Настройки).

  2. В разделе Режим шаблона отключите параметр Принудительно использовать только режим шаблона.

  3. В диалоговом окне подтверждения нажмите Подтвердить.