Firebase'de Vertex AI'ın GA sürümünü kullanmak için geçiş yapın

iOS+ Android Web Flutter

Vertex AI in Firebase, 21 Ekim 2024'te genel kullanıma sunuldu.

Vertex AI in Firebase kitaplığının önizleme sürümünü (FirebaseVertexAI-Preview) kullandıysanız kitaplığın GA sürümünü (FirebaseVertexAI) kullanmak üzere yükseltmek için aşağıdaki değişiklikleri yapmanız gerekir.

Taşıma işlemi için gereken değişikliklerin genel hatlarıyla listesi aşağıda verilmiştir:

• Firebase projenizde yeni zorunlu API'yi etkinleştirin (herkes için gereklidir)
• Kitaplığın genel sürümüne güncelleme (herkes için gereklidir)
• Ek değişiklikler (kullandığınız özelliklere bağlı olarak gereklidir)

Firebase projenizde yeni zorunlu API'yi etkinleştirin (herkes için zorunludur)

Firebase projenizde Vertex AI in Firebase API'sini etkinleştirmeniz ve Firebase API anahtarınızın izin verilenler listesine eklemeniz gerekir. Bu, Vertex AI in Firebase'ün GA sürümünü kullanmak için gereken yeni bir API'dir.

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

2. Bu API'yi etkinleştirmenize ve Firebase API anahtarınızın izin verilenler listesine eklemenize yardımcı olacak bir iş akışı başlatmak için Vertex AI in Firebase kartında Başlayın'ı tıklayın.

3. Konsolda iş akışının geri kalanını atlayabilirsiniz.

Not: Vertex AI API'nin (aiplatform.googleapis.com) projenizde etkinleştirilmesi gerekir (ancak API anahtarınızın izin verilenler listesinde olmamalıdır).

Kitaplığın genel sürümüne güncelleme (herkes için gereklidir)

iOS+ Android Web Flutter

Uygulamanızın kod tabanını, kitaplığın GA sürümünü kullanacak şekilde güncellemek için aşağıdaki talimatları uygulayın:

1. Xcode'da, uygulama projeniz açıkken aşağıdaki seçeneklerden birini kullanarak Firebase paketinizi 11.4.0 veya sonraki bir sürüme güncelleyin:

   • 1. Seçenek: Tüm paketleri güncelleyin: Dosya > Paketler > En Son Paket Sürümlerine Güncelle'ye gidin.

   • 2. seçenek: Firebase'i tek tek güncelleyin: Paket Bağımlılıkları adlı bölümde Firebase paketine gidin. Firebase paketini sağ tıklayın ve Paketi Güncelle'yi seçin.

2. Firebase paketinin artık 11.4.0 veya sonraki bir sürümü gösterdiğinden emin olun. Aksi takdirde, belirttiğiniz paket koşullarının 11.8.0 veya sonraki bir sürüme güncellemeye izin verdiğini doğrulayın.

3. Proje Düzenleyici'de uygulamanızın hedefini seçin ve ardından Çerçeveler, Kitaplıklar ve Yerleşik İçerik bölümüne gidin.

4. + düğmesini seçin ve ardından Firebase paketinden FirebaseVertexAI'yı ekleyin.

5. FirebaseVertexAI-Preview'ı seçin ve ardından — düğmesine basın.

Ek değişiklikler (kullandığınız özelliklere bağlı olarak gereklidir)

iOS+ Android Web Flutter

SDK'ların GA sürümlerinde çeşitli değişiklikler uygulandı. Uygulamanızda SDK'nın GA sürümünü kullanmaya başlamak için kodunuzda yapmanız gerekebilecek değişiklikler için aşağıdaki listeleri inceleyin.

• İşlev çağırma
  Bu özelliği genel kullanıma sunulmadan önce uyguladıysanız şemanızı tanımlama şeklinizde güncelleme yapmanız gerekir. İşlev beyanlarınızı nasıl yazacağınızı öğrenmek için güncellenmiş işlev çağırma kılavuzunu incelemenizi öneririz.

• responseSchema kullanarak yapılandırılmış çıkış (JSON gibi) oluşturma
  Bu özelliği genel kullanıma sunulmadan önce uyguladıysanız şemanızı tanımlama şeklinizde güncelleme yapmanız gerekir. JSON şemalarını nasıl yazacağınızı öğrenmek için yeni yapılandırılmış çıkış kılavuzunu incelemenizi öneririz.

• Zaman aşımı

  • İstekler için varsayılan zaman aşımı 180 saniye olarak değiştirildi.

