Google AI SDK'ları yerine Vertex AI SDK'larını kullanma

Bu sayfada, mobil veya web uygulamalarınızda Google AI istemci SDK'larından Vertex AI in Firebase istemci SDK'larına nasıl geçiş yapacağınız açıklanmaktadır. Vertex AI in Firebase SDK'ları Apple platformları (Swift), Android (Kotlin ve Java), Web (JavaScript) ve Flutter (Dart) için kullanılabilir.

Üretim veya kurumsal ölçekte mobil ya da web uygulamaları için Gemini API'i istemci tarafında çağıran Vertex AI in Firebase SDK'larımızı kullanarak Vertex AI Gemini API'i çağırmanız Firebase tarafından önemle tavsiye edilir.

Doğrudan taşıma talimatlarına git

Vertex AI'ü neden kullanmaya başlamalısınız?

Google AI Studio veya Google AI istemci SDK'larını kullanarak Gemini API'ün alternatif bir sürümünü denemiş olabilirsiniz. Bu SDK'lar, Gemini API'ü kullanmaya başlamak ve prototip oluşturmak için faydalıdır. Ancak, Gemini API'yi istemci tarafında doğrudan çağıran üretim veya kurumsal ölçekli mobil ve web uygulamaları için Firebase, Vertex AI Gemini API'ı Firebase SDK'larımızı kullanarak çağırmanızı önemle tavsiye eder.

Mobil ve web uygulamaları için güvenlik özellikleri

Mobil ve web uygulamaları için güvenlik çok önemlidir ve kodunuz (Gemini API çağrıları dahil) korumasız bir ortamda çalıştığından özel dikkat gerektirir.

• Varsayılan olarak Vertex AI Gemini API, Google AI Gemini API gibi bir API anahtarı yerine Google Cloud IAM tarafından yetkilendirilir. Vertex AI in Firebase SDK'ları, daha güvenli Vertex AI Gemini API'ü çağıracak şekilde tasarlanmıştır.

• Mobil ve web uygulamaları için Gemini API'ü ve proje kaynaklarınızı (ayarlanmış modeller gibi) yetkisiz istemciler tarafından kötüye kullanıma karşı korumanız gerekir. Tüm API çağrılarının gerçek uygulamanızdan geldiğini doğrulamak için Firebase App Check'ü kullanabilirsiniz. Bu özellik yalnızca Vertex AI in Firebase SDK'larını kullanıyorsanız kullanılabilir.

Mobil ve web uygulamaları için oluşturulmuş ekosistem

Firebase, Google'ın mobil ve web uygulamaları geliştirme platformudur. Vertex AI in Firebase SDK'larını kullanmak, uygulamalarınızın tam yığın uygulamaların ve geliştiricilerin ihtiyaçlarına odaklanan bir ekosistemde olduğu anlamına gelir. Örneğin, aşağıdakilerden herhangi birini ve daha fazlasını yapmak için hazırsınız:

• Çok modlu isteklerinize büyük dosyalar eklemek için Cloud Storage for Firebase kullanın. Ayrıca, dosya yükleme ve indirme işlemlerini (kötü ağ koşullarında bile) yöneten ve son kullanıcılarınızın verileri için daha fazla güvenlik sunan istemci SDK'larından yararlanın. Cloud Storage for Firebase'u kullanma hakkında çözüm kılavuzumuzdan daha fazla bilgi edinin.

• Mobil ve web uygulamaları için oluşturulmuş veritabanı SDK'larını (ör. Cloud Firestore) kullanarak yapılandırılmış verileri yönetin.

• Firebase Remote Config kullanarak yeni bir uygulama sürümü yayınlamadan çalışma zamanındaki yapılandırmaları (konum gibi) dinamik olarak ayarlayın veya uygulamanızdaki değerleri (model adı gibi) değiştirin.

Google Cloud'dan Vertex AI kullanmanın ek avantajları

Uygulamanızda ve iş akışlarınızda üretken yapay zekayı kullanmaya devam ettikçe üretken yapay zeka uygulamaları oluşturmak ve dağıtmak için uçtan uca çözümler sunan bir platforma ihtiyacınız olabilir. Google Cloud, uygulama geliştirmenin ilk aşamalarından uygulama dağıtımına, uygulama barındırmaya ve karmaşık verileri geniş ölçekte yönetmeye kadar üretken yapay zekanın gücünden yararlanmanıza olanak tanıyan kapsamlı bir araç ekosistemi sunar.

