firebase-ai-logic-basics
Интеграция Firebase AI Logic (Gemini API) в веб-приложения: мультимодальный вывод, структурированные ответы и безопасность. Подходит для клиентских решений без бэкенда с поддержкой потоковой передачи и App Check.
Что делает навык
Firebase AI Logic позволяет интегрировать генеративный ИИ (модели Gemini) в мобильные и веб-приложения напрямую через клиентские SDK, минуя необходимость в собственном бэкенде. Skill охватывает настройку SDK, поддержку мультимодального ввода, потоковую передачу ответов, структурированный вывод JSON и обеспечение безопасности через App Check.
Когда применять
- Создание клиентских веб-приложений с функциями чата или генерации текста без развертывания серверной части.
- Анализ мультимедийных данных (изображений, аудио, видео, PDF) непосредственно в приложении с использованием Gemini.
- Реализация потоковой передачи ответов (streaming) для улучшения пользовательского опыта в интерфейсах.
- Обеспечение безопасности API-запросов и защита от несанкционированного использования квот через App Check.
- Динамическое управление версиями моделей ИИ с помощью Firebase Remote Config без необходимости обновления клиентского кода.
Как работает
- Установить Node.js 16+ и npm, затем выполнить команду 'npm install firebase@latest' для получения Web SDK.
- Выполнить 'npx -y firebase-tools@latest init ailogic' для инициализации SDK и автоматического включения Gemini Developer API в консоли Firebase.
- Настроить App Check для защиты приложения: для локальной разработки использовать отладочные токены (Debug Tokens), а для продакшена — зарегистрировать реальные токены в Firebase Console.
- Использовать методы 'generateContent' для текстовых запросов или 'generateContentStream' для потоковой передачи ответов.
- При работе с файлами размером более 20 МБ загружать их в Cloud Storage for Firebase и передавать URL в API, чтобы избежать ошибок HTTP 413.
- Проверять документацию Firebase AI Logic Models для использования актуальных имен моделей (избегая устаревших, таких как gemini-2.0-pro).
Примеры запросов агенту
Что понадобится
- Node.js 16+ и npm
- Аккаунт Firebase с проектом и включенным Gemini Developer API (или Blaze plan для Agent Platform)
- Настроенный App Check (для безопасного использования в продакшене)
Описание составлено по SKILL.md навыка, сверено 05.10.2026.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.