Vertex AI in Firebase est disponible pour tous les utilisateurs depuis le 21 octobre 2024.
Si vous avez utilisé la version bêta de la bibliothèque Vertex AI in Firebase (firebase-vertexai:16.0.0-betaXX
), vous devez apporter les modifications suivantes pour passer à la version GA de la bibliothèque (firebase-vertexai:16.0.0
ou version ultérieure).
Voici une liste des modifications requises pour la migration:
- Activez la nouvelle API requise dans votre projet Firebase (obligatoire pour tous)
- Passer à la version GA de la bibliothèque (obligatoire pour tous)
- Modifications supplémentaires (obligatoires selon les fonctionnalités que vous utilisez)
Activez la nouvelle API requise dans votre projet Firebase (obligatoire pour tous).
Vous devez activer l'API Vertex AI in Firebase dans votre projet Firebase et l'ajouter à la liste d'autorisation de votre clé API Firebase. Il s'agit d'une nouvelle API requise pour utiliser la version GA de Vertex AI in Firebase.
Dans la console Firebase, accédez à la page Build with Gemini (Développer avec Gemini).
Dans la fiche Vertex AI in Firebase, cliquez sur Commencer pour lancer un workflow qui vous aide à activer cette API et à l'ajouter à la liste d'autorisation de votre clé API Firebase.
Vous pouvez ignorer le reste du workflow dans la console.
Passez à la version GA de la bibliothèque (obligatoire pour tous)
Suivez ces instructions pour mettre à jour vos dépendances afin d'utiliser la dernière version de Firebase Android BoM. L'utilisation de BoM n'est pas obligatoire, mais nous vous la recommandons vivement, car elle permet de vous assurer que votre application utilise des versions compatibles de chaque bibliothèque Firebase.
Dans votre fichier Gradle de module (au niveau de l'application) (généralement
<project>/<app-module>/build.gradle.kts
ou<project>/<app-module>/build.gradle)
), remplacez la dépendance pour Vertex AI in Firebase par la suivante:// 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") }Synchronisez votre projet Android avec les fichiers Gradle.
Notez que si vous choisissez de ne pas utiliser Firebase BoM, il vous suffit d'accepter la dernière version de firebase-vertexai
suggérée par Android Studio.
Modifications supplémentaires (obligatoires selon les fonctionnalités que vous utilisez)
Plusieurs modifications ont été apportées aux versions GA des SDK. Consultez les listes suivantes pour identifier les modifications que vous devrez peut-être apporter à votre code afin d'utiliser la version GA du SDK dans votre application.
Appel de fonction
Si vous avez implémenté cette fonctionnalité avant la version GA, vous devrez modifier la façon dont vous définissez votre schéma. Nous vous recommandons de consulter le guide d'appel de fonction mis à jour pour savoir comment écrire vos déclarations de fonction.Générer une sortie structurée (comme JSON) à l'aide de
responseSchema
Si vous avez implémenté cette fonctionnalité avant la version GA, vous devrez modifier la façon dont vous définissez votre schéma. Nous vous recommandons de consulter le nouveau guide de sortie structurée pour apprendre à écrire des schémas JSON.Délai avant expiration
- Le délai avant expiration par défaut des requêtes a été défini sur 180 secondes.
Énumérations
Remplacement des classes
enum
etsealed
par des classes standards. Ce changement offre plus de flexibilité pour faire évoluer l'API de manière rétrocompatible.L'énumération
BlockThreshold
a été rebaptiséeHarmBlockThreshold
.Suppression de valeurs des énumérations suivantes:
HarmBlockThreshold
,HarmProbability
,HarmSeverity
,BlockReason
etFinishReason
.
Méthodes Blob
- Toutes les méthodes qui incluaient
Blob
dans leur nom ont été rebaptisées et utilisent désormaisInlineData
.
- Toutes les méthodes qui incluaient
Paramètres de sécurité
- Le champ
method
est défini comme nullable.
- Le champ
Catégorie de durée
- Suppression de toutes les utilisations de la classe
Duration
de Kotlin et remplacement parlong
. Cette modification améliore l'interopérabilité avec Java.
- Suppression de toutes les utilisations de la classe
Métadonnées de citation
- Encapsulation de tous les champs précédemment déclarés dans
CitationMetadata
dans une nouvelle classe appeléeCitation
. Les citations se trouvent dans la liste appeléecitations
dansCitationMetadata
. Cette modification permet un meilleur alignement des types sur les plates-formes.
- Encapsulation de tous les champs précédemment déclarés dans
Compter les jetons
- Le champ
totalBillableCharacters
est défini comme nullable.
- Le champ
Nombre total de caractères facturables
- La propriété
totalBillableCharacters
dansCountTokensResponse
a été définie comme facultative pour refléter les situations où aucun caractère n'est envoyé.
- La propriété
Instancier un modèle
- Le paramètre
requestOptions
a été déplacé à la fin de la liste des paramètres pour s'aligner sur les autres plates-formes.
- Le paramètre
Erreurs possibles liées à la migration
Lorsque vous passez à la version GA de Vertex AI in Firebase, vous pouvez rencontrer des erreurs si vous n'avez pas effectué toutes les modifications requises, comme décrit dans ce guide de migration.
Erreur 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Si vous recevez une erreur 403 indiquant Requests to this API firebasevertexai.googleapis.com ... are blocked.
, cela signifie généralement que la clé API de votre fichier/objet de configuration Firebase ne contient pas d'API requise dans sa liste d'autorisation pour le produit que vous essayez d'utiliser.
Assurez-vous que la clé API utilisée par votre application inclut toutes les API requises dans la liste d'autorisation "Restrictions d'API" de la clé. Pour Vertex AI in Firebase, votre clé API doit inclure au moins l'API Vertex AI in Firebase dans sa liste d'autorisation. Cette API aurait dû être automatiquement ajoutée à la liste d'autorisation de votre clé API lorsque vous avez activé la nouvelle API via la console Firebase.
Vous pouvez afficher toutes vos clés API dans le panneau API et services > Identifiants de la console Google Cloud.