Контрольный список для использования Firebase AI Logic

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

Общий

Ознакомьтесь с общим контрольным списком запуска для приложений, использующих Firebase.

В этом контрольном списке запуска Firebase описываются важные рекомендации перед запуском любого приложения Firebase в эксплуатацию.

Убедитесь, что ваши проекты Firebase соответствуют лучшим практикам

Например, убедитесь, что вы используете разные проекты Firebase для разработки, тестирования и производства. Ознакомьтесь с другими рекомендациями по управлению проектами .

Доступ и безопасность

Ознакомьтесь с общим контрольным списком безопасности для приложений, использующих Firebase.

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

Начните применять Firebase App Check

Firebase App Check помогает защитить API, предоставляющие доступ к моделям Gemini и Imagen . App Check проверяет, что запросы исходят от вашего приложения и с подлинного, нетронутого устройства. Сервис поддерживает поставщиков аттестации для платформ Apple (DeviceCheck или App Attest), Android (Play Integrity) и Web (reCAPTCHA Enterprise), а также поддерживает всех этих поставщиков для приложений Flutter и Unity.

Кроме того, чтобы подготовиться к предстоящей улучшенной защите от App Check с помощью защиты от повторного воспроизведения , мы рекомендуем включить использование токенов ограниченного использования в ваших приложениях.

Настройте ограничения для ключей API Firebase

• Ознакомьтесь со списком разрешенных ограничений API для каждого ключа API Firebase:

  • Убедитесь, что Firebase AI Logic API находится в разрешенном списке.

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

• Установите «Ограничения для приложений» , чтобы ограничить использование каждого ключа Firebase API только запросами из вашего приложения (например, совпадающий идентификатор пакета для приложения Apple). Обратите внимание, что даже если вы ограничите свой ключ, настоятельно рекомендуется использовать Firebase App Check .

Обратите внимание, что API, связанные с Firebase, используют ключи API только для идентификации проекта или приложения Firebase, а не для авторизации вызова API.

Биллинг, мониторинг и квоты

Избегайте неожиданных счетов

Если ваш проект Firebase реализуется по тарифному плану Blaze с оплатой по факту использования, отслеживайте использование ресурсов и настраивайте оповещения о бюджете .

Настройте мониторинг ИИ в консоли Firebase

Настройте мониторинг с помощью ИИ, чтобы отслеживать ключевые показатели производительности, такие как запросы, задержка, ошибки и использование токенов. Мониторинг с помощью ИИ также поможет вам проверять и отлаживать функции Firebase AI Logic, выявляя отдельные трассировки.

Проверьте свои квоты на требуемые базовые API.

• Убедитесь, что вы понимаете квоты для каждого требуемого API .

• Установите ограничение скорости для каждого пользователя (по умолчанию 100 об/мин).

• При необходимости отредактируйте квоту или запросите ее увеличение .

Управление конфигурациями

Используйте стабильную версию модели в своем производственном приложении

В вашем производственном приложении используйте только стабильные версии модели (например, gemini-2.0-flash-001 ), а не предварительные или экспериментальные версии или автоматически обновляемые псевдонимы.

Несмотря на то, что автоматически обновляемый стабильный псевдоним указывает на стабильную версию, фактическая версия модели, на которую он указывает, будет автоматически меняться при выпуске новой стабильной версии, что может привести к непредсказуемому поведению или отклику. Кроме того, предварительные и экспериментальные версии рекомендуется использовать только на этапе прототипирования.

Настройка и использование Firebase Remote Config

С помощью Remote Config вы можете управлять важными конфигурациями функций генеративного ИИ в облаке, а не просто прописывать значения в коде. Это означает, что вы можете обновлять конфигурацию, не выпуская новую версию приложения.

• (Настоятельно рекомендуется) Удаленно изменяйте название модели, используемой в вашем приложении , по мере выпуска новых моделей или прекращения поддержки старых.

• (Необязательно) Динамически и даже условно управляйте другими параметрами в вашем приложении , такими как конфигурация генерации модели (максимальное количество токенов, температура и т. д.), настройки безопасности, системные инструкции и данные подсказок.

• (Необязательно) Задайте параметр minimum_version в Remote Config , чтобы сравнить текущую версию приложения с последней версией, определенной в Remote Config , чтобы либо показать пользователям уведомление об обновлении, либо принудительно выполнить обновление.

Укажите место доступа к модели

Указание места доступа к модели может помочь сократить расходы, а также предотвратить задержки для ваших пользователей.

Если местоположение не указано, по умолчанию используется us-central1 . Вы можете задать это местоположение во время инициализации или использовать Firebase Remote Config для динамического изменения местоположения в зависимости от местоположения каждого пользователя .