• Listeleme

  • Çoğu enum türü, statik değişkenler içeren struct ile değiştirildi. Bu değişiklik, API'yi geriye dönük uyumlu bir şekilde geliştirme konusunda daha fazla esneklik sağlar. switch ifadelerini kullanırken artık SDK'ya gelecekte eklenecek yeni değerler de dahil olmak üzere bilinmeyen veya işlenmemiş değerleri kapsayacak bir default: durumu eklemeniz gerekir.

  • BlockThreshold dizini HarmBlockThreshold olarak yeniden adlandırıldı; bu tür artık struct.

  • HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason ve FinishReason adlandırmalarından unknown ve unspecified durumları kaldırıldı (artık struct olarak adlandırılıyor).

  • Yeni türlerin geriye dönük olarak uyumlu bir şekilde eklenmesine izin vermek için ModelContent.Part numaralandırması Part adlı bir protokolle değiştirildi. Bu değişiklik, İçerik bölümleri bölümünde daha ayrıntılı olarak açıklanmıştır.

• İçerik bölümleri

  • ThrowingPartsRepresentable protokolü kaldırıldı ve zaman zaman ortaya çıkan derleyici hatalarını önlemek için ModelContent için başlatıcılar basitleştirildi. Düzgün şekilde kodlanmamış resimler generateContent'te kullanıldığında hata vermeye devam eder.

  • ModelContent.Part destek kayıtları, Part protokolüne uygun aşağıdaki struct türleriyle değiştirildi:

    • .text - TextPart
    • .data - InlineDataPart
    • .fileData - FileDataPart
    • .functionCall - FunctionCallPart
    • .functionResponse - FunctionResponsePart

• Zarar kategorisi

  • HarmCategory türü, artık SafetySetting türüne yerleştirilmeyecek şekilde değiştirildi. SafetySetting.HarmCategory olarak adlandırdığınız öğeyi HarmCategory ile değiştirebilirsiniz.

• Güvenlikle ilgili geri bildirim

  • Yanıtların hiçbirinde kullanılmadığı için SafetyFeedback türü kaldırıldı.

• Alıntı meta verileri

  • citationSources mülkü, CitationMetadata'de citations olarak yeniden adlandırıldı.

• Faturalandırılabilir toplam karakter sayısı

  • Hiçbir karakter gönderilmeyen durumları yansıtmak için CountTokensResponse içindeki totalBillableCharacters mülkünün isteğe bağlı olarak değiştirildi.

• Aday yanıtı

  • Diğer platformlarla eşleşecek şekilde CandidateResponse yerine Candidate olarak yeniden adlandırıldı.

• Üretim yapılandırması

  • GenerationConfig mülkünün herkese açık özellikleri internal olarak değiştirildi. Bunların tümü başlatıcıda yapılandırılabilir durumda kalır.

Taşımayla ilgili olası hatalar

Vertex AI in Firebase'ün GA sürümüne geçiş yaparken, bu taşıma kılavuzunda açıklandığı şekilde gerekli tüm değişiklikleri tamamlamadıysanız hatalarla karşılaşabilirsiniz.

403 Hatası: Requests to this API firebasevertexai.googleapis.com ... are blocked.

Requests to this API firebasevertexai.googleapis.com ... are blocked. ifadesini içeren bir 403 hatası alırsanız bu genellikle, Firebase yapılandırma dosyanızdaki/nesnesindeki API anahtarının, kullanmaya çalıştığınız ürün için izin verilenler listesinde gerekli bir API'ye sahip olmadığı anlamına gelir.

Uygulamanızın kullandığı API anahtarında, anahtarın "API kısıtlamaları " izin verilenler listesine dahil edilen tüm gerekli API'lerin bulunduğundan emin olun. Vertex AI in Firebase için API anahtarınızın izin verilenler listesinde en azından Vertex AI in Firebase API'sinin yer alması gerekir. Bu API, Firebase konsolu üzerinden yeni API'yi etkinleştirdiğinizde API anahtarınızın izin verilenler listesine otomatik olarak eklenmiş olmalıdır.

Tüm API anahtarlarınızı Google Cloud konsolundaki API'ler ve Hizmetler > Kimlik bilgileri panelinde görüntüleyebilirsiniz.

Not: Firebase ile ilgili API'ler, API'yi çağırmak için (diğer bazı API'lerin izin verdiği gibi) yetkilendirme amacıyla değil, yalnızca Firebase projesini veya uygulamasını tanımlamak için API anahtarlarını kullanır. Firebase ile ilgili API'ler için yetkilendirme, API anahtarından ayrı olarak Google Cloud IAM izinleri,Firebase Security Rules veya Firebase App Check aracılığıyla gerçekleştirilir. Firebase API anahtarları hakkında daha fazla bilgi edinin.