Menerapkan mode hanya template


Anda dapat menerapkan mode khusus template untuk project Firebase Anda sehingga semua Gemini API permintaan 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 khusus template.

Saat mode khusus template diterapkan

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

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

    • Setelan ini berlaku untuk semua aplikasi yang terdaftar dalam project.
    • Setelan ini hanya berlaku untuk project tempat setelan tersebut diterapkan.

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

  • Setelan ini memblokir permintaan apa pun 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 Gemini API permintaan 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 khusus template

Perhatikan hal-hal berikut sebelum Anda menerapkan mode khusus template:

  • Jika Anda memiliki versi aplikasi 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 khusus 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 kemampuan tersebut tidak (dan tidak dapat) menggunakan template perintah server.
    • Pastikan aplikasi Anda (termasuk versi sebelumnya) tidak menggunakan kemampuan yang belum didukung tersebut secara aktif sebelum menerapkan mode khusus template.

Mengelola setelan mode khusus template

Anda mengelola setelan untuk mode khusus template di konsol Firebase.

Peran dan izin IAM yang diperlukan

Mengelola setelan mode khusus 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 khusus template

Berikut cara menerapkan mode khusus template untuk project Firebase Anda:

  1. Jika belum, tinjau pertimbangan penting untuk mode khusus template yang dijelaskan sebelumnya dalam panduan ini.

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

  3. Di bagian Template mode, geser tombol untuk Enforce template-only mode ke Enforced.

  4. Tinjau dialog konfirmasi, lalu klik Confirm.

Menghentikan penerapan mode khusus template

Jika Anda menghentikan penerapan mode khusus template, perhatikan hal-hal berikut:

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

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

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

  2. Di bagian Template mode, nonaktifkan Enforce template-only mode.

  3. Tinjau dialog konfirmasi, lalu klik Confirm.