Vertex AI in Firebase è stato lanciato in disponibilità generale (GA) il 21 ottobre 2024.
Se hai utilizzato la versione beta della libreria Vertex AI in Firebase
(firebase-vertexai:16.0.0-betaXX
), devi apportare le seguenti modifiche per eseguire l'upgrade e utilizzare la versione GA della libreria
(firebase-vertexai:16.0.0
o successiva).
Ecco un elenco generale delle modifiche necessarie per la migrazione:
- Abilita la nuova API richiesta nel tuo progetto Firebase (obbligatoria per tutti)
- Eseguire l'aggiornamento alla versione GA della libreria (obbligatorio per tutti)
- Modifiche aggiuntive (obbligatorie a seconda delle funzionalità utilizzate)
Abilita la nuova API richiesta nel tuo progetto Firebase (obbligatoria per tutti)
Devi attivare l'API Vertex AI in Firebase nel tuo progetto Firebase e aggiungerla alla lista consentita della chiave API Firebase. Si tratta di una nuova API necessaria per utilizzare la versione GA di Vertex AI in Firebase.
Nella console Firebase, vai alla pagina Esegui il build con Gemini.
Nella scheda Vertex AI in Firebase, fai clic su Inizia per avviare un flusso di lavoro che ti aiuti ad abilitare questa API e aggiungerla alla lista consentita della tua chiave API Firebase.
Puoi saltare il resto del flusso di lavoro nella console.
Eseguire l'aggiornamento alla versione GA della libreria (obbligatorio per tutti)
Segui queste istruzioni per aggiornare le dipendenze in modo da utilizzare la versione più recente di Firebase Android BoM. L'utilizzo di BoM non è obbligatorio, ma ti consigliamo vivamente di utilizzarlo perché contribuisce a garantire che la tua app utilizzi versioni compatibili di ogni libreria Firebase.
Nel file Gradle del modulo (a livello di app) (di solito
<project>/<app-module>/build.gradle.kts
o<project>/<app-module>/build.gradle)
, sostituisci la dipendenza per Vertex AI in Firebase con quanto segue:// 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") }Sincronizza il tuo progetto Android con i file Gradle.
Tieni presente che, se scegli di non utilizzare Firebase BoM, devi solo accettare la versione più recente di Firebase BoM suggerita da Android Studio.firebase-vertexai
Modifiche aggiuntive (obbligatorie a seconda delle funzionalità utilizzate)
Sono state implementate diverse modifiche per le versioni GA degli SDK. Esamina i seguenti elenchi per verificare eventuali modifiche che potresti dover apportare al codice per supportare l'utilizzo della versione GA dell'SDK nella tua app.
Chiamata di funzioni
Se hai implementato questa funzionalità prima del lancio ufficiale, dovrai apportare aggiornamenti alla modalità di definizione dello schema. Ti consigliamo di consultare la guida alle chiamate delle funzioni aggiornata per scoprire come scrivere le dichiarazioni delle funzioni.Generare output strutturato (ad es. JSON) utilizzando
responseSchema
Se hai implementato questa funzionalità prima del lancio ufficiale, dovrai apportare aggiornamenti alla definizione dello schema. Ti consigliamo di consultare la nuova guida all'output strutturato per scoprire come scrivere schemi JSON.Timeout
- È stato modificato il timeout predefinito per le richieste in 180 secondi.
Enumerazioni
I corsi
enum
esealed
sono stati sostituiti da corsi regolari. Questa variazione consente una maggiore flessibilità per l'evoluzione dell'API in modo compatibile con le versioni precedenti.L'enumerazione
BlockThreshold
è stata rinominata inHarmBlockThreshold
.Sono stati rimossi i valori dalle seguenti enumerazioni:
HarmBlockThreshold
,HarmProbability
,HarmSeverity
,BlockReason
eFinishReason
.
Metodi blob
- Tutti i metodi che includevano
Blob
nel nome sono stati rinominati in modo da utilizzareInlineData
.
- Tutti i metodi che includevano
Impostazioni di sicurezza
- Il campo
method
è stato modificato in modo da poter essere null.
- Il campo
Classe Duration
- Sono stati rimossi tutti gli utilizzi della classe
Duration
di Kotlin e sostituiti conlong
. Questa modifica offre una migliore interoperabilità con Java.
- Sono stati rimossi tutti gli utilizzi della classe
Metadati delle citazioni
- Ho inserito tutti i campi precedentemente dichiarati in
CitationMetadata
in una nuova classe denominataCitation
. Le citazioni sono disponibili nell'elenco chiamatocitations
inCitationMetadata
. Questa modifica consente un migliore allineamento tra i tipi su più piattaforme.
- Ho inserito tutti i campi precedentemente dichiarati in
Conteggio token
- Il campo
totalBillableCharacters
è stato modificato in modo da poter essere null.
- Il campo
Caratteri fatturabili totali
- È stata modificata la proprietà
totalBillableCharacters
inCountTokensResponse
in modo che sia facoltativa per riflettere le situazioni in cui non vengono inviati caratteri.
- È stata modificata la proprietà
Istanziazione di un modello
- Il parametro
requestOptions
è stato spostato alla fine dell'elenco dei parametri in modo da allinearsi alle altre piattaforme.
- Il parametro
Possibili errori relativi alla migrazione
Durante la migrazione alla versione GA di Vertex AI in Firebase, potresti riscontrare errori se non hai completato tutte le modifiche richieste come descritto in questa guida alla migrazione.
Errore 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.
Se ricevi un errore 403 con il messaggio
Requests to this API firebasevertexai.googleapis.com ... are blocked.
,
in genere significa che la chiave API nell'oggetto/nel file di configurazione di Firebase
non ha un'API richiesta nella lista consentita per il prodotto che stai tentando
di utilizzare.
Assicurati che la chiave API utilizzata dalla tua app includa tutte le API richieste incluse nella lista consentita "Restrizioni API" della chiave. Per Vertex AI in Firebase, la chiave API deve avere almeno l'API Vertex AI in Firebase nella lista consentita. Questa API dovrebbe essere stata aggiunta automaticamente alla lista consentita della chiave API quando hai abilitato la nuova API tramite la console Firebase.
Puoi visualizzare tutte le tue chiavi API nel riquadro API e servizi > Credenziali della console Google Cloud.