firebase/firebase-ai-logic-basics

Skill oficial para integrar Firebase AI Logic (API Gemini) em aplicações web. Abrange configuração, inferência multimodal, saída estruturada e segurança.

O que é firebase-ai-logic-basics?

Este skill fornece uma base completa para integrar o Firebase AI Logic (baseado na API Gemini) em aplicações web. Ele é útil para desenvolvedores que desejam adicionar funcionalidades de inteligência artificial generativa, como geração de texto estruturado, análise multimodal (texto, imagens) e habilidades de raciocínio, diretamente em seus projetos web hospedados no Firebase. O skill cobre desde a configuração inicial do ambiente e autenticação, até exemplos práticos de chamadas de inferência, uso de prompts e validação de saída. Também inclui orientações sobre práticas de segurança, como o uso de regras de segurança do Firebase para proteger o acesso à API. É compatível com as plataformas Firebase e Google Cloud, sendo ideal para prototipagem rápida e implementação de soluções de IA em produção.

Funciona com~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/firebase/agent-skills/tree/main/skills/firebase-ai-logic-basics

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que firebase-ai-logic-basics faz?

Skill oficial para integrar Firebase AI Logic (API Gemini) em aplicações web. Abrange configuração, inferência multimodal, saída estruturada e segurança.

Introdução

Este skill fornece uma base para usar o Firebase AI Logic (API Gemini) em suas aplicações web. Com ele, você pode:

  • Configurar o Firebase e o Gemini SDK
  • Realizar inferências com entrada multimodal (texto, imagens)
  • Gerar saída estruturada (por exemplo, JSON)
  • Implementar medidas de segurança

Pré-requisitos

  • Conta no Firebase e um projeto ativo
  • SDK do Firebase configurado (v9+)
  • Chave de API do Gemini ou configuração via Firebase Authentication

Configuração

  1. Instale as dependências:
npm install firebase @google/generative-ai
  1. Inicialize o Firebase e o Gemini no seu app:
import { initializeApp } from 'firebase/app';
import { getGenerativeAI } from '@google/generative-ai';

const firebaseConfig = {
  apiKey: "SUA_API_KEY",
  authDomain: "SEU_PROJETO.firebaseapp.com",
  projectId: "SEU_PROJETO"
};

const app = initializeApp(firebaseConfig);
const genAI = getGenerativeAI(app, { apiKey: "SUA_CHAVE_GEMINI" });
  1. Use o modelo:
const model = genAI.getGenerativeModel({ model: "gemini-pro" });

async function gerarResposta(prompt) {
  const result = await model.generateContent(prompt);
  return result.response.text();
}

Exemplos de Uso

Inferência Multimodal

Envie texto e imagem:

import { GoogleGenerativeAI } from "@google/generative-ai";

const genAI = new GoogleGenerativeAI("SUA_CHAVE");
const model = genAI.getGenerativeModel({ model: "gemini-pro-vision" });

const prompt = "Descreva esta imagem";
const image = {
  inlineData: {
    data: "base64_encoded_image...",
    mimeType: "image/png"
  }
};

const result = await model.generateContent([prompt, image]);
console.log(result.response.text());

Saída Estruturada

Solicite resposta em formato JSON:

const prompt = `
  Gere uma lista de tarefas no formato JSON:
  [{"tarefa": "descrição", "prioridade": "alta|média|baixa"}]
`;
const result = await model.generateContent(prompt);
const tasks = JSON.parse(result.response.text());

Segurança

  • Use regras de segurança do Firebase Firestore para restringir acesso
  • Nunca exponha sua chave de API no frontend sem autenticação
  • Considere usar funções Cloud Functions para chamadas sensíveis

Recursos

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

firebase/developing-genkit-dart

Generates code and provides documentation for the Genkit Dart SDK. Use when the user asks to build AI agents in Dart, use Genkit flows, or integrate LLMs into Dart/Flutter applications.

firebase/developing-genkit-go

Develop AI-powered applications using Genkit in Go. Use when the user asks to build AI features, agents, flows, or tools in Go using Genkit, or when working with Genkit Go code involving generation, prompts, streaming, tool calling, or model providers.

