Вы можете включить для проекта 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, выполните следующие действия:
Если вы ещё не сделали этого, ознакомьтесь с важными аспектами режима только шаблона, которые описаны выше в этом руководстве.
В консоли Firebase перейдите на вкладку Настройки в разделе Сервисы ИИ > Логика ИИ.
В разделе Режим шаблона установите переключатель Принудительно включить режим только шаблонов в положение Включено.
В диалоговом окне подтверждения нажмите Подтвердить.
Как отключить режим "Только шаблоны"
Если вы отключите принудительное использование режима "Только шаблон", учитывайте следующее:
- Запросы через Firebase AI Logic, в которых не используются шаблоны запросов на сервере, будут разрешены.
- Это настройка на уровне проекта для Firebase AI Logic.
Чтобы отключить режим использования только шаблонов для проекта Firebase, выполните следующие действия:
В консоли Firebase перейдите на вкладку Настройки в разделе Сервисы ИИ > Логика ИИ.
В разделе Режим шаблона отключите параметр Принудительно использовать только режим шаблона.
В диалоговом окне подтверждения нажмите Подтвердить.