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


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

Vertex AI in Firebase kitaplığının beta sürümünü (firebase-vertexai:16.0.0-betaXX) kullandıysanız kitaplığın GA sürümünü (firebase-vertexai:16.0.0 veya sonraki sürümler) 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 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.

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

Bağımlılıklarınızı Firebase Android BoM'un en son sürümünü kullanacak şekilde güncellemek için bu talimatları uygulayın. BoM kullanmak zorunlu değildir ancak uygulamanızın her Firebase kitaplığının uyumlu sürümlerini kullanmasını sağladığı için kullanmanızı önemle tavsiye ederiz.

  1. Modül (uygulama düzeyi) Gradle dosyanızda (genellikle <project>/<app-module>/build.gradle.kts veya <project>/<app-module>/build.gradle)), Vertex AI in Firebase için bağımlılığı aşağıdakiyle değiştirin:

    // BEFORE
dependencies {
  implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
}

// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.10.0"))

  // Add the dependency for the Vertex AI in Firebase library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-vertexai")
}

  2. Android projenizi Gradle dosyalarıyla senkronize edin.

Firebase BoM'ü kullanmamayı tercih ederseniz Android Studio tarafından önerilen firebase-vertexai'un en son sürümünü kabul etmeniz yeterlidir.

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

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

    • enum sınıfları ve sealed sınıfları normal sınıflarla değiştirildi. Bu değişiklik, API'yi geriye dönük uyumlu bir şekilde geliştirmek için daha fazla esneklik sağlar.

    • BlockThreshold dizini HarmBlockThreshold olarak yeniden adlandırıldı.

    • Aşağıdaki listelemelerden değerler kaldırıldı: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason ve FinishReason.

  • Blob yöntemleri

    • Adında Blob bulunan tüm yöntemler, bunun yerine InlineData kullanacak şekilde yeniden adlandırıldı.

  • Güvenlik ayarları

    • method alanı, boş değer kabul edecek şekilde değiştirildi.

  • Süre sınıfı

    • Kotlin'in Duration sınıfının tüm kullanımları kaldırıldı ve long ile değiştirildi. Bu değişiklik, Java ile daha iyi birlikte çalışabilirlik sağlar.

  • Alıntı meta verileri

    • Daha önce CitationMetadata içinde tanımlanan tüm alanları Citation adlı yeni bir sınıfa sardı. Alıntıları CitationMetadata'daki citations adlı listede bulabilirsiniz. Bu değişiklik, platformlar arasında türlerin daha iyi uyumlu hale getirilmesine olanak tanır.

  • Jetonları sayma

    • totalBillableCharacters alanı, boş değer kabul edecek şekilde değiştirildi.

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

  • Model oluşturma

    • Diğer platformlarla uyumlu olması için requestOptions parametresi parametre listesinin sonuna taşındı.

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.