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)
- Auf die GA-Version der Bibliothek aktualisieren (für alle erforderlich)
- Weitere Änderungen (je nach verwendeten Funktionen erforderlich)
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.
Rufen Sie in der Firebase Console die Seite Mit Gemini erstellen auf.
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.
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.
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") }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
- undsealed
-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 inHarmBlockThreshold
umbenannt.Werte aus den folgenden Aufzählungen wurden entfernt:
HarmBlockThreshold
,HarmProbability
,HarmSeverity
,BlockReason
undFinishReason
.
Blob-Methoden
- Alle Methoden, die
Blob
im Namen enthielten, wurden inInlineData
umbenannt.
- Alle Methoden, die
Sicherheitseinstellungen
- Das Feld
method
wurde in ein Feld mit Nullwerten geändert.
- Das Feld
Dauerklasse
- Alle Verwendungen der Kotlin-Klasse
Duration
wurden entfernt und durchlong
ersetzt. Diese Änderung ermöglicht eine bessere Interoperabilität mit Java.
- Alle Verwendungen der Kotlin-Klasse
Zitatmetadaten
- Alle zuvor in
CitationMetadata
deklarierten Felder wurden in eine neue Klasse namensCitation
verpackt. Verweise finden Sie inCitationMetadata
in der Listecitations
. Dadurch können die Typen plattformübergreifend besser abgeglichen werden.
- Alle zuvor in
Tokens zählen
- Das Feld
totalBillableCharacters
wurde in ein Feld mit Nullwerten geändert.
- Das Feld
Abrechnungsfähige Zeichen insgesamt
- Die Eigenschaft
totalBillableCharacters
inCountTokensResponse
wurde zu einer optionalen Eigenschaft, um Situationen widerzuspiegeln, in denen keine Zeichen gesendet werden.
- Die Eigenschaft
Modell instanziieren
- Der Parameter
requestOptions
wurde ans Ende der Parameterliste verschoben, um ihn mit anderen Plattformen in Einklang zu bringen.
- Der Parameter
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.