Yalnızca şablon modunu zorunlu kılma


Firebase projeniz için yalnızca şablon modunu zorunlu kılabilirsiniz. Böylece Firebase AI Logic üzerinden yapılan tüm Gemini API isteklerinde sunucu istem şablonları kullanılır.

Bir istek engellendiğinde yanıt olarak 403: unauthorized hatası döndürülür.

Dikkat edilecek önemli noktalar

Yalnızca şablon moduyla ilgili aşağıdaki önemli noktaları göz önünde bulundurun.

Yalnızca şablon modu zorunlu kılındığında

Yalnızca şablon modu uygulandığında aşağıdakilere dikkat edin:

  • Bu ayar, Firebase AI Logic için proje genelinde geçerli olan bir ayardır.

    • Projede kayıtlı tüm uygulamalar için geçerlidir.
    • Yalnızca uygulandığı proje için geçerlidir.
  • Bu ayar, Firebase AI Logic üzerinden hem Gemini Developer API hem de Agent Platform Gemini API (formerly Vertex AI) için gönderilen tüm isteklerde geçerlidir.

  • Bu ayar, sunucu istem şablonlarını kullanmayan Firebase AI Logic üzerinden yapılan tüm istekleri engeller. Buna, uygulamanızdan gelen ve sunucu istem şablonları için henüz desteklenmeyen özellikleri kullanan isteklerin engellenmesi de dahildir.

  • Bu ayar, projenizde Firebase AI Logic üzerinden yapılmayan Gemini API isteklerini engellemez.

  • Firebase AI Logic REST API'yi kullanıyorsanız:

    • Bu ayar, sunucu istem şablonlarını (templateGenerateContent veya templateStreamGenerateContent kullanımı gibi) kullanan çıkarım isteklerini engellemez.
    • Bu ayar, kontrol düzlemi isteklerini (şablonları ve yapılandırmaları yönetme istekleri gibi) engellemez.
  • Bu ayar, countTokens (Count Tokens API) isteklerini engellemez.

Yalnızca şablon modunu zorunlu kılmadan önce

Yalnızca şablon modunu zorunlu kılmadan önce aşağıdakilere dikkat edin:

  • Uygulamanızın sunucu istem şablonlarını kullanmayan mevcut sürümleri varsa:

    • Bu ayar, mevcut uygulama sürümlerinden Firebase AI Logic üzerinden gelen istekleri engeller.
    • Yalnızca şablon modunu zorunlu kılmadan önce tüm etkin istemcilerin sunucu istem şablonlarını kullanacak şekilde güncellendiğinden emin olun.
  • Uygulamanız sunucu istem şablonları için henüz desteklenmeyen özellikler kullanıyorsa:

    • Bu ayar, sunucu istem şablonlarını kullanmadıkları (ve kullanamadıkları) için henüz desteklenmeyen bu özelliklerle ilgili istekleri Firebase AI Logic üzerinden engeller.
    • Yalnızca şablon modunu zorunlu kılmadan önce uygulamanızın (geçmiş sürümler dahil) henüz desteklenmeyen bu özelliklerden hiçbirini etkin bir şekilde kullanmadığından emin olun.

Yalnızca şablon modu ayarını yönetme

Yalnızca şablon modu ayarını Firebase konsolunda yönetirsiniz.

Gerekli IAM izinleri ve rolleri

Yalnızca şablon modu ayarını yönetmek için firebasevertexai.configs.update izni gerekir. Bu izin, şu IAM rollerine varsayılan olarak dahildir: Sahip, Düzenleyici, Firebase Yöneticisi ve Firebase AI Logic Yöneticisi.

Yalnızca şablon modunu zorunlu kılma

Firebase projeniz için yalnızca şablon modunu şu şekilde zorunlu kılabilirsiniz:

  1. Henüz yapmadıysanız bu kılavuzun önceki bölümlerinde yer alan, yalnızca şablon moduyla ilgili önemli hususları inceleyin.

  2. Firebase konsolunda AI Services (Yapay Zeka Hizmetleri) > AI Logic (Yapay Zeka Mantığı) > Settings (Ayarlar) sekmesine gidin.

  3. Şablon modu bölümünde, Yalnızca şablon modunu zorunlu kıl seçeneğinin yanındaki düğmeyi Zorunlu kılındı konumuna getirin.

  4. Onay iletişim kutusunu inceleyin ve ardından Onayla'yı tıklayın.

Yalnızca şablon modunun zorunlu kılınmasını durdurma

Yalnızca şablon modunun zorunlu kılınmasını durdurursanız aşağıdakilere dikkat edin:

  • Firebase AI Logic üzerinden yapılan ve sunucu istem şablonlarını kullanmayan isteklere izin verilir.
  • Bu, Firebase AI Logic için proje genelinde geçerli bir ayardır.

Firebase projeniz için yalnızca şablon modunun uygulanmasını durdurmak için aşağıdaki adımları uygulayın:

  1. Firebase konsolunda AI Services (Yapay Zeka Hizmetleri) > AI Logic (Yapay Zeka Mantığı) > Settings (Ayarlar) sekmesine gidin.

  2. Şablon modu bölümünde Yalnızca şablon modunu zorunlu kıl'ı devre dışı bırakın.

  3. Onay iletişim kutusunu inceleyin ve ardından Onayla'yı tıklayın.