Alur kerja lanjutan untuk template


Untuk Firebase AI Logic, konsol Firebase menyediakan UI terpandu bagi Anda untuk menentukan konten template. Namun, ada beberapa kasus penggunaan saat Anda 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 dikunci, Anda dapat mengganti template dengan menggunakan ID template yang sama dalam panggilan REST API. Template yang dikunci tidak dapat ditimpa.

  • Saat Anda membuat template perintah server melalui REST API dan menetapkan lokasinya ke global, template perintah server akan disediakan secara otomatis di semua lokasi (termasuk global), dan tersedia untuk 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 cara menetapkan lokasi tertentu untuk template di bagian berikutnya halaman ini.

    Perhatikan bahwa saat Anda menggunakan UI terpandu di konsol Firebase, template juga otomatis disediakan di semua lokasi (termasuk global), dan template tersebut tersedia untuk digunakan dengan kedua penyedia Gemini API.

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

(Khusus Vertex AI Gemini API) 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:

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

Artinya, Anda dapat menetapkan lokasi dalam permintaan aplikasi Anda ke salah satu wilayah yang tersedia untuk Firebase AI Logic, dan template akan tersedia. Anda tidak perlu menyetel 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 tetapkan lokasi sebagai global.

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

  2. Dalam permintaan aplikasi Anda, 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 (setidaknya) disediakan di lokasi global.

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

Memberikan template sebagai file

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