Migrieren Sie, um Vertex AI SDKs anstelle von Google AI SDKs zu verwenden

Auf dieser Seite wird beschrieben, wie Sie in Ihren mobilen Apps oder Webanwendungen von den Google AI-Client-SDKs zu den Vertex AI-Client-SDKs für Firebase migrieren. Die Vertex AI SDKs für Firebase sind für Apple-Plattformen (Swift), Android (Kotlin und Java), Web (JavaScript) und Flutter (Dart) verfügbar.

Migrationsanleitung direkt aufrufen

Vorteile der Migration zu Vertex AI

Möglicherweise haben Sie eine alternative Version einer Gemini API mit Google AI Studio oder den KI SDKs von Google ausprobiert. Für Produktions- oder Unternehmensanwendungen, die direkt eine Gemini API aufrufen, empfiehlt Firebase jedoch dringend, die Vertex AI Gemini API mit unseren Firebase SDKs aufzurufen.

Sicherheitsfunktionen für Mobil- und Web-Apps

Bei mobilen Apps und Webanwendungen wird Ihr Code (einschließlich Aufrufen der Gemini API) in einer ungeschützten Umgebung ausgeführt. Sicherheit ist also von entscheidender Bedeutung.

• Standardmäßig wird die Vertex AI Gemini API von Google Cloud IAM autorisiert und nicht von einem API-Schlüssel wie der Google AI Gemini API. Sie können die Vertex AI Gemini API aufrufen, wenn Sie die Vertex AI SDKs for Firebase verwenden.

• Für mobile und Webanwendungen müssen Sie außerdem die Gemini API und Ihre Projektressourcen (z. B. abgestimmte Modelle) vor Missbrauch durch nicht autorisierte Clients schützen. Mit Firebase App Check können Sie prüfen, ob alle API-Aufrufe von Ihrer eigentlichen Anwendung stammen. Dieses Feature ist nur verfügbar, wenn Sie die Vertex AI SDKs für Firebase verwenden.

System für mobile und Web-Apps

Firebase ist die Google-Plattform für die Entwicklung von mobilen Apps und Webanwendungen. Wenn Sie die Vertex AI SDKs für Firebase verwenden, befinden sich Ihre Anwendungen in einem System, das auf die Anforderungen von Full-Stack-Apps und -Entwicklern ausgerichtet ist. Sie können beispielsweise Folgendes und noch vieles mehr ausführen:

• Verwalten Sie strukturierte Daten mit Datenbank-SDKs, die für mobile und Webanwendungen wie Cloud Firestore erstellt wurden.

• Mit Firebase Remote Config lassen sich Laufzeitkonfigurationen dynamisch festlegen.

Features der Vertex AI Gemini API

Die Vertex AI Gemini API bietet auch andere Features als die Google AI Gemini API, z. B. mehr Optionen für multimodale Aufforderungen (insbesondere Text- und Video- sowie Text- und Audioeingabe).

Weitere Informationen zu den Unterschieden zwischen den beiden Gemini API-Angeboten finden Sie in der Google Cloud-Dokumentation.

Weitere Vorteile der Verwendung von Vertex AI von Google Cloud

Wenn Sie generative AI in Ihrer Anwendung und Ihren Workflows besser nutzen, benötigen Sie möglicherweise eine Plattform, die End-to-End-Lösungen zum Erstellen und Bereitstellen von generativen KI-Anwendungen bietet. Google Cloud bietet ein umfassendes Angebot an Tools, mit denen Sie das Potenzial der generativen KI voll ausschöpfen können – von den ersten Phasen der Anwendungsentwicklung über die Anwendungsbereitstellung bis hin zum Anwendungshosting und zur Verwaltung komplexer Daten.

Die Vertex AI-Plattform von Google Cloud bietet eine Reihe von MLOps-Tools, mit denen die Nutzung, Bereitstellung und das Monitoring von KI-Modellen im Hinblick auf Effizienz und Zuverlässigkeit optimiert werden. Darüber hinaus bieten die Einbindung von Datenbanken, DevOps-Tools, Logging, Monitoring und IAM einen ganzheitlichen Ansatz für die Verwaltung des gesamten Lebenszyklus der generativen KI.

Weitere Informationen zu den Anwendungsfällen von Vertex AI finden Sie in der Google Cloud-Dokumentation.

Zu den Vertex AI SDKs for Firebase migrieren

Für die Migration zu den Vertex AI SDKs for Firebase sind drei Hauptschritte erforderlich:

1. Richten Sie ein neues oder vorhandenes Firebase-Projekt ein und verbinden Sie Ihre App mit Firebase.

2. Migrieren Sie die Codebasis. Dafür müssen nur das SDK und der Initialisierungscode (einschließlich des Modellnamens) geändert werden. Der Code, mit dem die Gemini API aufgerufen wird, muss nicht geändert werden.

