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 fitur ini akan tersedia seiring dengan perkembangan template perintah server, jadi periksa catatan rilis untuk mengetahui update.

Praktik terbaik

Banyak praktik terbaik ini juga dijelaskan secara mendetail di Mengelola template.

Menetapkan versi template

Melindungi template

  • Hindari mengedit template yang digunakan dalam produksi kecuali jika Anda telah menguji perubahan 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 selalu membuka kunci template untuk mengeditnya.

    • Sebaiknya kunci template yang aktif digunakan 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 Gemini API permintaan melalui Firebase AI Logic harus menggunakan template perintah server.

Fitur yang belum didukung oleh template perintah server

Banyak fitur ini akan tersedia seiring dengan perkembangan template perintah server, jadi periksa catatan rilis untuk mengetahui update.

Kemampuan Firebase AI Logic yang 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 konsol Firebase, ID template belum diisi dalam catatan apa 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 saat @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 konsol Firebase, kami menyediakan template di semua region yang tersedia untuk Firebase AI Logic. Jika Anda menggunakan Vertex AI Gemini API dan jika kasus penggunaan Anda memerlukan batasan berbasis lokasi, Anda dapat menentukan lokasi untuk template menggunakan REST API.

  • Jika ingin menyediakan template perintah server sebagai file (bukan menggunakan UI terpandu konsol Firebase), Anda dapat menggunakan REST API. Perhatikan bahwa template perintah server tidak mendukung skema yang ditentukan dalam kode aplikasi dan diteruskan ke template.

  • Meskipun template berada di server, template tersebut tidak dapat langsung berinteraksi dengan resource sisi server lainnya di project Firebase Anda (seperti database) kecuali untuk Cloud Storage for Firebase URL (yang dapat diberikan sebagai input variabel).