Bu kılavuzda, seçtiğiniz platform için Vertex AI in Firebase SDK'sını kullanarak doğrudan uygulamanızdan Vertex AI Gemini API çağrıları nasıl yapacağınız gösterilmektedir.
Ön koşullar
Bu kılavuzda, Flutter ile uygulama geliştirme hakkında bilgi sahibi olduğunuz varsayılmaktadır.
Geliştirme ortamınızın ve Flutter uygulamanızın aşağıdaki koşulları karşıladığından emin olun:
- Dart 3.2.0 ve üzeri
(İsteğe bağlı) Örnek uygulamaya göz atın.
SDK'yı hızlıca deneyebilir, çeşitli kullanım alanlarının tam uygulamasını görebilir veya kendi Flutter uygulamanız yoksa örnek uygulamayı kullanabilirsiniz. Örnek uygulamayı kullanmak için bir Firebase projesine bağlamanız gerekir.
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 Gemini ile oluşturma sayfasına gidin.
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.
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 oluşturulduktan ve uygulamanız Firebase'e bağlandıktan sonra (önceki adıma bakın) Vertex AI in Firebase SDK'sını uygulamanıza ekleyebilirsiniz.
Flutter için Vertex AI in Firebase eklentisi (firebase_vertexai
), Vertex AI Gemini API'ye erişim sağlar.
Temel eklentiyi ve Vertex AI in Firebase eklentisini yüklemek için Flutter proje dizininizden aşağıdaki komutu çalıştırın:
flutter pub add firebase_core && flutter pub add firebase_vertexai
lib/main.dart
dosyanıza Firebase ana eklentisini, Vertex AI in Firebase eklentisini ve daha önce oluşturduğunuz yapılandırma dosyasını aktarın:import 'package:firebase_core/firebase_core.dart'; import 'package:firebase_vertexai/firebase_vertexai.dart'; import 'firebase_options.dart';
Ayrıca
lib/main.dart
dosyanızda, yapılandırma dosyası tarafından dışa aktarılanDefaultFirebaseOptions
nesnesini kullanarak Firebase'i başlatın:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );
Flutter uygulamanızı yeniden oluşturun:
flutter run
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.
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
// Initialize FirebaseApp
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// 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
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
Başlangıç kılavuzunu tamamladığınızda, kullanım alanınıza ve uygulamanıza uygun bir Gemini modeli ve (isteğe bağlı olarak) konum seçmeyi öğrenin.
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:
import 'package:firebase_vertexai/firebase_vertexai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';
await Firebase.initializeApp(
options: DefaultFirebaseOptions.currentPlatform,
);
// 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
final model =
FirebaseVertexAI.instance.generativeModel(model: 'gemini-1.5-flash');
// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];
// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);
Başka neler 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.
- Çoklu formatlı istemlerden (metin, resim, PDF, video ve ses dahil) metin oluşturun.
- Çoklu katılımlı görüşmeler (sohbet) oluşturun.
- Hem metin hem de çoklu modal istemlerden yapılandırılmış çıkış (JSON gibi) oluşturun.
- Üretken modelleri harici sistemlere ve bilgilere bağlamak için işlev çağırma özelliğini kullanın.
İçerik oluşturmayı nasıl kontrol edeceğinizi öğrenin
- En iyi uygulamalar, stratejiler ve örnek istemler dahil olmak üzere istem tasarımını anlama
- Sıcaklık ve maksimum çıkış jetonu gibi model parametrelerini yapılandırın.
- Zararlı olarak değerlendirilebilecek yanıtlar alma olasılığını ayarlamak için güvenlik ayarlarını kullanın.
Vertex AI in Firebase ile ilgili deneyiminiz hakkında geri bildirim verme