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 ş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 şuna gidin: Build with Gemini (Gemini ile Derleme) sayfasını ziyaret edin.
Size yardımcı olacak bir iş akışı başlatmak için Vertex AI in Firebase kartını tıklayın. tamamlanması gereken aktivitelerdir. (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ı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 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-beta04")
}
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-beta04")
// 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 numaralı telefonu arayın
Uygulamanızı Firebase'e bağlayıp SDK'yı eklediniz ve ilk kullanıma hazırladınız. Vertex AI hizmeti ve üretken model, Vertex AI Gemini API numarasını aramaya 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'ın 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 kullanma ü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 Vertex AI in Firebase deneyiminiz hakkında bilgi