Firebase AI Logic Basics

Официальный скилл для интеграции Firebase AI Logic (Gemini API) в веб-приложения. Охватывает настройку, мультимодальный вывод, структурированный вывод и безопасность.

Обзор

Firebase AI Logic — продукт Firebase для добавления генеративного AI в мобильные и веб-приложения через клиентские SDK. Можно вызывать модели Gemini напрямую из приложения без управления выделенным бэкендом. Ранее был известен как «Vertex AI for Firebase».

Поддерживает два провайдера Gemini API:

• Gemini Developer API: бесплатный уровень для прототипирования, pay-as-you-go для продакшна
• Vertex AI Gemini API: для масштаба с enterprise-готовностью, требует плана Blaze

По умолчанию используйте Gemini Developer API; Vertex AI только если приложение это требует.

Настройка

Предварительные требования

• Node.js 16+ и npm
• Определите целевую платформу: Android, iOS, Flutter или Web

Установка

npm install -g firebase@latest

Если вы в директории Firebase (с firebase.json) — проверьте текущий проект:

npx -y firebase-tools@latest projects:list

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

npx -y firebase-tools@latest apps:list

Инициализируйте AI Logic SDK:

npx -y firebase-tools@latest init ailogic

Автоматически включает Gemini Developer API в консоли Firebase.

Ключевые возможности

КРИТИЧНО: Всегда используйте актуальные имена моделей. Проверяйте Firebase AI Logic Models documentation. Не используйте gemini-2.0-pro, gemini-2.0-flash и другие устаревшие или отключённые модели.

• Генерация текста — только текстовый вход
• Мультимодальность — анализ изображений, аудио, видео, PDF прямо из приложения. Файлы больше 20 МБ — хранить в Cloud Storage for Firebase
• Чат-сессия (мультитёрн) — автоматическое ведение истории через startChat
• Потоковые ответы — использовать generateContentStream для отображения результатов по мере получения
• Генерация изображений через Nano Banana — требуется план Blaze; проверяйте актуальные имена моделей в документации
• Search Grounding — встроенный инструмент googleSearch
• Структурированный вывод (JSON) — принудительная JSON-схема ответа
• On-Device AI (гибридный режим) — автоматическое переключение между локальным Gemini Nano и облаком

Поддерживаемые платформы

Kotlin/Java (Android), Swift (iOS), JavaScript (Web), Dart (Flutter), C# (Unity)

Безопасность и продакшн

App Check — обязательно!

КРИТИЧЕСКОЕ ТРЕБОВАНИЕ БЕЗОПАСНОСТИ: необходимо настроить App Check в приложении. Это защищает от несанкционированных клиентов, использующих вашу API-квоту и бэкенд-ресурсы.

Настройка: App Check с reCAPTCHA Enterprise

Remote Config

Не хардкодьте имена моделей. Используйте Firebase Remote Config для обновления версий моделей без деплоя нового клиентского кода.

Провизионирование бэкенда

КРИТИЧНО: для всех платформ (Flutter, Android, iOS, Web) необходимо запустить npx firebase-tools init ailogic для провизионирования сервиса. flutterfire configure обрабатывает только клиентскую конфигурацию и НЕ включает AI сервис (вызовет ошибки PERMISSION_DENIED).

Инициализация по платформам