Pierwsze kroki z interfejsem Gemini {/8}API za pomocą Vertex AI w pakietach SDK Firebase

Ten przewodnik pokazuje, jak zacząć wywoływać interfejs Vertex AI Gemini API bezpośrednio z aplikacji za pomocą pakietu SDK Vertex AI in Firebase przeznaczonego dla wybranej platformy.

Wymagania wstępne

W tym przewodniku zakładamy, że wiesz, jak używać Xcode do tworzenia aplikacji na platformy Apple (np. iOS).

• Upewnij się, że środowisko programistyczne i aplikacja na platformy Apple spełniają te wymagania:

  • Xcode 15.0 lub nowsza
  • Aplikacja musi być kierowana na system iOS 15 lub nowszy albo macOS 12 lub nowszy.

• (Opcjonalnie) Zapoznaj się z przykładową aplikacją.

  Pobierz przykładową aplikację

  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 na platformy Apple. Aby użyć przykładowej aplikacji, musisz połączyć ją z projektem Firebase.

Krok 1. Skonfiguruj projekt Firebase i połącz z nim aplikację.

Jeśli masz już projekt Firebase i aplikację połączoną z Firebase

1. W konsoli Firebase otwórz stronę Tworzenie za pomocą Gemini.

2. Kliknij kartę Vertex AI in Firebase, aby uruchomić przepływ pracy, który pomoże Ci wykonać te czynności:

   • Przekształć projekt, aby korzystać z abonamentu Blaze z płatnością według wykorzystania.

   • Włącz wymagane interfejsy API w projekcie (interfejs API Vertex AI i interfejs API Vertex AI in Firebase).

3. Aby dodać pakiet SDK do aplikacji, przejdź do następnego kroku w tym przewodniku.

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 niej pakiet SDK Vertex AI in Firebase.

Do instalacji zależności Firebase i zarządzania nimi możesz używać menedżera pakietów Swift.

Biblioteka Vertex AI in Firebase zapewnia dostęp do interfejsu Vertex AI Gemini API i jest uwzględniona w pakiecie SDK Firebase na platformy Apple (firebase-ios-sdk).

1. Po otwarciu projektu aplikacji w Xcode wybierz Plik > Dodaj pakiety.

2. Gdy pojawi się prośba, dodaj repozytorium pakietu SDK Firebase na platformy Apple:

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

3. Wybierz najnowszą wersję pakietu SDK.

4. Wybierz bibliotekę FirebaseVertexAI.

   Gdy to zrobisz, Xcode automatycznie zacznie wyszukiwać i pobierać zależności w tle.

Krok 3. Inicjuj usługę Vertex AI i model generatywny

Zanim będzie można wykonać jakiekolwiek 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")
   

Po przeczytaniu tego przewodnika dowiesz się, jak wybrać model Gemini i (opcjonalnie) lokalizację odpowiednią do Twojego przypadku użycia i aplikacji.

Krok 4. Zadzwoń do Vertex AI Gemini API

Po połączeniu aplikacji z Firebase, dodaniu pakietu SDK i inicjalizacji usługi Vertex AI oraz modelu generatywnego możesz wywołać funkcję Vertex AI Gemini API.

Możesz użyć generateContent(), aby wygenerować tekst z 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")

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

Co jeszcze możesz zrobić?

Więcej informacji o modelach Gemini

Wypróbuj inne możliwości Gemini API

• Dowiedz się więcej o generowaniu tekstu na podstawie promptów tekstowych, w tym o przesyłaniu odpowiedzi.
• generować tekst na podstawie promptów multimodalnych (w tym tekst, obrazy, pliki PDF, filmy i pliki audio).
• tworzyć rozmowy wieloetapowe (czat);
• generować dane wyjściowe w uporządkowanym formacie (np. JSON) na podstawie zarówno tekstowych, jak i wielomodalnych promptów;
• Użyj funkcji wywoływania, aby połączyć modele generatywne z zewnętrznymi systemami i informacjami.

Dowiedz się, jak kontrolować generowanie treści

• Poznaj projektowanie promptów, w tym sprawdzone metody, strategie i przykładowe prompty.
• Skonfiguruj parametry modelu, takie jak temperatura i maksymalne tokeny danych wyjściowych.
• Używaj ustawień bezpieczeństwa, aby dostosować prawdopodobieństwo otrzymywania odpowiedzi, które mogą być uważane za szkodliwe.

Prześlij opinię o tym, jak oceniasz korzystanie z usługi Vertex AI in Firebase