Google AI SDK'ları yerine Vertex AI SDK'larını kullanma

Bu sayfada, mobil veya web uygulamalarınızda Google AI istemci SDK'larından Vertex AI in Firebase istemci SDK'larına nasıl geçeceğiniz açıklanmaktadır. Vertex AI in Firebase SDK'ları Apple platformları (Swift), Android (Kotlin ve Java), Web (JavaScript) ve Flutter (Dart) için kullanılabilir.

Doğrudan taşıma talimatlarına git

Neden Vertex AI kullanmak için veri taşımalısınız?

Google AI Studio veya Google AI istemci SDK'larını kullanarak Gemini API'ün alternatif bir sürümünü denemiş olabilirsiniz. Bu SDK'lar, Gemini API kullanmaya başlamak ve prototip oluşturmak için yararlıdır. Ancak Firebase, doğrudan Gemini API istemci tarafını çağıran üretim veya kurumsal ölçekli mobil uygulamalar ve web uygulamaları için Firebase SDK'larımızı kullanarak Vertex AI Gemini API çağrısı yapmanızı kesinlikle önerir.

Mobil ve web uygulamaları için güvenlik özellikleri

Mobil ve web uygulamaları için güvenlik çok önemlidir ve kodunuz (Gemini API çağrıları dahil) korumasız bir ortamda çalıştığından özel dikkat gerektirir.

• Varsayılan olarak Vertex AI Gemini API, Google AI Gemini API gibi bir API anahtarı yerine Google Cloud IAM tarafından yetkilendirilir. Vertex AI in Firebase SDK'ları, daha güvenli Vertex AI Gemini API'ü çağıracak şekilde tasarlanmıştır.

• Mobil uygulamalar ve web uygulamalarında, Gemini API öğesini ve proje kaynaklarınızı (ayarlanmış modeller gibi) yetkisiz istemcilerin kötüye kullanımına karşı korumanız gerekir. Tüm API çağrılarının gerçek uygulamanızdan geldiğini doğrulamak için Firebase App Check'ü kullanabilirsiniz. Bu özellik yalnızca Vertex AI in Firebase SDK'larını kullanıyorsanız kullanılabilir.

Mobil uygulamalar ve web uygulamaları için oluşturulmuş ekosistem

Firebase, Google'ın mobil ve web uygulamaları geliştirme platformudur. Vertex AI in Firebase SDK'larını kullanmak, uygulamalarınızın tam yığın uygulamaların ve geliştiricilerin ihtiyaçlarına odaklanan bir ekosistemde olduğu anlamına gelir. Örneğin, aşağıdakilerden herhangi birini ve daha fazlasını yapmak için hazırsınız:

• Çok modlu isteklerinize büyük dosyaları dahil etmek için Cloud Storage for Firebase kullanın. Ayrıca, dosya yükleme ve indirme işlemlerini (kötü ağ koşullarında bile) yöneten ve son kullanıcılarınızın verileri için daha fazla güvenlik sunan istemci SDK'larından yararlanın. Cloud Storage for Firebase kullanımıyla ilgili çözüm kılavuzumuzdan daha fazla bilgi edinebilirsiniz.

• Mobil ve web uygulamaları için oluşturulmuş veritabanı SDK'larını (ör. Cloud Firestore) kullanarak yapılandırılmış verileri yönetin.

• Firebase Remote Config kullanarak yeni bir uygulama sürümü yayınlamadan çalışma zamanı yapılandırmalarını (konum gibi) dinamik olarak ayarlayın veya uygulamanızdaki değerleri değiştirin (ör. model adı).

Google Cloud tarafından sağlanan Vertex AI ürününü kullanmanın diğer avantajları

Uygulamanızda ve iş akışlarında üretken yapay zeka kullanımınız olgunlaştıkça, üretken yapay zeka uygulamaları geliştirmek ve dağıtmak için uçtan uca çözümler sunan bir platforma ihtiyacınız olabilir. Google Cloud, uygulama geliştirmenin ilk aşamalarından uygulama dağıtımına, uygulama barındırmaya ve karmaşık verileri geniş ölçekte yönetmeye kadar üretken yapay zekanın gücünden yararlanmanızı sağlayan kapsamlı bir araç ekosistemi sunar.

Google Cloud'un Vertex AI platformu, verimlilik ve güvenilirlik için yapay zeka modellerinin kullanımını, dağıtımını ve izlenmesini kolaylaştıran bir MLOps araç paketi sunar. Ayrıca veritabanları, DevOps araçları, günlük kaydı, izleme ve IAM ile entegrasyonlar, üretken yapay zeka yaşam döngüsünün tamamını yönetmek için bütünsel bir yaklaşım sağlar.

