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 di anteprima della libreria Vertex AI in Firebase (firebase/vertexai-preview), devi apportare le seguenti modifiche per eseguire l'upgrade e utilizzare la versione GA della libreria (firebase/vertexai).

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 la base di codice dell'app in modo da utilizzare la versione GA della libreria:

  1. Ottieni la versione più recente dell'SDK Firebase JS per il web utilizzando npm:

    npm i firebase@latest

    OPPURE

    yarn add firebase@latest

  2. Ovunque tu abbia importato la libreria, aggiorna le istruzioni di importazione per utilizzare firebase/vertexai:

    // BEFORE
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";

// AFTER
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "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

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

  • Motivo del blocco

    • blockReason in PromptFeedback è stato modificato in modo da essere facoltativo.

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.