3. Löschen Sie alle nicht verwendeten API-Schlüssel und deaktivieren Sie nicht verwendete APIs.

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

Auch wenn Sie bereits mit Firebase vertraut sind, sollten Sie diesen Abschnitt lesen, damit Ihr Firebase-Projekt und Ihre Anwendung für die Verwendung der Vertex AI SDKs for Firebase eingerichtet sind.

Sie haben bereits ein Firebase-Projekt und eine App mit Firebase verknüpft

1. Rufen Sie in der Firebase Console die Seite Build with Gemini auf und klicken Sie auf die zweite Karte, um einen Workflow zu starten, mit dem Sie die folgenden Aufgaben ausführen können (sofern diese noch nicht ausgeführt wurden):

   • Führen Sie ein Upgrade Ihres Projekts durch, um das „Blaze“-Preismodell („Pay as you go“) zu verwenden.

   • Aktivieren Sie die folgenden beiden APIs für Ihr Projekt:
     aiplatform.googleapis.com und firebaseml.googleapis.com.

2. Fahren Sie mit dem nächsten Schritt in dieser Anleitung fort, um Ihre Codebasis zu den Vertex AI SDKs for Firebase zu migrieren.

Sie haben noch kein Firebase-Projekt und eine App mit Firebase verknüpft.

1. Melden Sie sich in der Firebase Console an.

2. Klicken Sie auf Projekt erstellen und verwenden Sie dann eine der folgenden Optionen:

   • Option 1: Erstellen Sie ein vollständig neues Firebase-Projekt (und das zugrunde liegende Google Cloud-Projekt automatisch), indem Sie im ersten Schritt des Workflows "Projekt erstellen" einen neuen Projektnamen eingeben.

   • Option 2: „Fügen Sie Firebase zu einem vorhandenen Google Cloud-Projekt hinzu“. Wählen Sie dazu im ersten Schritt des Workflows „Projekt erstellen“ den Namen Ihres Google Cloud-Projekts aus dem Drop-down-Menü aus.

     • Sie können das Google Cloud-Projekt verwenden, das von Google AI Studio für Sie erstellt wurde, als Sie Ihren Google AI API-Schlüssel erstellt haben. Den Namen dieses Projekts finden Sie in Google AI Studio im Abschnitt API-Schlüssel.

     • Sie können ein beliebiges anderes Google Cloud-Projekt verwenden.

   Wenn Sie dazu aufgefordert werden, müssen Sie Google Analytics nicht einrichten, um die Vertex AI SDKs for Firebase zu verwenden.

3. Rufen Sie in der Firebase Console die Seite Build with Gemini auf und klicken Sie auf die zweite Karte, um einen Workflow zu starten, der Sie bei den folgenden Aufgaben unterstützt:

   • Führen Sie ein Upgrade Ihres Projekts durch, um das „Blaze“-Preismodell („Pay as you go“) zu verwenden.

   • Aktivieren Sie die folgenden beiden APIs für Ihr Projekt:
     aiplatform.googleapis.com und firebaseml.googleapis.com.

4. Fahren Sie im Workflow der Console fort, um Ihre App mit Firebase zu verbinden. Dies umfasst folgende Aufgaben:

   • Ihre App wird bei Ihrem Firebase-Projekt registriert.

   • Firebase-Konfiguration zur Codebasis Ihrer App hinzufügen

Schritt 2: Codebasis migrieren

Wählen Sie die Plattform Ihrer App aus, um plattformspezifische Anleitungen aufzurufen.

Die Google AI SDKs und die Vertex AI SDKs für Firebase wurden so entwickelt, dass die Migration zwischen den beiden Plattformen so einfach wie möglich ist.

Für die Migration müssen Sie nur das SDK, das Sie in die Codebasis Ihrer Anwendung einbinden, sowie die Initialisierung des Dienstes und das generative Modell ändern. Sie müssen den Code, der die Gemini API tatsächlich aufruft, nicht ändern.

SDK ändern

Initialisierung ändern

Schritt 3: Nicht verwendete API-Schlüssel löschen und nicht verwendete APIs deaktivieren

Wenn Sie Ihren Google AI API-Schlüssel nicht mehr benötigen, befolgen Sie die Best Practices für die Sicherheit und löschen Sie ihn. Sie können Ihre Google AI API-Schlüssel im Bereich API-Schlüssel von Google AI Studio ansehen und löschen.

Wenn Sie die Google AI Gemini API nicht mehr verwenden, deaktivieren Sie sie in Ihrem Projekt. Dazu können Sie die Google Cloud Console verwenden: generativelanguage.googleapis.com.

Was kannst du sonst noch tun?

• Sowohl Google AI als auch Vertex AI bieten eine Web-UI mit dem Namen „AI Studio“ zum Experimentieren mit Prompts und Modellparametern. In der Google Cloud-Dokumentation erfahren Sie, wie Sie Google AI Studio-Prompts zu Vertex AI Studio migrieren.