Alur kerja lanjutan untuk template


Untuk Firebase AI Logic, Firebase console menyediakan UI terpandu bagi Anda untuk 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 dikunci, Anda dapat menimpanya menggunakan ID template yang sama dalam panggilan REST API. Template yang terkunci tidak dapat ditimpa.

  • Saat Anda membuat template perintah server melalui REST API dan Anda menetapkan lokasinya ke global, template perintah server akan otomatis disediakan 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 Agent Platform Gemini API (formerly Vertex AI). Pelajari lebih lanjut cara menetapkan lokasi tertentu untuk template di bagian berikutnya halaman ini.

    Perlu diperhatikan bahwa saat Anda menggunakan UI terpandu di Firebase console, template juga otomatis disediakan di semua lokasi (termasuk global), dan 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 | Agent Platform Gemini API (formerly Vertex AI)).

(Khusus Agent Platform Gemini API (formerly Vertex AI)) Menetapkan lokasi tertentu untuk template

Bagian ini berlaku untuk situasi berikut:

  • Kasus penggunaan aplikasi Anda memiliki persyaratan berbasis lokasi.

  • Permintaan aplikasi Anda menggunakan Agent Platform Gemini API (formerly Vertex AI) dan Anda menentukan lokasi untuk mengakses model.

Seperti yang dijelaskan sebelumnya di halaman ini, template perintah server otomatis disediakan ke semua region yang didukung 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 ke salah satu region yang tersedia untuk Firebase AI Logic, dan template akan tersedia. Anda tidak perlu menetapkan lokasi dalam permintaan aplikasi ke global.

Namun, jika Anda ingin template Anda hanya tersedia di lokasi tertentu, Anda harus membuat template melalui REST API dan menetapkan lokasi spesifik 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 sesuai dengan lokasi template (eu).

Perhatikan hal-hal berikut:

  • Daftar template di Firebase console 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 lokasi tidak cocok, permintaan akan gagal (karena kebijakan isolasi regional).

Menyediakan template sebagai file

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