Bu kılavuzda, seçtiğiniz platforma ait 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, Apple platformları (iOS gibi) için uygulama geliştirmek amacıyla Xcode'u kullanma konusunda bilgi sahibi olduğunuz varsayılmaktadır.
Geliştirme ortamınızın ve Apple platformları uygulamanızın aşağıdaki koşulları karşıladığından emin olun:
- Xcode 15.0 veya sonraki sürümler
- Uygulamanız iOS 15 veya sonraki bir sürümü ya da macOS 12 veya sonraki bir sürümü hedeflemelidir.
(İ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 Apple platformu 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.
Firebase bağımlılarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.
Vertex AI in Firebase kitaplığı, Vertex AI Gemini API'a erişim sağlar ve Apple platformları (firebase-ios-sdk
) için Firebase SDK'sının bir parçası olarak dahil edilir.
Xcode'da, uygulamanız açıkken Dosya > Paket Ekle'ye gidin.
İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
https://github.com/firebase/firebase-ios-sdk
En son SDK sürümünü seçin.
FirebaseVertexAI
kitaplığını seçin.İşlem tamamlandığında Xcode, arka planda bağımlılarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
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.
FirebaseVertexAI
modülünü içe aktarın:import FirebaseVertexAI
Vertex AI hizmetini ve üretken modeli başlatın:
import FirebaseVertexAI // Initialize the Vertex AI service let vertex = VertexAI.vertexAI() // Initialize the generative model with a model that supports your use case // Gemini 1.5 models are versatile and can be used with all API capabilities let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
Başlangıç kılavuzunu tamamladığınızda, kullanım alanınıza ve uygulamanıza uygun bir Gemini modelini 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 FirebaseVertexAI
// Initialize the Vertex AI service
let vertex = VertexAI.vertexAI()
// Initialize the generative model with a model that supports your use case
// Gemini 1.5 models are versatile and can be used with all API capabilities
let model = vertex.generativeModel(modelName: "gemini-1.5-flash")
// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."
// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")
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