firebase/developing-genkit-js

Develop AI-powered applications using Genkit in Node.js/TypeScript. Use when the user asks about Genkit, AI agents, flows, or tools in JavaScript/TypeScript, or when encountering Genkit errors, validation issues, type errors, or API problems.

firebase/developing-genkit-python

Develop AI-powered applications using Genkit in Python. Use when the user asks about Genkit, AI agents, flows, or tools in Python, or when encountering Genkit errors, import issues, or API problems.

firebase/firebase-ai-logic

Official skill for integrating Firebase AI Logic (Gemini API) into web applications. Covers setup, multimodal inference, structured output, and security.

firebase/firebase-app-hosting-basics

Deploy and manage web apps with Firebase App Hosting. Use this skill when deploying Next.js/Angular apps with backends.

firebase/firebase-auth-basics

Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.

firebase/firebase-basics

Provides foundational setup, authentication, and project management workflows for Firebase using the Firebase CLI. Use when checking Firebase CLI version (must use 'npx -y firebase-tools@latest --version'), initializing a Firebase environment, authenticating, setting active projects, or setting up `google-services.json` or `GoogleService-Info.plist` files.

firebase/firebase-crashlytics

Comprehensive guide for Firebase Crashlytics, including provisioning and SDK usage. Use this skill when the user needs help setting up Crashlytics, adding crash reporting, or using the Crashlytics SDK in their application.

firebase/firebase-data-connect

Builds and deploys Firebase SQL Connect (aka Firebase Data Connect) backends with PostgreSQL securely. Use when designing schemas with tables and relations, writing authorized queries and mutations, configuring real-time data updates, or generating type-safe SDKs. Use when you need a relational database with Firebase, or when the user mentions SQL Connect or Data Connect.

firebase/firebase-firestore

Sets up, manages, and executes queries against Cloud Firestore database instances, including advanced native full-text search and relational joins using pipelines. You MUST unconditionally activate this skill if you plan to use Firestore in any way. Use when listing or creating Firestore databases, configuring security rules, designing data models, writing client SDK queries (including search/joins), or checking indexes.

firebase/firebase-firestore-basics

Comprehensive guide for Firestore basics including provisioning, security rules, and SDK usage. Use this skill when the user needs help setting up Firestore, writing security rules, or using the Firestore SDK in their application.

firebase/firebase-firestore-enterprise-native-mode

Comprehensive guide for Firestore enterprise native including provisioning, data model, security rules, and SDK usage. Use this skill when the user needs help setting up Firestore Enterprise with the Native mode, writing security rules, or using the Firestore SDK in their application.

firebase/firebase-firestore-standard

Comprehensive guide for Firestore Standard Edition, including provisioning, security rules, and SDK usage. Use this skill when the user needs help setting up Firestore, writing security rules, or using the Firestore SDK in their application.

firebase/firebase-hosting-basics

Skill for working with Firebase Hosting (Classic). Use this when you want to deploy static web apps, Single Page Apps (SPAs), or simple microservices. Do NOT use for Firebase App Hosting.

firebase/firebase-local-env-setup

Bare minimum INITIAL setup for getting started with Firebase (Node.js, CLI installation, first-time login). Use ONLY for first-time setup. For updating, troubleshooting, or refreshing an existing environment, use the firebase-basics skill instead.

firebase/firebase-remote-config-basics

Comprehensive guide for Firebase Remote Config, including template management and SDK usage. Use this skill when the user needs help setting up Remote Config, managing feature flags, or updating app behavior dynamically.

firebase/firebase-security-rules-auditor

A skill to evaluate how secure Firestore security rules are. Use this when Firestore security rules are updated to ensure that the generated rules are extremely secure and robust.

firebase/firestore-security-rules-auditor

A skill to evaluate how secure Firestore security rules are. Use this when Firestore security rules are updated to ensure that the generated rules are extremely secure and robust.

firebase/xcode-project-setup

Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).

Habilidades Relacionadas