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.
Geliştirme ortamınızın ve Android uygulamanızın aşağıdaki koşulları karşıladığından emin olun:
- Android Studio (en son sürüm)
- Android uygulamanız, API düzeyi 21 veya üstünü hedeflemelidir.
(İsteğe bağlı) Örnek uygulamaya göz atın.
SDK'yı hızlıca deneyebilir, çeşitli kullanım alanlarını eksiksiz bir şekilde uygulanmış olarak görebilirsiniz. veya kendi Android uygulamanız yoksa örnek uygulamayı kullanın. Örnek uygulamayı kullanmak için: Firebase projesine bağlayın.
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
Firebase konsolunda şuna gidin: Build with Gemini (Gemini ile Derleme) sayfasını ziyaret edin.
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.)
Şunu kullanmak için projenizi yükseltin: kullandıkça öde Blaze fiyatlandırma planı.
Projeniz için aşağıdaki iki API'yi etkinleştirin:
aiplatform.googleapis.com
vefirebaseml.googleapis.com
.
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 birPublisher
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öntemlerListenableFuture
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
- Yanıtı yayınlama dahil olmak üzere yalnızca metin istemlerinden metin oluşturma hakkında daha fazla bilgi edinin.
- Şu kaynaktan metin oluştur: çok modlu istemler (metin, resim, PDF, video ve ses dahil).
- Çok dönüşlü görüşmeler (sohbet) oluşturun.
- Üretken modelleri harici sistemlere ve bilgilere bağlamak için işlev çağırma özelliğini kullanın.
İçerik üretme işlemini nasıl kontrol edeceğinizi öğrenin
- En iyi uygulamalar, stratejiler ve örnek istemler dahil olmak üzere istem tasarımını anlama.
- Aşağıdaki gibi model parametrelerini yapılandırın sıcaklık ve maksimum çıkış jetonları.
- Güvenlik ayarlarını kullanarak alma olasılığını azaltır.
Vertex AI in Firebase ile ilgili deneyiminiz hakkında geri bildirim verin