Premiers pas avec l'API Gemini à l'aide des SDK Vertex AI in Firebase

Ce guide vous explique comment commencer à effectuer des appels à Vertex AI Gemini API directement à partir de votre application à l'aide du SDK Vertex AI in Firebase pour la plate-forme de votre choix.

Prérequis

Ce guide part du principe que vous savez utiliser Xcode pour développer des applications pour sur les plates-formes Apple (comme iOS).

• Assurez-vous que votre environnement de développement et l'application des plates-formes Apple respectent les conditions suivantes:

  • Xcode 15.0 ou version ultérieure
  • Votre application doit cibler iOS 15 ou version ultérieure, ou macOS 12 ou version ultérieure.

• (Facultatif) Découvrez l'application exemple.

  Télécharger l'application exemple

  Vous pouvez essayer le SDK rapidement, voir une implémentation complète de diverses fonctions ou utilisez l'application exemple si vous ne disposez pas de votre propre application pour plates-formes Apple. Pour utiliser l'application exemple, vous devez : la connecter à un projet Firebase.

Étape 1 : Configurer un projet Firebase et associer votre application à Firebase

Si vous disposez déjà d'un projet Firebase et d'une application connectée à Firebase

1. Dans la console Firebase, accédez à la page Compiler avec Gemini.

2. Cliquez sur la fiche Vertex AI in Firebase pour lancer un workflow qui vous aidera effectuez les tâches suivantes. (Notez que si un onglet s'affiche dans la console pour Vertex AI, cela signifie que ces tâches sont terminées.)

   • Mettez à niveau votre projet pour utiliser le forfait Blaze.

   • Activez les deux API suivantes pour votre projet:
     aiplatform.googleapis.com et firebaseml.googleapis.com

3. Passez à l'étape suivante de ce guide pour ajouter le SDK à votre application.

Si vous ne disposez pas encore d'un projet Firebase et d'une application associée à Firebase

Étape 2 : Ajouter le SDK

Votre projet Firebase configuré et votre application connectée à Firebase (voir l'étape précédente), vous pouvez maintenant ajouter le SDK Vertex AI in Firebase à votre application.

La bibliothèque Vertex AI in Firebase permet d'accéder au Vertex AI Gemini API et est incluse dans le SDK Firebase pour Plates-formes Apple (firebase-ios-sdk) Pour la bibliothèque Vertex AI in Firebase, vous devez utiliser Swift Package Manager pour installer et gérer Firebase les dépendances. Les autres gestionnaires de paquets, tels que CocoaPods, ne sont actuellement pas compatibles.

1. Dans Xcode, ouvrez le projet de votre application, puis accédez à File > Ajouter des packages.

2. Lorsque vous y êtes invité, ajoutez le dépôt du SDK des plates-formes Firebase pour Apple :

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

3. Sélectionnez la dernière version du SDK.

4. Sélectionnez la bibliothèque FirebaseVertexAI-Preview.

   Une fois l'opération terminée, Xcode lance automatiquement la résolution et le téléchargement les dépendances en arrière-plan.

Étape 3 : Initialisez le service Vertex AI et le modèle génératif

Avant de pouvoir effectuer des appels d'API, vous devez initialiser Vertex AI et le modèle génératif.

1. Importez le module FirebaseVertexAI :

   import FirebaseVertexAI
   

2. Initialisez le service Vertex AI et le modèle génératif:

   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")
   

Une fois que vous avez terminé le guide de démarrage, découvrez comment choisir un modèle Gemini et (facultatif) une position adaptée à votre cas d'utilisation et à votre application.

Étape 4: Appelez la méthode Vertex AI Gemini API

Maintenant que vous avez connecté votre application à Firebase, ajouté le SDK et initialisé le service Vertex AI et le modèle génératif, vous êtes prêt à appeler Vertex AI Gemini API.

Vous pouvez utiliser generateContent() pour générer du texte à partir d'une requête textuelle uniquement requête:

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)
}

Qu'est-ce que tu sais faire d'autre ?

En savoir plus sur les modèles Gemini

Essayez d'autres fonctionnalités de Gemini API

• En savoir plus sur la génération de texte à partir de des requêtes textuelles uniquement, y compris concernant diffuser la réponse.
• Générer du texte à partir de requêtes multimodales (y compris du texte, des images, des PDF, des vidéos et de l'audio).
• Créez des conversations multitours (chat).
• Utiliser l'appel de fonction pour vous connecter des modèles génératifs aux systèmes et informations externes.

Découvrez comment contrôler la génération de contenu.

• Découvrez la conception des requêtes, y compris les bonnes pratiques, les stratégies et les exemples de requêtes.
• Configurer les paramètres du modèle : et le nombre maximal de jetons de sortie.
• Utilisez les paramètres de sécurité pour ajuster de recevoir des réponses susceptibles d'être considérées comme nuisibles.

Envoyer des commentaires sur votre expérience avec Vertex AI in Firebase