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ümün eklendiği şablon kimlikleri oluşturun.
İsteğinizdeki şablonu ve 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 ekleme saldırılarına 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
- Araçları kullanma (Google Arama ile işlev çağırma ve temellendirme dahil)
- Gemini modelleriyle (sohbet gerektirir) resimlerin yinelemeli olarak düzenlenmesi (sohbet)
- Imagen modelleriyle görüntü düzenleme
- Çift yönlü yayın (Gemini Live API)
- Cihaz üzerinde karma
- Çıkışı bir enum listesiyle sınırlama
- Düşünmeyle ilgili ayarları yapılandırma
- Güvenlik ayarlarını yapılandırma
Ayrıca Firebase konsolunda yapay zeka izlemeyi kullanıyorsanız şablon kimliğinin henüz hiçbir kayda doldurulmadığını da unutmayın.
Henüz desteklenmeyen Dotprompt'un 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 karakter 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 istem ş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 parçaları 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ğlarız. 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 (Firebase konsolunun rehberli kullanıcı arayüzünü kullanmak yerine) istiyorsanız 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.