In dieser Anleitung erfahren Sie, wie Sie Vertex AI Gemini API mit dem Vertex AI in Firebase SDK für die ausgewählte Plattform direkt aus Ihrer App aufrufen können.
Vorbereitung
In diesem Leitfaden wird davon ausgegangen, dass Sie mit Xcode vertraut sind, um Apps für Apple-Plattformen (wie iOS) zu entwickeln.
Achten Sie darauf, dass Ihre Entwicklungsumgebung und die Anwendung der Apple-Plattform die folgenden Anforderungen erfüllen:
- Xcode 15.0 oder höher
- Ihre App muss auf iOS 15 oder höher bzw. macOS 12 oder höher ausgerichtet sein.
(Optional) Sehen Sie sich die Beispiel-App an.
Beispielanwendung herunterladen
Sie können das SDK schnell testen, sich eine vollständige Implementierung verschiedener Anwendungsfälle ansehen oder die Beispiel-App verwenden, wenn Sie keine eigene Apple-Plattform-App haben. Um die Beispiel-App zu verwenden, müssen Sie sie mit einem Firebase-Projekt verbinden.
Schritt 1: Firebase-Projekt einrichten und App mit Firebase verknüpfen
Wenn Sie bereits ein Firebase-Projekt und eine App mit Firebase verknüpft haben
Rufen Sie in der Firebase-Konsole die Seite Build with Gemini auf.
Klicken Sie auf die Karte Vertex AI in Firebase, um einen Workflow zu starten, der Sie beim Ausführen der folgenden Aufgaben unterstützt:
Führen Sie für Ihr Projekt ein Upgrade auf das „Pay as you go“-Preismodell „Blaze“ durch.
Aktivieren Sie die erforderlichen APIs in Ihrem Projekt (Vertex AI API und Vertex AI in Firebase API).
Fahren Sie mit dem nächsten Schritt in dieser Anleitung fort, um Ihrer App das SDK hinzuzufügen.
Wenn noch kein Firebase-Projekt und keine App mit Firebase verbunden ist
Schritt 2: SDK hinzufügen
Wenn Ihr Firebase-Projekt eingerichtet und die App mit Firebase verbunden ist (siehe vorheriger Schritt), können Sie Ihrer App jetzt das Vertex AI in Firebase SDK hinzufügen.
Verwenden Sie Swift Package Manager, um Firebase-Abhängigkeiten zu installieren und zu verwalten.
Die Vertex AI in Firebase-Bibliothek bietet Zugriff auf die Vertex AI Gemini API und ist Teil des Firebase SDK für Apple-Plattformen (firebase-ios-sdk
).
Gehen Sie in Xcode bei geöffnetem App-Projekt zu File > Add Packages (Datei > Pakete hinzufügen).
Fügen Sie bei entsprechender Aufforderung das Firebase Apple Platforms SDK-Repository hinzu:
https://github.com/firebase/firebase-ios-sdk
Wählen Sie die neueste SDK-Version aus.
Wählen Sie die
FirebaseVertexAI
-Bibliothek aus.Anschließend beginnt Xcode automatisch, Ihre Abhängigkeiten aufzulösen und im Hintergrund herunterzuladen.
Schritt 3: Vertex AI-Dienst und generatives Modell initialisieren
Bevor Sie API-Aufrufe ausführen können, müssen Sie den Vertex AI-Dienst und das generative Modell initialisieren.
Importieren Sie das Modul
FirebaseVertexAI
:import FirebaseVertexAI
Initialisieren Sie den Vertex AI-Dienst und das generative Modell:
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")
Wenn du den Startleitfaden gelesen hast, erfährst du, wie du ein Gemini-Modell und (optional) einen Standort für deinen Anwendungsfall und deine App auswählst.
Schritt 4: Vertex AI Gemini API anrufen
Nachdem Sie Ihre App mit Firebase verbunden, das SDK hinzugefügt und den Vertex AI-Dienst und das generative Modell initialisiert haben, können Sie Vertex AI Gemini API aufrufen.
Sie können generateContent()
verwenden, um Text über eine reine Text-Prompt-Anfrage zu generieren:
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)
print(response.text ?? "No text in response.")
Was kannst du noch tun?
Weitere Informationen zu den Gemini-Modellen
Informationen zu den verfügbaren Modellen für verschiedene Anwendungsfälle sowie zu den zugehörigen Kontingenten und Preisen
Weitere Funktionen des Gemini API ausprobieren
- Weitere Informationen zum Generieren von Text aus reine Text-Prompts, einschließlich des Streamens der Antwort.
- Text aus multimodalen Prompts generieren (einschließlich Text, Bildern, PDFs, Videos und Audio).
- Unterhaltungen mit mehreren Themen (Chat) erstellen.
- Sie können sowohl aus Text- als auch aus multimodalen Prompts strukturierte Ausgabe (z. B. JSON) generieren.
- Verwenden Sie Funktionsaufrufe, um generative Modelle mit externen Systemen und Informationen zu verbinden.
Informationen zum Steuern der Inhaltsgenerierung
- Machen Sie sich mit dem Prompt-Entwurf vertraut, einschließlich Best Practices, Strategien und Beispielaufforderungen.
- Konfigurieren Sie Modellparameter wie Temperatur und maximale Ausgabetokens.
- Verwende die Sicherheitseinstellungen, um die Wahrscheinlichkeit anzupassen, dass Antworten erhalten werden, die als schädlich eingestuft werden können.
Feedback zu Vertex AI in Firebase geben