Bu kılavuz, Vertex AI Gemini API'yi doğrudan uygulamanızdan Firebase SDK'ları için Vertex AI.
Ö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 şu gereksinimleri karşıladığından emin olun: aşağıdaki şartları yerine getirmeniz gerekir:
- 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: Bir Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın
Halihazırda Firebase projeniz ve Firebase'e bağlı bir uygulamanız varsa
Firebase konsolunda şu sayfaya gidin: Gemini ile derleme sayfasına göz atın. ardından ikinci kartı tıklayarak bazı görevleri de gözden geçirmelisiniz. Vertex AI konsolunda bir sekme görürseniz tamamlandı.
Şunu kullanmak için projenizi yükseltin: Blaze kullandıkça öde 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ılavuzdaki bir sonraki adıma geçin.
Halihazırda bir Firebase projeniz ve Firebase'e bağlı bir 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 uygulamanıza Firebase için Vertex AI SDK'sını ekleyebilirsiniz.
Android için Firebase için Vertex AI SDK'sı (firebase-vertexai
)
Vertex AI Gemini API'ye erişme
Modülünüz (uygulama düzeyi) Gradle yapılandırma dosyanızda
(<project>/<app-module>/build.gradle.kts
gibi),
Android'de Firebase için Vertex AI SDK'sı:
Kotlin+KTX
dependencies {
// ... other androidx dependencies
// add the dependency for the Vertex AI for Firebase SDK for Android
implementation("com.google.firebase:firebase-vertexai:16.0.0-beta03")
}
Java
Java için iki kitaplık daha eklemeniz gerekir.
dependencies {
// ... other androidx dependencies
// add the dependency for the Vertex AI for Firebase SDK for Android
implementation("com.google.firebase:firebase-vertexai:16.0.0-beta03")
// 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'ı ilk kullanıma hazırlamanız gerekir üretken modele odaklanıyoruz.
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 bir Reaktif Akışlar kitaplığındanPublisher
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
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'yi çağırın
Uygulamanızı Firebase'e bağlayıp SDK'yı eklediniz ve ilk kullanıma hazırladınız. Vertex AI hizmetine ve üretken modele odaklanıyoruz. Vertex AI Gemini API'yi çağırmaya hazırsınız.
Yalnızca metin içeren bir istemden metin oluşturmak için generateContent()
öğesini kullanabilirsiniz
istek:
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 birListenableFuture
.
// 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
Şu konu hakkında bilgi edinin: çeşitli kullanım alanları için kullanılabilecek modeller ve kotalar ve fiyatlandırma hakkında daha fazla bilgi edinin.
Gemini API'nin diğer özelliklerini deneyin
- Kaynaktan metin oluşturma hakkında daha fazla bilgi edinin: yalnızca metin istemleri, yanıtı akış şeklinde gösterebilir.
- Ş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.
- Bağlanmak için işlev çağrısı özelliğini kullanın üretken modelleri dış sistemlere ve bilgilere
İçerik üretme işlemini nasıl kontrol edeceğinizi öğrenin
- Aşağıdakiler dahil olmak üzere istem tasarımını anlama: en iyi uygulamalar, stratejiler ve örnek istemler.
- 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.
Geri bildirimde bulunma ve Firebase için Vertex AI deneyiminiz hakkında