Esegui la migrazione per usare gli SDK Vertex AI anziché gli SDK Google AI

Questa pagina descrive come eseguire la migrazione dagli SDK client di Google AI agli SDK client Vertex AI per Firebase nelle tue app web o mobile. Gli SDK Vertex AI per Firebase sono disponibili per piattaforme Apple (Swift), Android (Kotlin e Java), Web (JavaScript) e Flutter (Dart).

Vai direttamente alle istruzioni per la migrazione

Perché eseguire la migrazione per utilizzare Vertex AI?

Potresti aver provato una versione alternativa di un'API Gemini utilizzando Google AI Studio o gli SDK Google AI. Tuttavia, per le app mobile e web di produzione o di livello aziendale che chiamano direttamente un'API Gemini, Firebase consiglia vivamente di chiamare l'API Vertex AI Gemini utilizzando i nostri SDK Firebase.

Funzionalità di sicurezza per app web e mobile

Per le app web e per dispositivi mobili, il tuo codice (comprese le chiamate all'API Gemini) viene eseguito in un ambiente non protetto, quindi la sicurezza è fondamentale.

• Per impostazione predefinita, l'API Vertex AI Gemini è autorizzata da Google Cloud IAM (anziché da una chiave API come l'API Google AI Gemini). Puoi chiamare l'API Vertex AI Gemini se utilizzi gli SDK Vertex AI per Firebase.

• Per le app web e per dispositivi mobili, devi anche proteggere l'API Gemini e le risorse del tuo progetto (come i modelli ottimizzati) dagli abusi da parte di client non autorizzati. Puoi utilizzare Firebase App Check per verificare che tutte le chiamate API provengano dalla tua app effettiva e questa funzionalità è disponibile solo se utilizzi gli SDK Vertex AI per Firebase.

Ecosistema creato per app web e mobile

Firebase è la piattaforma di Google per lo sviluppo di app web e mobile. L'utilizzo degli SDK Vertex AI per Firebase fa sì che le tue app si trovino in un ecosistema incentrato sulle esigenze di app e sviluppatori full stack. Ad esempio, puoi eseguire una qualsiasi delle seguenti operazioni e molto altro:

• Gestisci i dati strutturati utilizzando gli SDK di database creati per app web e mobile (come Cloud Firestore).

• Imposta dinamicamente le configurazioni del tempo di esecuzione utilizzando Firebase Remote Config.

Funzionalità dell'API Vertex AI Gemini

L'API Vertex AI Gemini offre inoltre funzionalità diverse rispetto all'API Google AI Gemini, come ulteriori opzioni per richieste multimodali (in particolare, input di testo e video e testo e audio).

Puoi scoprire di più sulle differenze tra le due offerte dell'API Gemini nella documentazione di Google Cloud.

Ulteriori vantaggi dell'utilizzo di Vertex AI di Google Cloud

Man mano che l'uso dell'IA generativa nelle tue app e nei tuoi flussi di lavoro matura, potresti aver bisogno di una piattaforma che offra soluzioni end-to-end per la creazione e il deployment di applicazioni di IA generativa. Google Cloud fornisce un ecosistema completo di strumenti per consentirti di sfruttare la potenza dell'IA generativa, dalle fasi iniziali dello sviluppo delle app al deployment delle app, all'hosting delle app e alla gestione di dati complessi su larga scala.

La piattaforma Vertex AI di Google Cloud offre una suite di strumenti MLOps che semplificano l'utilizzo, il deployment e il monitoraggio dei modelli IA in termini di efficienza e affidabilità. Inoltre, le integrazioni con database, strumenti DevOps, logging, monitoraggio e IAM forniscono un approccio olistico alla gestione dell'intero ciclo di vita dell'IA generativa.

Scopri di più sui casi d'uso di Vertex AI nella documentazione di Google Cloud.

Esegui la migrazione agli SDK Vertex AI per Firebase

La migrazione agli SDK Vertex AI per Firebase richiede tre passaggi principali:

1. Configura un progetto Firebase nuovo o esistente e collega la tua app a Firebase.

2. Esegui la migrazione del tuo codebase, che richiede solo la modifica dell'SDK e del codice di inizializzazione (incluso il nome del modello). Non sono necessarie modifiche al codice che chiama effettivamente l'API Gemini.

