Agent Platform Gemini API

Gemini API'yi kullanmaya yeni başladıysanız Android geliştiricileri için önerilen API sağlayıcı Gemini Developer API'dir. Ancak belirli veri konumu şartlarınız varsa veya Google Cloud ekosistemini zaten kullanıyorsanız Gemini Pro ve Flash modellerine erişmek için Firebase AI Logic ile Agent Platform Gemini API'yi (eski adıyla Vertex AI) kullanabilirsiniz.

Başlarken

Agent Platform Gemini API ile doğrudan uygulamanızdan etkileşim kurmadan önce Agent Studio'da istemleri deneyebilirsiniz.

Firebase projesi oluşturma ve uygulamanızı Firebase'e bağlama

API'yi uygulamanızdan çağırmaya hazır olduğunuzda Firebase AI Logic başlangıç kılavuzunun "1. adım" bölümündeki talimatları uygulayarak Firebase'i kurun ve gerekli API'leri ve hizmetleri etkinleştirin.

Gradle bağımlılıklarını ekleme

Uygulama modülünüze aşağıdaki Gradle bağımlılıklarını ekleyin:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.1.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.1.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

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

Yerel geliştirme için Uygulama Kontrolü hata ayıklama sağlayıcısını yapılandırma

Temmuz 2026'nın başlarından itibaren, Firebase Console'da AI Logic için rehberli kurulum iş akışı kapsamında, Gemini API'yi korumak için Firebase Uygulama Kontrolü otomatik olarak zorunlu kılınacak. Yerel geliştirme için Uygulama Kontrolü'nün yaptırımını sürdürürken onayı atlamak üzere Uygulama Kontrolü hata ayıklama sağlayıcısını yapılandırmanız gerekir.

1. Hata ayıklama derlemenizde, Uygulama Kontrolü'nü hata ayıklama sağlayıcı fabrikasını kullanacak şekilde yapılandırın:

   Kotlin

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   Java

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. Hata ayıklama jetonunuzu alın:

   1. Uygulamanızı emülatörde veya test cihazınızda çalıştırın.

   2. Günlüklerinizde Uygulama Kontrolü hata ayıklama jetonunu bulun. Örneğin:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Jetonu (ör. 123a4567-b89c-12d3-e456-789012345678) kopyalayın.

3. Hata ayıklama jetonunuzu Uygulama Kontrolü'ne kaydetme:

   1. Firebase konsolunda Güvenlik > Uygulama Kontrolü > Uygulamalar sekmesine gidin.

   2. Uygulamanızı bulun, taşma menüsünü (more_vert) tıklayın ve ardından Hata ayıklama jetonlarını yönet'i seçin.

   3. Hata ayıklama jetonunuzu kaydetmek için ekrandaki talimatları uygulayın.

Hata ayıklama sağlayıcısı hakkında ayrıntılı bilgi (yeni bir hata ayıklama jetonunun nasıl alınacağı dahil) için resmi Uygulama Kontrolü belgelerine göz atın.

Üretken modeli başlatma

GenerativeModel örneği oluşturup model adını belirterek başlayın:

val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
    .generativeModel("gemini-3.5-flash")
AgentPlatformGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .generativeModel("gemini-3.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
AgentPlatformGeminiApiJava.java

Firebase belgelerinde mevcut Gemini modelleri hakkında daha fazla bilgi edinebilirsiniz. Model parametrelerini yapılandırma hakkında da bilgi edinebilirsiniz.

Metin oluşturun

Metin yanıtı oluşturmak için isteminizle birlikte generateContent() yöntemini çağırın.

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
AgentPlatformGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

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

Gemini Developer API'ye benzer şekilde, yazılı isteminizle birlikte resim, ses, video ve dosya da gönderebilirsiniz. Ayrıntılar için Uygulamanızdan Gemini Developer API ile etkileşim kurma başlıklı makaleyi inceleyin.

Firebase AI Logic SDK hakkında daha fazla bilgi edinmek için Firebase belgelerine bakın.