Firebase SDK'larında Vertex AI'ı kullanarak Gemini API'yi kullanmaya başlama


Bu kılavuz, Vertex AI Gemini API öğesini kullanarak doğrudan uygulamanızdan Seçtiğiniz platform için Vertex AI in Firebase SDK'sı.

Ön koşullar

Bu kılavuzda, Android Studio'da Android Studio'yu kullanarak Android için uygulamalar.

1. adım: Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın

Zaten bir Firebase projeniz ve Firebase'e bağlı bir uygulamanız varsa

  1. Firebase konsolunda şuna gidin: Build with Gemini (Gemini ile Derleme) sayfasını ziyaret edin.

  2. Aşağıdaki görevleri tamamlamanıza yardımcı olacak bir iş akışı başlatmak için Vertex AI in Firebase kartını tıklayın. (Konsolda Vertex AI, bu görevler tamamlanmış demektir.)

  3. SDK'yı uygulamanıza eklemek için bu kılavuzun bir sonraki adımına geçin.

Firebase projesiniz ve Firebase'e bağlı uygulamanız yoksa


2. adım: SDK'yı ekleyin

Firebase projeniz hazır olduğunda ve uygulamanız Firebase'e bağlandığında (önceki adıma bakın) artık Vertex AI in Firebase SDK'sını uygulamanıza ekleyebilirsiniz.

Android için Vertex AI in Firebase SDK'sı (firebase-vertexai), Vertex AI Gemini API erişimi.

Modülünüz (uygulama düzeyi) Gradle yapılandırma dosyanızda (<project>/<app-module>/build.gradle.kts gibi), Android için Vertex AI in Firebase SDK'sı:

Kotlin+KTX 

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Vertex AI in Firebase SDK for Android
  implementation("com.google.firebase:firebase-vertexai:16.0.0-beta06")
}

Java

Java için iki kitaplık daha eklemeniz gerekir.

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Vertex AI in Firebase SDK for Android
  implementation("com.google.firebase:firebase-vertexai:16.0.0-beta06")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

3. Adım: Vertex AI hizmetini ve üretken modeli başlatın

API çağrısı yapabilmek için Vertex AI hizmetini ve üretken modeli ilk kez başlatmanız gerekir.

Kotlin+KTX

Kotlin için bu SDK'daki yöntemler, askıya alma işlevleridir ve koordinasyon kapsamından alınmıştır. 
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")

Java

Java için bu SDK'daki akış yöntemleri, Reactive Streams kitaplığındaki bir Publisher türü döndürür. 
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-1.5-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

Başlangıç kılavuzunu tamamladığınızda, Gemini modeli ve (isteğe bağlı olarak) konuma uygun olduğundan emin olun.

4. adım: Vertex AI Gemini API

Uygulamanızı Firebase'e bağladığınıza, SDK'yı eklediğinize, Vertex AI hizmetini ve üretken modeli başlattığınıza göre Vertex AI Gemini API işlevini çağırmaya hazırsınız.

Yalnızca metin içeren bir istem isteğinden metin oluşturmak için generateContent() kullanabilirsiniz:

Kotlin+KTX

Kotlin için bu SDK'daki yöntemler, askıya alma işlevleridir ve koordinasyon kapsamından alınmıştır. 
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
val generativeModel = Firebase.vertexAI.generativeModel("gemini-1.5-flash")

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = generativeModel.generateContent(prompt)
print(response.text)

Java

Java için bu SDK'daki yöntemler ListenableFuture döndürür. 
// Initialize the Vertex AI service and the generative model
// Specify a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("gemini-1.5-flash");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

Başka ne yapabilirsiniz?

Gemini modelleri hakkında daha fazla bilgi

Çeşitli kullanım alanları için kullanılabilen modeller ve bunların kotaları ile fiyatlandırması hakkında bilgi edinin.

Gemini API'ün diğer özelliklerini deneyin

İçerik üretme işlemini nasıl kontrol edeceğinizi öğrenin

Ayrıca, model yapılandırmalarınızı ve istemlerinizi görmek için Vertex AI Studio


Vertex AI in Firebase ile ilgili deneyiminiz hakkında geri bildirim verin