Google Cloud'un Vertex AI platformu, verimlilik ve güvenilirlik için yapay zeka modellerinin kullanımını, dağıtımını ve izlenmesini kolaylaştıran bir MLOps araç paketi sunar. Ayrıca veritabanı, DevOps araçları, günlük kaydı, izleme ve IAM ile entegrasyonlar, üretken yapay zeka yaşam döngüsünün tamamını yönetmek için bütünsel bir yaklaşım sağlar.

Google Cloud dokümanlarında Vertex AI'un kullanım alanları hakkında daha fazla bilgi edinin.

Vertex AI in Firebase SDK'larına geçiş

Vertex AI in Firebase SDK'larına geçiş için üç ana adım gerekir:

1. Yeni veya mevcut bir Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın.

2. Kod tabanınızı taşıyın. Bunun için yalnızca SDK'yı ve başlatma kodunu (model adı dahil) değiştirmeniz gerekir. Gemini API'yi çağıran kodlarda herhangi bir değişiklik yapılması gerekmez.

3. Kullanılmayan API anahtarlarını silin ve kullanılmayan API'leri devre dışı bırakın.

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

Firebase'i zaten biliyor olsanız bile Firebase projenizin ve uygulamanızın Vertex AI in FirebaseSDK'larını kullanacak şekilde ayarlandığından emin olmak için bu bölümü inceleyin.

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

1. Firebase konsolunda Gemini ile oluşturma sayfasına gidin.

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:

   • Projenizi kullandığınız kadar öde Blaze fiyatlandırma planını kullanacak şekilde yükseltin.

   • Projenizde gerekli API'leri (Vertex AI API ve Vertex AI in Firebase API) etkinleştirin.

3. Kod tabanınızı Vertex AI in Firebase SDK'larını kullanacak şekilde taşımak için bu kılavuzun bir sonraki adımına geçin.

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

1. Firebase konsolunda oturum açın.

2. Proje oluştur'u tıklayın ve aşağıdaki seçeneklerden birini kullanın:

   • 1. seçenek: "Proje oluştur" iş akışının ilk adımına yeni bir proje adı girerek tamamen yeni bir Firebase projesi (ve otomatik olarak temel Google Cloud projesi) oluşturun.

   • 2. Seçenek: "Proje oluştur" iş akışının ilk adımındaki açılır menüden Google Cloud proje adınızı seçerek mevcut bir Google Cloud projesine "Firebase ekleyin".

     • Google AI API anahtarınızı oluştururken Google AI Studio tarafından sizin için oluşturulan Google Cloud projesini kullanabilirsiniz. İlgili projenin adını Google AI Studio'nin API anahtarı bölümünde bulabilirsiniz.

     • Mevcut başka bir Google Cloud projesini kullanabilirsiniz.

   İstendiğinde, Vertex AI in Firebase SDK'larını kullanmak için Google Analytics'i ayarlamanıza gerek olmadığını unutmayın.

3. Firebase konsolunda Gemini ile oluşturma sayfasına gidin.

4. 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:

   • Projenizi kullandığınız kadar öde Blaze fiyatlandırma planını kullanacak şekilde yükseltin.

   • Projenizde gerekli API'leri (Vertex AI API ve Vertex AI in Firebase API) etkinleştirin.

5. Uygulamanızı Firebase'e bağlamak için konsolun iş akışında devam edin. Bu iş akışı aşağıdaki görevleri içerir:

   • Uygulamanızı Firebase projenize kaydettirme

   • Firebase yapılandırmanızı uygulamanızın kod tabanına ekleme.

   Not: Bu kılavuzun sonraki adımlarında, uygulamanızın kod tabanını Vertex AI in Firebase SDK'sını ve Vertex AI in Firebase SDK'sını kullanmaya özel başlatma kodunu kullanacak şekilde değiştireceksiniz.

2. Adım: Kod tabanınızı taşıyın

Platforma özel talimatları görüntülemek için uygulamanızın platformunu seçin.

