Menerapkan mode hanya template


Anda dapat menerapkan mode hanya template untuk project Firebase Anda sehingga semua permintaan Gemini API melalui Firebase AI Logic harus menggunakan template perintah server.

Jika permintaan diblokir, responsnya akan berupa error 403: unauthorized.

Pertimbangan penting

Perhatikan pertimbangan penting berikut untuk mode hanya template.

Saat mode hanya template diterapkan

Saat mode hanya template diterapkan, perhatikan hal-hal berikut:

  • Setelan ini adalah setelan seluruh project untuk Firebase AI Logic.

    • Hal ini berlaku untuk semua aplikasi yang terdaftar dalam project.
    • Kebijakan ini hanya berlaku untuk project tempat kebijakan tersebut diterapkan.

  • Setelan ini berlaku untuk semua permintaan melalui Firebase AI Logic ke Gemini Developer API dan Vertex AI Gemini API.

  • Setelan ini memblokir semua permintaan melalui Firebase AI Logic yang tidak menggunakan template perintah server. Hal ini mencakup pemblokiran permintaan dari aplikasi Anda yang menggunakan kemampuan yang belum didukung untuk template perintah server.

  • Setelan ini tidak memblokir permintaan Gemini API di project Anda yang tidak melalui Firebase AI Logic.

  • Jika Anda menggunakan Firebase AI Logic REST API:

    • Setelan ini tidak memblokir permintaan inferensi yang menggunakan template perintah server (seperti menggunakan templateGenerateContent atau templateStreamGenerateContent).
    • Setelan ini tidak memblokir permintaan control plane (seperti permintaan untuk mengelola template dan konfigurasi).

  • Setelan ini tidak memblokir permintaan ke countTokens (Count Tokens API).

Sebelum menerapkan mode hanya template

Perhatikan hal berikut sebelum Anda menerapkan mode hanya template:

  • Jika Anda memiliki versi aplikasi yang sudah ada yang tidak menggunakan template perintah server:

    • Setelan ini akan memblokir permintaan melalui Firebase AI Logic dari versi aplikasi yang ada tersebut.
    • Pastikan semua klien aktif diupdate untuk menggunakan template perintah server sebelum menerapkan mode hanya template.

  • Jika aplikasi Anda menggunakan kemampuan yang belum didukung untuk template perintah server:

    • Setelan ini akan memblokir permintaan melalui Firebase AI Logic untuk kemampuan yang belum didukung ini karena tidak (dan tidak dapat) menggunakan template perintah server.
    • Pastikan aplikasi Anda (termasuk versi sebelumnya) tidak secara aktif menggunakan kemampuan yang belum didukung tersebut sebelum menerapkan mode hanya template.

Mengelola setelan mode hanya template

Anda dapat mengelola setelan untuk mode hanya template di konsol Firebase.

Izin dan peran IAM yang diperlukan

Pengelolaan setelan mode hanya template memerlukan izin firebasevertexai.configs.update, yang disertakan secara default dalam peran IAM berikut: Pemilik, Editor, Firebase Admin, dan Firebase AI Logic Admin.

Menerapkan mode hanya template

Berikut cara menerapkan mode hanya template untuk project Firebase Anda:

  1. Jika belum, tinjau pertimbangan penting untuk mode khusus template di bagian awal panduan ini.

  2. Di konsol Firebase, buka tab AI Services > AI Logic > Settings.

  3. Di bagian Mode template, geser tombol untuk Terapkan mode khusus template ke Diterapkan.

  4. Tinjau dialog konfirmasi, lalu klik Konfirmasi.

Menghentikan penerapan mode hanya template

Jika Anda menghentikan penegakan mode hanya template, perhatikan hal-hal berikut:

  • Permintaan melalui Firebase AI Logic yang tidak menggunakan template perintah server akan diizinkan.
  • Ini adalah setelan seluruh project untuk Firebase AI Logic.

Berikut cara menghentikan penerapan mode hanya template untuk project Firebase Anda:

  1. Di konsol Firebase, buka tab AI Services > AI Logic > Settings.

  2. Di bagian Mode template, nonaktifkan Terapkan mode khusus template.

  3. Tinjau dialog konfirmasi, lalu klik Konfirmasi.