Bu sayfada, henüz desteklenmeyen özellikler de dahil olmak üzere sunucu istemi şablonlarıyla ilgili bazı en iyi uygulamalar ve dikkat edilmesi gereken noktalar açıklanmaktadır. Bu özelliklerin birçoğunun yalnızca sunucu istemi şablonlarının ilk sürümünde kullanılamadığını unutmayın. Güncellemeler için sürüm notlarını kontrol edin.
En iyi uygulamalar
Bu en iyi uygulamaların çoğu Şablonlarınızı yönetme başlıklı makalede de ayrıntılı olarak açıklanmaktadır.
Şablonlarınıza sürüm oluşturma
Anlamsal sürüm oluşturma (semver) kullanan bir sürümle eklenmiş şablon kimlikleri oluşturun.
Şablonu ve isteğinizdeki diğer değerleri kolayca değiştirebilmek için Firebase Remote Config kullanın.
Şablonunuzu koruma
Üretime geçmeden önce şablonunuzu kilitleyin. Ayrıca, üretimde kullanılan şablonları düzenlemekten kaçının.
Şablonu kilitlemek, yanlışlıkla düzenlemeye karşı koruma sağlar ancak kilitleme, düzenlemeyi tamamen engellemez. Gerekli izinlere sahip bir proje üyesi, şablonu düzenlemek için istediği zaman kilidini açabilir.
Kod tarafından etkin olarak kullanılan şablonları (özellikle üretim kodu) kilitlemenizi öneririz.
Giriş değişkenleriniz için güçlü giriş doğrulama yazın. Bu, aşağıdakilerde yardımcı olabilir:
- İstem enjeksiyonuna karşı korunmaya yardımcı olabilir.
- İsteklerin başarılı olmasını ve yanıtların beklendiği gibi olmasını sağlamaya yardımcı olabilir.
Henüz desteklenmeyen özellikler
Henüz desteklenmeyen bu özelliklerin çoğu yalnızca ilk sürümde kullanılamaz. Güncellemeler için sürüm notlarını kontrol edin.
Firebase AI Logic'da henüz desteklenmeyen özellikler
Sunucu istemi şablonları henüz Firebase AI Logic'in aşağıdaki özelliklerini desteklemez. Bu özelliklerin birçoğu yakında kullanıma sunulacak.
- Sohbet
- İşlev çağırma
- Gemini modelleriyle (sohbet gerektirir) resimlerin yinelemeli olarak düzenlenmesi (sohbet)
- İki yönlü akış (Gemini Live API)
- Karma veya cihaz üzerinde çıkarım
- Çıkışı bir enum listesiyle sınırlama
Ayrıca Firebase konsolunda yapay zeka kullanım takibini kullanıyorsanız şablon kimliğinin henüz hiçbir kayda doldurulmadığını da unutmayın.
Dotprompt'un henüz desteklenmeyen ortak öğeleri
Sunucu istemi şablonları yakında Dotprompt'un aşağıdaki yaygın öğelerini destekleyecektir:
Ön kısımdaki giriş ve çıkış şemaları için JSON şema spesifikasyonunu kullanma.
- Bu spesifikasyonun sunucu dışı şablon isteklerinde de desteklenmediğini unutmayın. Şu anda yalnızca OpenAPI şema spesifikasyonu desteklenmektedir.
*kullanarak joker alan tanımı bildirme.@keykullanmak veya genellikle bir nesne girişinin alanları üzerinde yineleme yapmak (@key'nın alakalı olduğu durum).@rootkullanarak. Bu, mevcutthis'den bağımsız olarak kök değişken bağlamına başvurmanıza olanak tanır.
Sunucu istemi şablonları, Dotprompt'un aşağıdaki yaygın öğelerini büyük olasılıkla desteklemeyecektir:
- Diğer şablonlara dahil edilebilen, yeniden kullanılabilir şablon snippet'leri olan kısmi şablonları kullanma.
Dikkat edilmesi gereken diğer noktalar
Varsayılan olarak, Firebase konsolunda rehberli kullanıcı arayüzünü kullandığınızda şablonu Firebase AI Logic için kullanılabilen tüm bölgelerde sağlıyoruz. Vertex AI Gemini API kullanıyorsanız ve kullanım alanınız konum tabanlı kısıtlamalar gerektiriyorsa REST API'yi kullanarak şablonunuzun konumunu belirtebilirsiniz.
Sunucu istemi şablonunu dosya olarak sağlamak istiyorsanız (Firebase konsolunun rehberli kullanıcı arayüzünü kullanmak yerine) REST API'yi kullanabilirsiniz. Sunucu istemi şablonlarının, uygulama kodunda tanımlanan ve şablona aktarılan şemayı desteklemediğini unutmayın.
Şablon sunucuda olsa bile doğrudan Firebase projenizin diğer sunucu tarafı kaynaklarıyla (ör. veritabanı) etkileşimde bulunamaz. Cloud Storage for Firebase URL'leri (giriş değişkenleri olarak sağlanabilir) bu durumun dışındadır.