Когда вы будете готовы запустить приложение и предоставить конечным пользователям доступ к его ИИ-функциям, ознакомьтесь с этим контрольным списком рекомендаций и важных аспектов.
Общие
Ознакомьтесь с общим контрольным списком для запуска
Перед запуском рабочей версии приложения Firebase ознакомьтесь с контрольным списком.
Следуйте рекомендациям по работе с проектами Firebase
Используйте отдельные проекты Firebase для разработки, тестирования и выпуска. Ознакомьтесь с другими рекомендациями по управлению проектами.
Доступ и безопасность
Изучите рекомендации по обеспечению безопасности
Ознакомьтесь с контрольным списком безопасности Firebase и контрольным списком безопасности для Firebase AI Logic, чтобы узнать о важных рекомендациях по доступу и безопасности.
Принудительное применение Firebase App Check
Принудительно используйте Firebase App Check, чтобы защитить Gemini API от злоупотреблений, когда он вызывается напрямую из вашего приложения.App Check проверяет, поступают ли входящие запросы из вашего подлинного приложения и/или с немодифицированного устройства.
App Check поддерживает поставщиков аттестации для платформ Apple (DeviceCheck, App Attest или reCAPTCHA Enterprise), Android (Play Integrity или reCAPTCHA Enterprise) и веб-платформ (reCAPTCHA Enterprise). Он также поддерживает всех этих поставщиков для приложений Flutter и Unity.
Также рекомендуем включить защиту от повторного воспроизведения, чтобы токены можно было использовать только один раз. Этот вариант обеспечивает улучшенную защиту по сравнению с базовой и позволяет выбрать подходящий уровень защиты для вашего приложения и сценариев использования.
Как настроить ограничения для ключей API Firebase
Ключи API Firebase идентифицируют ваш проект и приложение Firebase при выполнении запросов. Чтобы предотвратить несанкционированное использование ключей API, сделайте следующее:
Задайте ограничения для приложений в консоли Google Cloud, чтобы ключ использовался только для запросов от определенного идентификатора пакета приложения (Apple), названия пакета и цифрового отпечатка SHA-1 (Android) или HTTP-реферера (веб).
Проверьте белый список Ограничения API для каждого ключа:
- Убедитесь, что Firebase AI Logic API (
firebasevertexai.googleapis.com) находится в белом списке. - Убедитесь, что в белый список добавлены только те API, которые необходимы для работы вашего приложения. Ознакомьтесь со списком обязательных API для ключей Firebase с ограниченным доступом.
- Убедитесь, что Firebase AI Logic API (
Обратите внимание, что API, связанные с Firebase, используют ключи API только для идентификации проекта или приложения Firebase, а не для авторизации вызова API.
Как ограничить запросы только аутентифицированными пользователями
Рекомендуем принудительно включить режим аутентификации пользователей, чтобы все запросы через Firebase AI Logic содержали действительные учетные данные из Firebase Authentication. Если запрос поступает от неаутентифицированного конечного пользователя, он отклоняется с ошибкой 401: unauthenticated.
Мониторинг, ограничения и оплата
Как настроить ИИ-мониторинг в консоли Firebase
Настройте ИИ-мониторинг в консоли Firebase, чтобы отслеживать ключевые показатели эффективности, такие как количество запросов, задержка, использование токенов и частота ошибок. Вы также можете изучать отдельные трассировки в консоли Google Cloud.
Как задать ограничения частоты запросов и управлять квотами
Чтобы защитить проект от неожиданных скачков использования и атак типа "отказ в кошельке", выполните следующие действия:
- Установите ограничение частоты запросов на пользователя (по умолчанию – 100 запросов в минуту), чтобы отдельные экземпляры клиента не расходовали слишком много квоты.
- Проверьте квоты проекта и управляйте ими в консоли Google Cloud для каждого базового API.
Как избежать неожиданных расходов с помощью оповещений и пределов расходов
Если в вашем проекте Firebase используется тарифный план Blaze с оплатой по мере использования:
Управление конфигурациями
Используйте стабильную версию модели в рабочем приложении
В рабочей версии приложения используйте только стабильные версии моделей, например gemini-3.8-flash. Не используйте предварительные или экспериментальные версии, а также псевдоним -latest
Как использовать шаблоны запросов Firebase Remote Config или сервера
Используя шаблоны запросов Remote Config или сервера, вы можете управлять важными настройками ИИ-функций приложения в облаке (на стороне сервера), а не задавать значения в коде. Это означает, что вы можете обновлять конфигурации, не выпуская новую версию приложения.
(Настоятельно рекомендуется) По мере выпуска новых моделей и прекращения поддержки старых меняйте название модели, используемой для вашей ИИ-функции. Подробнее о том, как использовать Remote Config или шаблоны запросов к серверу…
(Необязательно.) Динамически и даже условно управляйте другими параметрами ИИ-функции, например конфигурацией модели (такой как максимальное количество выходных токенов), настройками безопасности, системными инструкциями и данными запроса. Подробнее о том, как использовать Remote Config или шаблоны запросов на сервере…
(Необязательно.) Задайте параметр
minimum_versionв Remote Config, чтобы сравнивать текущую версию приложения с последней версией, определенной в Remote Config. Это позволит показывать пользователям уведомление о необходимости обновить приложение или принудительно обновлять его.
Как задать местоположение для доступа к модели
| Доступно, только если вы используете Agent Platform Gemini API (formerly Vertex AI) в качестве поставщика API. |
Укажите местоположение для доступа к модели, чтобы оптимизировать квоту и предотвратить задержки для пользователей.
Если вы не укажете местоположение, по умолчанию будет использоваться global (при использовании нового синтаксиса инициализации Agent Platform). Вы можете задать это местоположение во время инициализации или использовать Firebase Remote Config, чтобы динамически менять местоположение в зависимости от местоположения каждого пользователя.