Google Cloud dokümanlarında Vertex AI'un kullanım alanları hakkında daha fazla bilgi edinin.

Vertex AI in Firebase SDK'ya geçiş yapın

Vertex AI in Firebase SDK'larına geçiş için üç ana adım gerekir:

1. Yeni veya mevcut bir Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın.

2. Yalnızca SDK'nın ve başlatma kodunun (model adı dahil) değiştirilmesini gerektiren kod tabanınızı taşıyın. Gemini API'yi gerçekten çağıran kodlarda herhangi bir değişiklik yapılması gerekmez.

3. Kullanılmayan API anahtarlarını silin ve kullanılmayan API'leri devre dışı bırakın.

1. Adım: Bir Firebase projesi oluşturun ve uygulamanızı Firebase'e bağlayın

Firebase'e aşina olsanız bile Firebase projenizin ve uygulamanızın Vertex AI in Firebase SDK'larını kullanacak şekilde ayarlandığından emin olmak için bu bölümü inceleyin.

Zaten bir Firebase projeniz ve Firebase'e bağlı bir uygulamanız var

1. Firebase konsolunda Gemini ile oluşturma sayfasına gidin.

2. 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 (Vertex AI API ve Vertex AI in Firebase API) gerekli API'leri etkinleştirin.

3. Vertex AI in Firebase SDK'larını kullanmak amacıyla kod tabanınızı taşımak 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

1. Firebase konsolunda oturum açın.

2. Proje oluştur'u tıklayın ve ardından aşağıdaki seçeneklerden birini kullanın:

   • 1. Seçenek: "Proje oluşturma" iş akışının ilk adımında yeni bir proje adı girerek tamamen yeni bir Firebase projesi (ve temel Google Cloud projesi) oluşturun.

   • 2. Seçenek: "Proje oluştur" iş akışının ilk adımındaki açılır menüden Google Cloud proje adınızı seçerek mevcut bir Google Cloud projesine "Firebase ekleyin".

     • Google AI API anahtarınızı oluştururken Google AI Studio tarafından sizin için oluşturulan Google Cloud projesini kullanabilirsiniz. Bu projenin adını Google AI Studio sayfasının API anahtarı bölümünde bulabilirsiniz.

     • Mevcut diğer herhangi bir Google Cloud projesini kullanabilirsiniz.

   İstendiğinde, Vertex AI in Firebase SDK'larını kullanmak için Google Analytics uygulamasını kurmanız gerekmediğini unutmayın.

3. Firebase konsolunda Build with Gemini sayfasına gidin.

4. 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.

5. Uygulamanızı aşağıdaki görevleri içeren Firebase'e bağlamak için konsolun iş akışına devam edin:

   • Uygulamanızı Firebase projenize kaydettirme

   • Firebase yapılandırmanızı uygulamanızın kod tabanına ekleme

2. Adım: Kod tabanınızı taşıyın

Platforma özel talimatları görüntülemek için uygulamanızın platformunu seçin.

Google AI SDK'ları ve Vertex AI in Firebase SDK'ları, iki platform arasında geçişin olabildiğince kolay olması için tasarlanmıştır.

Taşımak için yalnızca uygulamanızın kod tabanına entegre ettiğiniz SDK'yı ve hizmetin ve üretken modelin ilk kullanıma hazırlanmasını değiştirmeniz gerekir. Gemini API işlevini çağıran kodda herhangi bir değişiklik yapmanız gerekmez.

SDK'yı değiştirme

Başlatma işlemini değiştirme

3. Adım: Kullanılmayan API anahtarlarını silin ve kullanılmayan API'leri devre dışı bırakın

Google AI API anahtarınızı artık kullanmanız gerekmiyorsa güvenlikle ilgili en iyi uygulamalardan yararlanın ve anahtarı silin. Google AI API anahtarlarınızı Google AI Studio'in API anahtarları bölümünde görüntüleyip silebilirsiniz.

Ayrıca, artık Google AI Gemini API hizmetini kullanmıyorsanız projenizde devre dışı bırakın. Bunu Google Cloud konsolundaki Generative Language API (generativelanguage.googleapis.com) sayfasından yapabilirsiniz. ("Üretken Dil API'si", Google AI Gemini API'nin resmi adıdır.)

Başka ne yapabilirsiniz?

• Hem Google AI hem de Vertex AI, istemler ve model parametreleriyle denemeler yapmak için "AI Studio" adlı bir web kullanıcı arayüzü "oyun alanı" deneyimi sunar. Google AI Studio istemlerinizi Vertex AI Studio'e nasıl taşıyacağınızı Google Cloud dokümanlarında öğrenebilirsiniz.