Zur GA-Version von Vertex AI in Firebase migrieren


Vertex AI in Firebase wurde am 21. Oktober 2024 allgemein verfügbar gemacht.

Wenn Sie die Betaversion der Vertex AI in Firebase-Bibliothek (firebase-vertexai:16.0.0-betaXX) verwendet haben, müssen Sie die folgenden Änderungen vornehmen, um auf die GA-Version der Bibliothek (firebase-vertexai:16.0.0 oder höher) umzustellen.

Hier eine allgemeine Liste der für die Migration erforderlichen Änderungen:

Aktivieren Sie die neue erforderliche API in Ihrem Firebase-Projekt (für alle erforderlich)

Sie müssen die Vertex AI in Firebase API in Ihrem Firebase-Projekt aktivieren und sie der Zulassungsliste Ihres Firebase API-Schlüssels hinzufügen. Dies ist eine neue API, die für die Verwendung der GA-Version von Vertex AI in Firebase erforderlich ist.

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

  2. Klicken Sie auf der Karte Vertex AI in Firebase auf Jetzt starten, um einen Workflow zu starten, mit dem Sie diese API aktivieren und der Zulassungsliste Ihres Firebase API-Schlüssels hinzufügen können.

  3. Sie können den Rest des Workflows in der Console überspringen.

Auf die GA-Version der Bibliothek aktualisieren (für alle erforderlich)

Folgen Sie dieser Anleitung, um Ihre Abhängigkeiten auf die neueste Version der Firebase Android BoM zu aktualisieren. Die Verwendung von BoM ist nicht erforderlich, wird aber dringend empfohlen, da so sichergestellt werden kann, dass Ihre App kompatible Versionen der einzelnen Firebase-Bibliotheken verwendet.

  1. Ersetzen Sie in der Gradle-Datei des Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle)) die Abhängigkeit für Vertex AI in Firebase durch Folgendes:

    // BEFORE
    dependencies {
      implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
    }
    
    // AFTER
    dependencies {
      // Import the BoM for the Firebase platform
      implementation(platform("com.google.firebase:firebase-bom:33.10.0"))
    
      // Add the dependency for the Vertex AI in Firebase library
      // When using the BoM, you don't specify versions in Firebase library dependencies
      implementation("com.google.firebase:firebase-vertexai")
    }
  2. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Wenn Sie die Firebase BoM nicht verwenden möchten, akzeptieren Sie einfach die neueste Version von Firebase BoM, die von Android Studio vorgeschlagen wird.firebase-vertexai

Weitere Änderungen (je nach verwendeten Funktionen erforderlich)

Für die GA-Versionen der SDKs wurden mehrere Änderungen implementiert. In den folgenden Listen finden Sie alle Änderungen, die Sie möglicherweise an Ihrem Code vornehmen müssen, um die GA-Version des SDK in Ihrer App zu verwenden.

  • Funktionsaufruf
    Wenn Sie diese Funktion vor der allgemeinen Verfügbarkeit implementiert haben, müssen Sie die Definition Ihres Schemas aktualisieren. Weitere Informationen zum Erstellen von Funktionsdeklarationen finden Sie im aktualisierten Leitfaden zu Funktionsaufrufen.

  • Strukturierte Ausgabe (z. B. JSON) mit responseSchema
    generieren Wenn Sie diese Funktion vor der allgemeinen Verfügbarkeit implementiert haben, müssen Sie die Definition Ihres Schemas aktualisieren. Weitere Informationen zum Erstellen von JSON-Schemas finden Sie im neuen Leitfaden für strukturierte Datenausgaben.

  • Zeitlimit

    • Das Standardzeitlimit für Anfragen wurde auf 180 Sekunden geändert.
  • Aufzählungen

    • enum- und sealed-Klassen wurden durch reguläre Klassen ersetzt. Diese Änderung ermöglicht eine größere Flexibilität bei der Weiterentwicklung der API auf abwärtskompatible Weise.

    • Die Aufzählung BlockThreshold wurde in HarmBlockThreshold umbenannt.

    • Werte aus den folgenden Aufzählungen wurden entfernt: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason und FinishReason.

  • Blob-Methoden

    • Alle Methoden, die Blob im Namen enthielten, wurden in InlineData umbenannt.
  • Sicherheitseinstellungen

    • Das Feld method wurde in ein Feld mit Nullwerten geändert.
  • Dauerklasse

    • Alle Verwendungen der Kotlin-Klasse Duration wurden entfernt und durch long ersetzt. Diese Änderung ermöglicht eine bessere Interoperabilität mit Java.
  • Zitatmetadaten

    • Alle zuvor in CitationMetadata deklarierten Felder wurden in eine neue Klasse namens Citation verpackt. Verweise finden Sie in CitationMetadata in der Liste citations. Dadurch können die Typen plattformübergreifend besser abgeglichen werden.
  • Tokens zählen

    • Das Feld totalBillableCharacters wurde in ein Feld mit Nullwerten geändert.
  • Abrechnungsfähige Zeichen insgesamt

    • Die Eigenschaft totalBillableCharacters in CountTokensResponse wurde zu einer optionalen Eigenschaft, um Situationen widerzuspiegeln, in denen keine Zeichen gesendet werden.
  • Modell instanziieren

    • Der Parameter requestOptions wurde ans Ende der Parameterliste verschoben, um ihn mit anderen Plattformen in Einklang zu bringen.

Mögliche Fehler bei der Migration

Wenn Sie zur GA-Version von Vertex AI in Firebase migrieren, können Fehler auftreten, wenn Sie nicht alle erforderlichen Änderungen wie in diesem Migrationsleitfaden beschrieben vorgenommen haben.

403-Fehler: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Wenn Sie den 403-Fehler Requests to this API firebasevertexai.googleapis.com ... are blocked. erhalten, bedeutet das in der Regel, dass der API-Schlüssel in Ihrer Firebase-Konfigurationsdatei/Ihrem Firebase-Konfigurationsobjekt keine erforderliche API auf der Zulassungsliste für das Produkt hat, das Sie verwenden möchten.

Der von Ihrer App verwendete API-Schlüssel muss alle erforderlichen APIs enthalten, die in der Zulassungsliste „API-Einschränkungen“ des Schlüssels aufgeführt sind. Für Vertex AI in Firebase muss Ihr API-Schlüssel mindestens die Vertex AI in Firebase API auf der Zulassungsliste haben. Diese API sollte der Zulassungsliste Ihres API-Schlüssels automatisch hinzugefügt worden sein, als Sie die neue API über die Firebase-Konsole aktiviert haben.

Sie können alle Ihre API-Schlüssel in der Google Cloud-Console im Bereich APIs & Dienste > Anmeldedaten aufrufen.