iOS+ Android Web Flutter

Google AI SDK'ları ve Vertex AI in Firebase SDK'ları, iki platform arasında geçişin olabildiğince kolay olması için tasarlanmıştır.

Taşıma işlemi için uygulamanızın kod tabanına entegre ettiğiniz SDK'yı, hizmetin ve üretken modelin başlatılmasını değiştirmeniz yeterlidir. Gemini API işlevini çağıran kodda herhangi bir değişiklik yapmanız gerekmez.

SDK'yı değiştirme

Google AI

Kotlin+KTX

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Google AI client SDK for Android
  implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
  // ... other androidx dependencies

  // add the dependency for the Google AI client SDK for Android
  implementation("com.google.ai.client.generativeai:generativeai:VERSION")

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

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

Vertex AI in Firebase

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

Java

dependencies {
  // ... other androidx dependencies

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

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

İlklemeyi değiştirme

Google AI

Kotlin+KTX

val generativeModel = GenerativeModel(modelName = "MODEL_NAME",
    // Access your API key as a Build Configuration variable
    apiKey = BuildConfig.apiKey
)

Java

GenerativeModel gm = new GenerativeModel("MODEL_NAME",
    // Access your API key as a Build Configuration variable
    BuildConfig.apiKey
);

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

Vertex AI in Firebase

Kotlin+KTX

val generativeModel = Firebase.vertexAI.generativeModel("MODEL_NAME")

Java

GenerativeModel gm = FirebaseVertexAI.getInstance()
        .generativeModel("MODEL_NAME");
GenerativeModelFutures model = GenerativeModelFutures.from(gm);

Not: Vertex AI'e geçiş yaptığınızda, başlatma kodunuzdaki model adını da güncellemeniz gerekebilir. Bunun nedeni, Google AI ve Vertex AI'ün farklı modelleri desteklemesi ve farklı adlandırma biçimleri kullanmasıdır. Vertex AI'te kullanılabilen modeller hakkında bilgi edinmek için Gemini modelleri başlıklı makaleyi inceleyin.

İçe aktarma işlemlerini güncelleme

Aşağıdaki kod snippet'lerinde örnek olarak Chat, Content ve GenerativeModelFutures sınıfları kullanılmıştır ancak aynı durum aynı paket adı altındaki diğer sınıflar için de geçerlidir.

Google AI

Kotlin+KTX

import com.google.ai.client.generativeai.Chat
import com.google.ai.client.generativeai.type.Content
import com.google.ai.client.generativeai.java.GenerativeModuleFutures

Java

import com.google.ai.client.generativeai.Chat;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.java.GenerativeModuleFutures;

Vertex AI in Firebase

Kotlin+KTX

import com.google.firebase.vertexai.Chat
import com.google.firebase.vertexai.type.Content
import com.google.firebase.vertexai.java.GenerativeModuleFutures

Java

import com.google.firebase.vertexai.Chat;
import com.google.firebase.vertexai.type.Content;
import com.google.firebase.vertexai.java.GenerativeModuleFutures;

3. Adım: Kullanılmayan API anahtarlarını silin ve kullanılmayan API'leri devre dışı bırakın

Google AI API anahtarınızı artık kullanmanız gerekmiyorsa güvenlikle ilgili en iyi uygulamaları uygulayarak anahtarı silin. Google AI API anahtarlarınızı Google AI Studio'in API anahtarları bölümünde görüntüleyebilir ve silebilirsiniz.

Ayrıca, Google AI Gemini API'ü artık kullanmıyorsanız projenizde devre dışı bırakın. Bunu Google Cloud konsolundaki Generative Language API (generativelanguage.googleapis.com) sayfasından yapabilirsiniz. ("Üretken Dil API'si", Google AI Gemini API'nin resmi adıdır.)

Başka neler yapabilirsiniz?

• Hem Google AI hem de Vertex AI, istemler ve model parametreleriyle denemeler yapmak için "AI Studio" adlı bir web kullanıcı arayüzü "oyun alanı" deneyimi sunar. Google AI Studio istemlerinizi Vertex AI Studio'e nasıl taşıyacağınızı Google Cloud dokümanlarında öğrenebilirsiniz.