Erste Schritte mit der Gemini API mithilfe der Vertex AI in Firebase SDKs


In diesem Leitfaden erfahren Sie, wie Sie mit dem Vertex AI in Firebase SDK für die von Ihnen ausgewählte Plattform direkt über Ihre App Aufrufe an Vertex AI Gemini API senden.

Vorbereitung

In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Entwicklung von Apps mit Flutter vertraut sind.

  • Ihre Entwicklungsumgebung und Ihre Flutter-App müssen die folgenden Anforderungen erfüllen:

    • Dart 3.2.0 oder höher
  • Optional: Sehen Sie sich die Beispiel-App an.

    Beispielanwendung herunterladen

    Sie können das SDK schnell ausprobieren, sich eine vollständige Implementierung verschiedener Anwendungsfälle ansehen oder die Beispiel-App verwenden, wenn Sie keine eigene Flutter-App haben. Um die Beispiel-App zu verwenden, müssen Sie sie mit einem Firebase-Projekt verknüpfen.

Schritt 1: Firebase-Projekt einrichten und App mit Firebase verknüpfen

Wenn Sie bereits ein Firebase-Projekt und eine mit Firebase verbundene App haben

  1. Rufen Sie in der Firebase Console die Seite Mit Gemini erstellen auf.

  2. Klicke auf die Karte Vertex AI in Firebase, um einen Workflow zu starten, mit dem du die folgenden Aufgaben erledigen kannst:

  3. Fahren Sie mit dem nächsten Schritt in dieser Anleitung fort, um das SDK Ihrer App hinzuzufügen.

Wenn Sie noch kein Firebase-Projekt und keine mit Firebase verknüpfte App haben

  1. Melden Sie sich in der Firebase-Konsole an.

  2. Klicken Sie auf Projekt erstellen und wählen Sie eine der folgenden Optionen aus:

    • Option 1: Sie können ein neues Firebase-Projekt (und das zugrunde liegende Google Cloud-Projekt) erstellen, indem Sie im ersten Schritt des Workflows „Projekt erstellen“ einen neuen Projektnamen eingeben.

    • Option 2: Sie können einem vorhandenen Google Cloud-Projekt „Firebase hinzufügen“, indem Sie im ersten Schritt des Workflows „Projekt erstellen“ den Namen Ihres Google Cloud-Projekts aus dem Drop-down-Menü auswählen.

    Wenn du dazu aufgefordert wirst, musst du Google Analytics nicht einrichten, um die Vertex AI in Firebase SDKs zu verwenden.

  3. Rufen Sie in der Firebase Console die Seite Mit Gemini erstellen auf.

  4. Klicke auf die Karte Vertex AI in Firebase, um einen Workflow zu starten, mit dem du die folgenden Aufgaben erledigen kannst:

  1. Installieren Sie die erforderlichen Befehlszeilentools:

    1. Installieren Sie die Firebase-Befehlszeile, falls noch nicht geschehen.

    2. Melden Sie sich mit Ihrem Google-Konto in Firebase an. Führen Sie dazu den folgenden Befehl aus:

      firebase login
      
    3. Führen Sie den folgenden Befehl in einem beliebigen Verzeichnis aus, um die FlutterFire CLI zu installieren:

      dart pub global activate flutterfire_cli
      
  2. Konfigurieren Sie Ihre Apps für die Verwendung von Firebase:

    Konfigurieren Sie Ihre Flutter-Apps mit der FlutterFire CLI für die Verbindung mit Firebase.

    Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um den App-Konfigurationsablauf zu starten:

    flutterfire configure
    

    Der flutterfire configure-Workflow führt Folgendes aus:

    • Sie werden aufgefordert, die in Ihrer Flutter-App unterstützten Plattformen (iOS, Android, Web) auszuwählen. Für jede ausgewählte Plattform erstellt die FlutterFire CLI eine neue Firebase-App in Ihrem Firebase-Projekt.

      Sie können entweder ein vorhandenes Firebase-Projekt verwenden oder ein neues Firebase-Projekt erstellen. Wenn Sie bereits Apps in einem vorhandenen Firebase-Projekt registriert haben, versucht die FlutterFire-Befehlszeile, sie anhand der aktuellen Flutter-Projektkonfiguration abzugleichen.

    • Erstellt eine Firebase-Konfigurationsdatei (firebase_options.dart) und fügt sie dem lib/-Verzeichnis Ihrer Flutter-App hinzu.

  3. In den nächsten Schritten dieser Anleitung fügen Sie Ihrer App das Vertex AI in Firebase SDK hinzu und führen die erforderliche Initialisierung für die Verwendung des SDKs und des Gemini API durch.


Schritt 2: SDK hinzufügen

Nachdem Sie Ihr Firebase-Projekt eingerichtet und Ihre App mit Firebase verbunden haben (siehe vorheriger Schritt), können Sie Ihrer App jetzt das Vertex AI in Firebase SDK hinzufügen.

Das Vertex AI in Firebase-Plug-in für Flutter (firebase_vertexai) bietet Zugriff auf die Vertex AI Gemini API.

  1. Führen Sie im Verzeichnis Ihres Flutter-Projekts den folgenden Befehl aus, um das Kern-Plug-in und das Vertex AI in Firebase-Plug-in zu installieren:

    flutter pub add firebase_core && flutter pub add firebase_vertexai
    
  2. Importieren Sie in die Datei lib/main.dart das Firebase-Kern-Plug-in, das Vertex AI in Firebase-Plug-in und die zuvor generierte Konfigurationsdatei:

    import 'package:firebase_core/firebase_core.dart';
    import 'package:firebase_vertexai/firebase_vertexai.dart';
    import 'firebase_options.dart';
    
  3. Initialisieren Sie Firebase in der Datei lib/main.dart mit dem DefaultFirebaseOptions-Objekt, das von der Konfigurationsdatei exportiert wurde:

    await Firebase.initializeApp(
      options: DefaultFirebaseOptions.currentPlatform,
    );
    
  4. So erstellen Sie Ihre Flutter-Anwendung neu:

    flutter run
    

Schritt 3: Vertex AI-Dienst und generatives Modell initialisieren

Bevor Sie API-Aufrufe ausführen können, müssen Sie den Vertex AI-Dienst und das generative Modell initialisieren.

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

Nachdem Sie die Anleitung zum Einstieg durchgearbeitet haben, erfahren Sie, wie Sie ein Gemini-Modell und (optional) einen Standort auswählen, der für Ihren Anwendungsfall und Ihre App geeignet ist.

Schritt 4: Vertex AI Gemini API anrufen

Nachdem Sie Ihre App mit Firebase verbunden, das SDK hinzugefügt und den Vertex AI-Dienst und das generative Modell initialisiert haben, können Sie Vertex AI Gemini API aufrufen.

Mit generateContent() können Sie Text aus einer Promptanfrage mit reinem Text generieren:

import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
final model =
      FirebaseVertexAI.instance.generativeModel(model: 'gemini-2.0-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Was können Sie sonst noch tun?

Weitere Informationen zu den Gemini-Modellen

Hier finden Sie Informationen zu den Modellen, die für verschiedene Anwendungsfälle verfügbar sind, sowie zu ihren Kontingenten und Preisen.

Weitere Funktionen des Gemini API ausprobieren

Inhaltserstellung steuern

Mit Vertex AI Studio können Sie auch mit Prompts und Modellkonfigurationen experimentieren.


Feedback zu Vertex AI in Firebase geben