Inizia a utilizzare l'API Gemini utilizzando Vertex AI negli SDK Firebase

Questa guida spiega come iniziare a effettuare chiamate al Vertex AI Gemini API direttamente dalla tua app utilizzando SDK Vertex AI in Firebase per la piattaforma scelta.

Prerequisiti

Questa guida presuppone che tu abbia familiarità con l'utilizzo di Xcode per sviluppare app piattaforme Apple (come iOS).

• Assicurati che il tuo ambiente di sviluppo e l'app delle piattaforme Apple soddisfino le i seguenti requisiti:

  • Xcode 15.0 o successivo
  • La tua app deve avere come target iOS 15 o versioni successive oppure macOS 12 o versioni successive.

• (Facoltativo) Dai un'occhiata all'app di esempio.

  Scarica l'app di esempio

  Puoi provare rapidamente l'SDK, visualizzare un'implementazione completa dei vari utilizzi o usare l'app di esempio se non hai un'app per le piattaforme Apple. Per utilizzare l'app di esempio, devi la colleghi a un progetto Firebase.

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

Se disponi già di un progetto Firebase e di un'app collegata a Firebase

1. Nella console Firebase, vai a Pagina Crea con Gemini.

2. Fai clic sulla scheda Vertex AI in Firebase per avviare un flusso di lavoro che ti aiuta a completare le seguenti attività. Tieni presente che se nella console è presente una scheda perVertex AI, queste attività sono state completate.

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

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

3. Vai al passaggio successivo di questa guida per aggiungere l'SDK alla tua app.

Se non hai già un progetto Firebase e un'app collegata a Firebase

Passaggio 2: aggiungi l'SDK

Dopo aver configurato il progetto Firebase e aver collegato l'app a Firebase (vedi il passaggio precedente), ora puoi aggiungere l'SDK Vertex AI in Firebase alla tua app.

La libreria Vertex AI in Firebase consente di accedere a Vertex AI Gemini API ed è incluso come parte dell'SDK Firebase per Piattaforme Apple (firebase-ios-sdk). Per la raccolta Vertex AI in Firebase, Per installare e gestire Firebase devi utilizzare Swift Package Manager delle dipendenze. Altri gestori pacchetti, come CocoaPods, non sono attualmente supportati.

1. In Xcode, con il progetto dell'app aperto, vai a File > Aggiungi pacchetti.

2. Quando richiesto, aggiungi il repository dell'SDK delle piattaforme Apple Firebase:

     https://github.com/firebase/firebase-ios-sdk
   

3. Seleziona la versione più recente dell'SDK.

4. Seleziona la raccolta FirebaseVertexAI-Preview.

   Al termine, Xcode inizierà automaticamente a risolvere e a scaricare le tue dipendenze in background.

Passaggio 3: inizializza il servizio Vertex AI e il modello generativo

Prima di poter effettuare chiamate API, devi inizializzare Vertex AI e il modello generativo.

1. Importa il modulo FirebaseVertexAI:

   import FirebaseVertexAI
   

2. Inizializza il servizio Vertex AI e il modello generativo:

   import FirebaseVertexAI
   
   // Initialize the Vertex AI service
   let vertex = VertexAI.vertexAI()
   
   // Initialize the generative model with a model that supports your use case
   // Gemini 1.5 models are versatile and can be used with all API capabilities
   let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
   

Al termine della guida introduttiva, scopri come scegliere un modello Gemini e, facoltativamente, un luogo appropriato per il tuo caso d'uso e la tua app.

Passaggio 4: chiama il numero Vertex AI Gemini API

Ora che hai collegato la tua app a Firebase, aggiunto l'SDK e inizializzato il servizio Vertex AI e il modello generativo, puoi chiamare Vertex AI Gemini API.

Puoi utilizzare generateContent() per generare testo da un prompt di solo testo richiesta:

import FirebaseVertexAI

// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()

// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
if let text = response.text {
  print(text)
}

Cos'altro puoi fare?

Scopri di più sui modelli Gemini

Prova altre funzionalità di Gemini API

• Scopri di più sulla generazione di testo da prompt di solo testo, incluse le istruzioni su come la risposta in un flusso di dati.
• Genera testo da prompt multimodali (inclusi testo, immagini, PDF, video e audio).
• Crea conversazioni a più turni (chat).
• Usa le chiamate di funzione per connetterti di modelli generativi a sistemi e informazioni esterni.

Scopri come controllare la generazione di contenuti

• Comprendere la progettazione dei prompt, ad esempio: best practice, strategie e prompt di esempio.
• Configura parametri del modello come della temperatura e del numero massimo di token di output.
• Utilizza le impostazioni di sicurezza per regolare la probabilità di ricevere risposte che potrebbero essere considerate dannose.

Fornisci feedback la tua esperienza con Vertex AI in Firebase