Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Praktik terbaik dan pertimbangan untuk template

Halaman ini menjelaskan beberapa praktik terbaik dan pertimbangan untuk template perintah server, termasuk fitur yang belum didukung. Perhatikan bahwa banyak dari fitur ini akan tersedia seiring berkembangnya template perintah server, jadi periksa catatan rilis untuk mengetahui info terbaru.

Praktik terbaik

Banyak dari praktik terbaik ini juga dijelaskan dalam Mengelola template.

Menetapkan versi template Anda

Buat ID template yang ditambahkan dengan versi yang menggunakan pembuatan versi semantik (semver).
Gunakan Firebase Remote Config agar Anda dapat dengan mudah mengubah template dan nilai lainnya dalam permintaan Anda.

Melindungi template Anda

Hindari mengedit template yang digunakan dalam produksi, kecuali jika Anda telah menguji perubahan tersebut secara menyeluruh.
Kunci template Anda sebelum beralih ke produksi.
- Mengunci template berfungsi sebagai perlindungan terhadap pengeditan yang tidak disengaja, tetapi penguncian tidak sepenuhnya memblokir pengeditan. Anggota project dengan izin yang sesuai dapat membuka kunci template kapan saja untuk mengeditnya.
- Sebaiknya kunci template yang sedang digunakan secara aktif oleh kode, terutama kode produksi.

Melindungi penggunaan Gemini API

Tulis validasi input yang kuat untuk variabel input Anda, yang dapat membantu hal berikut:
- Dapat membantu melindungi dari injeksi perintah.
- Dapat membantu memastikan permintaan berhasil dan respons sesuai harapan.
Terapkan mode khusus template untuk project Firebase Anda sehingga semua permintaan Gemini API melalui Firebase AI Logic harus menggunakan template perintah server.

Fitur yang belum didukung oleh template perintah server

Banyak dari fitur ini akan tersedia seiring berkembangnya template perintah server, jadi periksa catatan rilis untuk mengetahui info terbaru.

Kemampuan Firebase AI Logic belum didukung oleh template

Kemampuan standar berikut dari Firebase AI Logic belum didukung melalui template perintah server:

Streaming dua arah (Gemini Live API)
Inferensi hybrid atau di perangkat
Membatasi output ke daftar enum

Perhatikan juga bahwa jika Anda menggunakan pemantauan AI di Firebase console, ID template belum diisi di data mana pun.

Elemen umum Dotprompt yang belum didukung oleh template

Template perintah server kemungkinan akan segera mendukung elemen umum Dotprompt berikut:

Menggunakan spesifikasi skema JSON untuk skema input dan output di frontmatter Anda.
- Perhatikan bahwa spesifikasi ini juga tidak didukung dalam permintaan template non-server. Saat ini kami hanya mendukung spesifikasi skema OpenAPI.
Mendeklarasikan definisi kolom karakter pengganti menggunakan *.
Menggunakan @key atau umumnya melakukan iterasi pada kolom input objek (yang merupakan kasus di mana @key relevan).
Menggunakan @root, yang memungkinkan Anda mereferensikan konteks variabel root, terlepas dari this saat ini.

Template perintah server kemungkinan tidak akan mendukung elemen umum Dotprompt berikut:

Menggunakan parsial, yang merupakan cuplikan template yang dapat digunakan kembali dan dapat disertakan dalam template lain.

Pertimbangan lainnya

Secara default, saat Anda menggunakan UI terpandu di Firebase console, kami menyediakan template di semua wilayah yang didukung untuk Firebase AI Logic. Jika Anda menggunakan Agent Platform Gemini API (formerly Vertex AI) dan jika kasus penggunaan Anda memerlukan pembatasan berbasis lokasi, Anda dapat menentukan lokasi untuk template Anda menggunakan REST API.
Jika Anda ingin menyediakan template perintah server sebagai file (bukan menggunakan UI terpandu Firebase console), Anda dapat menggunakan REST API. Perhatikan bahwa template perintah server tidak mendukung skema yang ditentukan dalam kode aplikasi dan diteruskan ke template.
Meskipun berada di server, template tidak dapat berinteraksi secara langsung dengan resource sisi server lainnya di project Firebase Anda (seperti database) kecuali untuk URL Cloud Storage for Firebase (yang dapat disediakan sebagai variabel input).