Creare conversazioni in più passaggi (chat) con l'API Gemini

iOS e versioni successive Android Web Flutter

Con Gemini API puoi creare conversazioni in formato libero in più turni. L'SDK Vertex AI in Firebase semplifica la procedura gestendo lo stato della conversazione, quindi, a differenza di generateContentStream() o generateContent(), non devi memorizzare autonomamente la cronologia delle conversazioni.

Altre opzioni per lavorare con il Gemini API

• Facoltativamente, puoi provare una versione alternativa "Google AI" di Gemini API
  per ottenere l'accesso senza costi (entro i limiti e se disponibile) utilizzando Google AI Studio e gli SDK client Google AI. Questi SDK devono essere utilizzati solo per la prototipazione nelle app web e mobile.

  Quando avrai acquisito familiarità con il funzionamento di Gemini API, esegui la migrazione ai nostri SDK Vertex AI in Firebase (questa documentazione), che offre molte funzionalità aggiuntive importanti per le app web e mobile, come la protezione dell'API da comportamenti illeciti tramite Firebase App Check e il supporto per file multimediali di grandi dimensioni nelle richieste.

• Facoltativamente, chiama il lato server Vertex AI Gemini API (ad esempio con Python, Node.js o Go)
  Utilizza gli SDK Vertex AI lato server, Firebase Genkit o Firebase Extensions per Gemini API.

Prima di iniziare

Se non l'hai ancora fatto, completa la guida introduttiva agli SDK Vertex AI in Firebase. Assicurati di avere eseguito tutte le seguenti operazioni:

1. Imposta un progetto Firebase nuovo o esistente, incluso l'utilizzo del piano tariffario Blaze e l'abilitazione delle API richieste.

2. Collega la tua app a Firebase, inclusa la registrazione e l'aggiunta della configurazione Firebase.

3. Aggiungi l'SDK e inizializza il servizio Vertex AI e il modello generativo nella tua app.

Dopo aver connesso la tua app a Firebase, aggiunto l'SDK e inizializzato il servizio Vertex AI e il modello generativo, puoi chiamare Gemini API.

Invia una richiesta di prompt di chat

Per creare una conversazione in più passaggi (come la chat), inizia inizializzando la chat chiamando startChat(). Quindi, utilizza sendMessageStream() (o sendMessage()) per inviare un nuovo messaggio dell'utente, che aggiungerà anche il messaggio e la risposta alla cronologia della chat.

Esistono due possibili opzioni per role associate ai contenuti di una conversazione:

• user: il ruolo che fornisce i prompt. Questo valore è il valore predefinito per le chiamate a sendMessageStream() (o sendMessage()) e la funzione genera un'eccezione se viene passato un ruolo diverso.

• model: il ruolo che fornisce le risposte. Questo ruolo può essere utilizzato durante la chiamata a startChat() con history esistente.

Nota: se vuoi fornire un contesto iniziale più ampio al modello per aiutarlo a indirizzarne il comportamento in base alle tue esigenze e ai tuoi casi d'uso specifici, ti consigliamo di impostare le istruzioni di sistema.

Scegli se vuoi riprodurre la risposta in streaming (sendMessageStream) o attendere la risposta fino a quando non viene generato l'intero risultato (sendMessage).

Streaming

Puoi ottenere interazioni più rapide non aspettando l'intero risultato della generazione del modello, ma utilizzando lo streaming per gestire i risultati parziali.

Senza streaming

In alternativa, puoi attendere l'intero risultato anziché lo streaming. Il risultato viene restituito solo dopo che il modello ha completato l'intero processo di generazione.

Scopri come scegliere un modello Gemini e, facoltativamente, una posizione appropriata per il tuo caso d'uso e la tua app.

Cos'altro puoi fare?

• Scopri come contare i token prima di inviare prompt lunghi al modello.
• Configura Cloud Storage for Firebase per includere file di grandi dimensioni nelle richieste multimodali utilizzando Cloud Storage URL. I file possono includere immagini, PDF, video e audio.
• Inizia a pensare alla preparazione per la produzione, inclusa la configurazione di Firebase App Check per proteggere Gemini API da comportamenti illeciti da parte di clienti non autorizzati.

Provare altre funzionalità di Gemini API

• Genera testo da prompt di solo testo.
• Genera testo da prompt multimodali (inclusi testo, immagini, PDF, video e audio).
• Genera output strutturato (come JSON) da prompt di testo e multimodali.
• Utilizza le chiamate di funzione per collegare i modelli generativi a sistemi e informazioni esterni.

Scopri come controllare la generazione di contenuti

• Comprendi la progettazione dei prompt, tra cui best practice, strategie e prompt di esempio.
• Configura i parametri del modello, come la temperatura e i token di output massimi.
• Utilizza le impostazioni di sicurezza per regolare la probabilità di ricevere risposte che potrebbero essere considerate dannose.

Puoi anche sperimentare con i prompt e le configurazioni del modello utilizzando Vertex AI Studio.

Scopri di più sui modelli Gemini

Scopri i modelli disponibili per vari casi d'uso e le relative quote e prezzi.

Fornisci un feedback sulla tua esperienza con Vertex AI in Firebase