3. Elimina le chiavi API inutilizzate e disattiva le API inutilizzate.

Passaggio 1: configura un progetto Firebase e collega la tua app a Firebase

Anche se hai già familiarità con Firebase, consulta questa sezione per assicurarti che il tuo progetto e la tua app Firebase siano configurati in modo da utilizzare gli SDK Vertex AI per Firebase.

Hai già un progetto Firebase e un'app collegata a Firebase

1. Nella console Firebase, vai alla pagina Crea con Gemini e fai clic sulla seconda scheda per avviare un flusso di lavoro che ti consente di svolgere le attività seguenti (se non l'hai già fatto):

   • Esegui l'upgrade del progetto per utilizzare il piano tariffario di pagamento a consumo Blaze.

   • Abilita le due API seguenti per il tuo progetto:
     aiplatform.googleapis.com e firebaseml.googleapis.com.

2. Vai al passaggio successivo di questa guida per eseguire la migrazione del tuo codebase per utilizzare gli SDK Vertex AI per Firebase.

Non disponi già di un progetto Firebase e di un'app collegati a Firebase

1. Accedi alla Console di Firebase.

2. Fai clic su Crea progetto, quindi utilizza una delle seguenti opzioni:

   • Opzione 1: crea un progetto Firebase completamente nuovo (e il progetto Google Cloud sottostante automaticamente) inserendo un nuovo nome di progetto nel primo passaggio del flusso di lavoro "Crea progetto".

   • Opzione 2: "Aggiungi Firebase" a un progetto Google Cloud esistente selezionando il nome del progetto Google Cloud dal menu a discesa nel primo passaggio del flusso di lavoro "Crea progetto".

     • Puoi utilizzare il progetto Google Cloud creato per te da Google AI Studio quando hai creato la chiave API Google AI. Puoi trovare il nome del progetto nella sezione Chiave API di Google AI Studio.

     • Puoi utilizzare qualsiasi altro progetto Google Cloud esistente.

   Tieni presente che, quando richiesto, non è necessario configurare Google Analytics per utilizzare gli SDK Vertex AI per Firebase.

3. Nella console Firebase, vai alla pagina Crea con Gemini, quindi fai clic sulla seconda scheda per avviare un flusso di lavoro che ti aiuta a eseguire le attività seguenti:

   • Esegui l'upgrade del progetto per utilizzare il piano tariffario di pagamento a consumo Blaze.

   • Abilita le due API seguenti per il tuo progetto:
     aiplatform.googleapis.com e firebaseml.googleapis.com.

4. Continua nel flusso di lavoro della console per collegare la tua app a Firebase, che include queste attività:

   • Registrazione dell'app con il progetto Firebase.

   • Aggiunta della configurazione Firebase al codebase dell'app.

Passaggio 2: esegui la migrazione del codebase

Seleziona la piattaforma della tua app per visualizzare le relative istruzioni.

Gli SDK Google AI e Vertex AI per Firebase sono stati progettati in modo che la migrazione tra le due piattaforme sia il più semplice possibile.

Per eseguire la migrazione, devi solo modificare l'SDK che integri nel codebase della tua app e l'inizializzazione del servizio e del modello generativo. Non devi modificare il codice che chiama effettivamente l'API Gemini.

Cambiare l'SDK

Modifica l'inizializzazione

Passaggio 3: elimina le chiavi API inutilizzate e disattiva le API inutilizzate

Se non hai più bisogno di utilizzare la chiave API dell'IA di Google, segui le best practice per la sicurezza ed eliminala. Puoi visualizzare ed eliminare le chiavi API dell'IA di Google nella sezione Chiavi API di Google AI Studio.

Inoltre, se non utilizzi più l'API Google AI Gemini, disabilitala nel progetto. Puoi farlo nella console Google Cloud: generativelanguage.googleapis.com.

Che cos'altro puoi fare?

• Sia l'IA di Google che Vertex AI offrono un'esperienza "playground" dell'interfaccia utente web chiamata "AI Studio" per sperimentare con prompt e parametri del modello. Scopri come eseguire la migrazione dei prompt di Google AI Studio a Vertex AI Studio nella documentazione di Google Cloud.