Pierwsze kroki z interfejsem Gemini API za pomocą Vertex AI w pakietach SDK Firebase

Z tego przewodnika dowiesz się, jak zacząć dzwonić pod numery Vertex AI Gemini API bezpośrednio w aplikacji za pomocą Pakiet SDK Vertex AI in Firebase dla wybranej platformy.

Wymagania wstępne

W tym przewodniku założyliśmy, że wiesz, jak używać Xcode do tworzenia aplikacji na platformy Apple (np. 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) Sprawdź 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

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 wykonaj te czynności. (Pamiętaj, że jeśli w konsoli widoczna jest karta Vertex AI, te zadania są ukończone).

   • Przenieś projekt na wyższy abonament, aby używać abonament Blaze (płatność według wykorzystania).

   • Włącz w projekcie te 2 interfejsy API:
     aiplatform.googleapis.com oraz firebaseml.googleapis.com

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

Biblioteka Vertex AI in Firebase zapewnia dostęp do pakietu Vertex AI Gemini API i jest częścią pakietu SDK Firebase na platformy Apple (firebase-ios-sdk). W przypadku biblioteki Vertex AI in Firebase do instalacji zależności Firebase i zarządzania nimi musisz używać menedżera pakietów Swift. Inne menedżery pakietów, takie jak CocoaPods, nie są obecnie obsługiwane.

1. W Xcode po otwarciu projektu aplikacji przejdź do File > 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.

   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 wykonywać wywołania interfejsu API, musisz zainicjować Vertex AI i modelu generatywnego.

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 przewodnika dla początkujących dowiedz się, jak wybrać model Gemini i (opcjonalnie) lokalizacja odpowiednią do przypadku użycia i aplikacji.

Krok 4. Zadzwoń pod numer 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 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

Wypróbuj inne funkcje usługi Gemini API

• Dowiedz się więcej o generowaniu tekstu na podstawie promptów tekstowych, w tym o przesyłaniu odpowiedzi.
• Generuj tekst z prompty multimodalne (w tym tekst, obrazy, pliki PDF, filmy i dźwięk).
• tworzyć rozmowy wieloetapowe (czat),
• korzystać 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.

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