AIKraft/Skills/firebase-ai-logic-basics

firebase-ai-logic-basics

Интеграция Firebase AI Logic (Gemini API) в веб-приложения: мультимодальный вывод, структурированные ответы и безопасность. Подходит для клиентских решений без бэкенда с поддержкой потоковой передачи и App Check.

GOGoogle official Разработка ★ 462

Что делает навык

Firebase AI Logic позволяет интегрировать генеративный ИИ (модели Gemini) в мобильные и веб-приложения напрямую через клиентские SDK, минуя необходимость в собственном бэкенде. Skill охватывает настройку SDK, поддержку мультимодального ввода, потоковую передачу ответов, структурированный вывод JSON и обеспечение безопасности через App Check.

Когда применять

  • Создание клиентских веб-приложений с функциями чата или генерации текста без развертывания серверной части.
  • Анализ мультимедийных данных (изображений, аудио, видео, PDF) непосредственно в приложении с использованием Gemini.
  • Реализация потоковой передачи ответов (streaming) для улучшения пользовательского опыта в интерфейсах.
  • Обеспечение безопасности API-запросов и защита от несанкционированного использования квот через App Check.
  • Динамическое управление версиями моделей ИИ с помощью Firebase Remote Config без необходимости обновления клиентского кода.

Как работает

  1. Установить Node.js 16+ и npm, затем выполнить команду 'npm install firebase@latest' для получения Web SDK.
  2. Выполнить 'npx -y firebase-tools@latest init ailogic' для инициализации SDK и автоматического включения Gemini Developer API в консоли Firebase.
  3. Настроить App Check для защиты приложения: для локальной разработки использовать отладочные токены (Debug Tokens), а для продакшена — зарегистрировать реальные токены в Firebase Console.
  4. Использовать методы 'generateContent' для текстовых запросов или 'generateContentStream' для потоковой передачи ответов.
  5. При работе с файлами размером более 20 МБ загружать их в Cloud Storage for Firebase и передавать URL в API, чтобы избежать ошибок HTTP 413.
  6. Проверять документацию Firebase AI Logic Models для использования актуальных имен моделей (избегая устаревших, таких как gemini-2.0-pro).

Примеры запросов агенту

Как настроить App Check для веб-приложения в режиме локальной разработки с использованием отладочного токена?
Напиши код на JavaScript для инициализации Firebase AI Logic и отправки мультимодального запроса с изображением.
Как реализовать потоковую передачу ответов от Gemini в веб-интерфейсе с помощью generateContentStream?

Что понадобится

  • Node.js 16+ и npm
  • Аккаунт Firebase с проектом и включенным Gemini Developer API (или Blaze plan для Agent Platform)
  • Настроенный App Check (для безопасного использования в продакшене)

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «firebase-firebase-ai-logic-basics» из репозитория: # https://github.com/firebase/agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r firebase-firebase-ai-logic-basics/ ~/.claude/skills/firebase-firebase-ai-logic-basics/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.