Esegui la migrazione per utilizzare la versione GA di Vertex AI in Firebase


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)

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.

  1. Nella console Firebase, vai alla pagina Esegui il build con Gemini.

  2. 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.

  3. 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.

  1. 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")
    }
  2. 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 e sealed 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 in HarmBlockThreshold.

    • Sono stati rimossi i valori dalle seguenti enumerazioni: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason e FinishReason.

  • Metodi blob

    • Tutti i metodi che includevano Blob nel nome sono stati rinominati in modo da utilizzare InlineData.
  • Impostazioni di sicurezza

    • Il campo method è stato modificato in modo da poter essere null.
  • Classe Duration

    • Sono stati rimossi tutti gli utilizzi della classe Duration di Kotlin e sostituiti con long. Questa modifica offre una migliore interoperabilità con Java.
  • Metadati delle citazioni

    • Ho inserito tutti i campi precedentemente dichiarati in CitationMetadata in una nuova classe denominata Citation. Le citazioni sono disponibili nell'elenco chiamato citations in CitationMetadata. Questa modifica consente un migliore allineamento tra i tipi su più piattaforme.
  • Conteggio token

    • Il campo totalBillableCharacters è stato modificato in modo da poter essere null.
  • Caratteri fatturabili totali

    • È stata modificata la proprietà totalBillableCharacters in CountTokensResponse in modo che sia facoltativa per riflettere le situazioni in cui non vengono inviati caratteri.
  • Istanziazione di un modello

    • Il parametro requestOptions è stato spostato alla fine dell'elenco dei parametri in modo da allinearsi alle altre piattaforme.

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.