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


Вы можете включить для проекта 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).
    • Этот параметр не блокирует запросы управляющего уровня (например, для управления шаблонами и конфигурациями).
  • Эта настройка не блокирует запросы к API countTokens (Count Tokens API).

Перед тем как включить режим использования только шаблонов

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

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

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

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

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

Настройки режима только шаблона задаются в консоли Firebase.

Требуемые разрешения и роли IAM

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

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

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

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

  2. В консоли Firebase перейдите на вкладку Настройки в разделе Сервисы ИИ > Логика ИИ.

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

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

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

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

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

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

  1. В консоли Firebase перейдите на вкладку Настройки в разделе Сервисы ИИ > Логика ИИ.

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

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