Alur kerja lanjutan untuk template


Untuk Firebase AI Logic, konsol Firebase menyediakan UI terpandu agar Anda dapat menentukan konten template. Namun, ada beberapa kasus penggunaan yang mungkin memerlukan cara yang lebih canggih untuk menyiapkan template, termasuk:

Alur kerja lanjutan yang dijelaskan di halaman ini menggunakan Firebase AI Logic REST API.

Informasi penting tentang penggunaan REST API

  • Jika template tidak terkunci, Anda dapat mengganti template dengan menggunakan ID template yang sama dalam panggilan REST API. Template yang terkunci tidak dapat diganti.

  • Saat Anda membuat template perintah server melalui REST API dan menetapkan lokasinya ke global, template perintah server akan otomatis disediakan di semua lokasi (termasuk global), dan dapat digunakan dengan kedua penyedia Gemini API. Namun, jika Anda menetapkan lokasi lain saat membuat template melalui REST API, template tersebut hanya akan tersedia untuk Vertex AI Gemini API. Pelajari lebih lanjut tentang menetapkan lokasi tertentu untuk template di halaman ini.

    Perhatikan bahwa saat Anda menggunakan UI terpandu di konsFirebaseol, template juga otomatis disediakan di semua lokasi (termasuk global), dan dapat digunakan dengan kedua Gemini API penyedia.

  • Untuk mengakses template perintah server dalam permintaan templateGenerateContent atau templateStreamGenerateContent melalui REST API, Anda harus menggunakan endpoint khusus untuk penyedia Gemini API (Gemini Developer API | Vertex AI Gemini API).

(Vertex AI Gemini API saja) Menetapkan lokasi tertentu untuk template

Bagian ini berlaku untuk situasi berikut:

  • Kasus penggunaan aplikasi Anda memiliki persyaratan berbasis lokasi.

  • Permintaan aplikasi Anda menggunakan Vertex AI Gemini API dan Anda menentukan lokasi untuk mengakses model.

Seperti yang dijelaskan sebelumnya di halaman ini, template perintah server otomatis disediakan untuk semua region yang tersedia untuk Firebase AI Logic (termasuk global) jika Anda melakukan salah satu hal berikut:

  • Membuat template menggunakan UI terpandu di konsol Firebase.
  • Membuat template melalui REST API dan menetapkan lokasinya ke global.

Artinya, Anda dapat menetapkan lokasi dalam permintaan aplikasi ke salah satu region yang tersedia untuk Firebase AI Logic, dan template akan tersedia. Anda tidak diwajibkan untuk menetapkan lokasi dalam permintaan aplikasi ke global.

Namun, jika Anda ingin template hanya tersedia di lokasi tertentu, Anda harus membuat template melalui REST API dan menetapkan lokasi tertentu tersebut secara eksplisit. Jangan menetapkan lokasi sebagai global.

  1. Buat template dengan memanggil projects.locations.templates.create endpoint. Tentukan location template (misalnya, europe-west4) sebagai bagian dari pembuatan PromptTemplate.

  2. Dalam permintaan aplikasi, pastikan lokasi tempat Anda mengakses model cocok dengan lokasi template (europe-west4).

Perhatikan hal-hal berikut:

  • Daftar template di konsol Firebase hanya menampilkan template yang (minimal) disediakan di lokasi global.

  • Jika Anda menggunakan REST API untuk menyediakan template di lokasi tertentu (yang bukan global), lokasi tempat Anda mengakses model dalam permintaan aplikasi harus cocok dengan lokasi yang ditetapkan untuk template. Jika lokasinya tidak cocok, permintaan akan gagal (karena kebijakan isolasi regional).

Menyediakan template sebagai file

Anda dapat menyediakan konten file template perintah server dengan memanggil projects.locations.templates.create endpoint.