Pierwsze kroki z interfejsem Gemini API przy użyciu pakietów SDK Vertex AI dla Firebase


Z tego przewodnika dowiesz się, jak zacząć wywoływać interfejs Vertex AI Gemini API bezpośrednio z poziomu aplikacji za pomocą pakietów SDK Vertex AI dla Firebase.

Wymagania wstępne

W tym przewodniku zakładamy, że potrafisz korzystać z Xcode do tworzenia aplikacji na platformy Apple (np. na iOS).

  • Upewnij się, że Twoje środowisko programistyczne i aplikacja na platformach Apple spełniają te 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 przypadków użycia lub użyć przykładowej aplikacji, jeśli nie masz własnej aplikacji platformy Apple. Aby z niej korzystać, musisz połączyć ją 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

  1. W konsoli Firebase otwórz stronę Build with Gemini (Utwórz z Gemini) i kliknij drugą kartę, aby uruchomić przepływ pracy, który pomoże Ci wykonać poniższe zadania. Jeśli w konsoli wyświetli się karta Vertex AI, oznacza to, że te zadania zostały wykonane.

  2. 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 (patrz poprzedni krok) możesz dodać do swojej aplikacji pakiet SDK Vertex AI dla Firebase.

Biblioteka Vertex AI dla Firebase zapewnia dostęp do interfejsu Vertex AI Gemini API i jest częścią pakietu SDK Firebase dla platform Apple (firebase-ios-sdk). W przypadku biblioteki Vertex AI dla Firebase musisz użyć usługi Swift Package Manager, aby zainstalować zależności Firebase i nimi zarządzać. Inne menedżery pakietów, takie jak CocoaPods, nie są obecnie obsługiwane.

  1. Po otwarciu projektu aplikacji przejdź w Xcode do File > Add Packages (Plik > Dodaj pakiety).

  2. Gdy pojawi się prośba, dodaj repozytorium SDK platform Apple Platform SDK Firebase:

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

  3. Wybierz najnowszą wersję pakietu SDK.

  4. Wybierz bibliotekę FirebaseVertexAI-Preview.

    Po zakończeniu Xcode automatycznie rozpocznie rozpoznawanie i pobieranie 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ć usługę Vertex AI i model generatywny.

  1. Zaimportuj moduł FirebaseVertexAI:

    import FirebaseVertexAI

  2. 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-preview-0514")

Po skorzystaniu z przewodnika dla początkujących dowiedz się, jak wybrać model Gemini i (opcjonalnie) lokalizację odpowiednią do Twojego przypadku użycia i aplikacji.

Krok 4. Wywołaj interfejs Vertex AI Gemini API

Po połączeniu aplikacji z Firebase, dodaniu pakietu SDK oraz zainicjowaniu usługi Vertex AI i modelu generatywnego możesz zacząć wywoływać interfejs Vertex AI Gemini API.

Za pomocą generateContent() możesz wygenerować tekst na podstawie żądania promptu tekstowego:

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

// 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 modelach dostępnych w różnych przypadkach użycia oraz ich limitach i cenach.

Wypróbuj inne możliwości interfejsu Gemini API

Dowiedz się, jak kontrolować generowanie treści

Możesz też eksperymentować z promptami i konfiguracjami modeli za pomocą Vertex AI Studio.


Prześlij opinię na temat korzystania z Vertex AI dla Firebase