Z tego przewodnika dowiesz się, jak zacząć dzwonić pod numery Vertex AI Gemini API bezpośrednio z aplikacji za pomocą pakiety SDK Vertex AI dla Firebase.
Wymagania wstępne
W tym przewodniku zakładamy, że umiesz używać Xcode do tworzenia aplikacji Platformy Apple (na przykład iOS).
Upewnij się, że Twoje środowisko programistyczne i aplikacja na platformach Apple spełniają wymagania następujące wymagania:
- Xcode w wersji 15.0 lub nowszej
- Aplikacja musi być kierowana na system iOS 15 lub nowszy albo macOS 12 lub nowszy.
(Opcjonalnie) Zobacz przykładową aplikację.
Pobieranie przykładowej aplikacji
Możesz szybko wypróbować pakiet SDK, zobaczyć pełną implementację różnych zastosowań przypadków, a jeśli nie masz własnej aplikacji na platformach Apple, skorzystaj z aplikacji próbnej. Aby użyć przykładowej aplikacji, musisz wykonać połączyć je z projektem Firebase.
Krok 1. Skonfiguruj projekt Firebase i połącz z nią swoją aplikację
Jeśli masz już projekt Firebase i aplikację połączoną z Firebase
W konsoli Firebase otwórz Strona Build with Gemini, a potem kliknij drugą kartę, aby uruchomić przepływ pracy, następujących zadań. Jeśli w konsoli wyświetli się karta Vertex AI, Te zadania są wykonane.
Przenieś projekt na wyższy abonament, aby używać Abonament Blaze z płatnością według wykorzystania
Włącz w projekcie te 2 interfejsy API:
aiplatform.googleapis.com
orazfirebaseml.googleapis.com
Przejdź do następnego kroku tego przewodnika, aby dodać pakiet SDK do aplikacji.
Jeśli nie masz jeszcze projektu Firebase ani aplikacji połączonej z Firebase
Krok 2. Dodaj pakiet SDK
Po skonfigurowaniu projektu Firebase i połączeniu aplikacji z Firebase (zobacz poprzedni krok), możesz teraz dodać pakiet SDK Vertex AI dla Firebase do swojej aplikacji.
Biblioteka Vertex AI dla Firebase zapewnia dostęp do
Vertex AI Gemini API i jest częścią pakietu SDK Firebase dla
Platformy Apple (firebase-ios-sdk
). W przypadku biblioteki Vertex AI dla Firebase
do zainstalowania Firebase i zarządzania nią musisz używać menedżera pakietów Swift
zależności. Inne menedżery pakietów, takie jak CocoaPods, nie są obecnie
obsługiwane.
W Xcode po otwarciu projektu aplikacji przejdź do File > Dodaj pakiety.
Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:
https://github.com/firebase/firebase-ios-sdk
Wybierz najnowszą wersję pakietu SDK.
Wybierz bibliotekę
FirebaseVertexAI-Preview
.Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie lub zależności w tle.
Krok 3. Zainicjuj usługę Vertex AI i model generatywny
Zanim będzie można wykonywać wywołania interfejsu API, musisz zainicjować Vertex AI i modelu generatywnego.
Zaimportuj moduł
FirebaseVertexAI
:import FirebaseVertexAI
Zainicjuj usługę Vertex AI i model generatywny:
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")
Po przeczytaniu przewodnika dla początkujących dowiedz się, jak wybrać model Gemini i (opcjonalnie) lokalizacja odpowiednią do przypadku użycia i aplikacji.
Krok 4. Wywołaj interfejs Vertex AI Gemini API
Po połączeniu aplikacji z Firebase, dodaniu pakietu SDK i zainicjowaniu jej usługę Vertex AI i model generatywny, możesz już wywołać interfejs Vertex AI Gemini API.
Możesz użyć narzędzia generateContent()
, aby wygenerować tekst na podstawie prompta tekstowego
żądanie:
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)
}
Co jeszcze możesz zrobić?
Więcej informacji o modelach Gemini
Dowiedz się więcej o dostępne modele do różnych zastosowań oraz ich poniższych limitów i cen.
Wypróbuj inne możliwości interfejsu Gemini API
- Więcej informacji o generowaniu tekstu z: prompty tekstowe, w tym instrukcje przesyłać odpowiedź strumieniowo.
- Generuj tekst z prompty multimodalne (w tym tekst, obrazy, pliki PDF, filmy i dźwięk).
- tworzyć rozmowy wieloetapowe (czat),
- nawiązać połączenie, korzystając z wywołania funkcji; modeli generatywnych w zewnętrznych systemach i informacjach.
Dowiedz się, jak kontrolować generowanie treści
- Omówienie projektowania promptów, w tym: sprawdzone metody, strategie i przykładowe prompty.
- Skonfiguruj parametry modelu, takie jak oraz maksymalną liczbę tokenów wyjściowych.
- Użyj ustawień bezpieczeństwa, by dostosować prawdopodobieństwo uzyskania odpowiedzi, które mogą zostać uznane za szkodliwe.
Przesyłanie opinii o swoich doświadczeniach z Vertex AI dla Firebase,