برای Firebase AI Logic، کنسول Firebase میانای کاربر راهنمایی‌شده‌ای برای شما ارائه می‌دهد تا محتوای الگو را مشخص کنید. بااین‌حال، چندین مورد استفاده وجود دارد که ممکن است به روش‌های پیشرفته‌تری برای راه‌اندازی الگو نیاز داشته باشید، ازجمله:
گردش‌های کار پیشرفته شرح‌داده‌شده در این صفحه از Firebase AI Logic REST API استفاده می‌کنند.
اطلاعات مهم درباره استفاده از REST API
اگر الگویی باز باشد، می‌توانید بااستفاده از همان شناسه الگو در فراخوانی REST API، الگو را رونویسی کنید. الگوی قفل‌شده را نمی‌توان رونویسی کرد.
وقتی الگوی پیام‌واره سرور را ازطریق REST API ایجاد می‌کنید و مکان آن را روی
globalتنظیم می‌کنید، الگوی پیام‌واره سرور به‌طور خودکار در همه مکان‌ها (ازجملهglobal) تأمین می‌شود و برای استفاده با هر دو ارائه‌دهنده Gemini API دردسترس است. بااین‌حال، اگر هنگام ایجاد الگو ازطریق REST API مکان دیگری را تنظیم کنید، الگو فقط برای Agent Platform Gemini API (formerly Vertex AI) دردسترس خواهد بود. درباره تنظیم مکان خاص برای الگو در ادامه این صفحه بیشتر بدانید.توجه داشته باشید که وقتی از واسط کاربر راهنمایی‌شده در کنسول Firebase استفاده می‌کنید، الگو به‌طور خودکار در همه مکان‌ها (ازجمله
global) نیز تأمین می‌شود، و برای استفاده با هر دو ارائه‌دهنده Gemini API دردسترس است.برای دسترسی به الگوی پیام‌واره سرور در درخواست
templateGenerateContentیاtemplateStreamGenerateContentازطریق REST API، باید از نقطه پایانی مختص ارائه‌دهنده Gemini API خود (Gemini Developer API | Agent Platform Gemini API (formerly Vertex AI)) استفاده کنید.
(فقط Agent Platform Gemini API (formerly Vertex AI)) تنظیم مکان خاص برای الگو
این بخش برای این موقعیت‌ها قابل‌اجرا است:
مورد استفاده برنامه‌تان الزامات مبتنی بر مکان دارد.
درخواست‌های برنامه‌تان از Agent Platform Gemini API (formerly Vertex AI) استفاده می‌کند و شما مکان دسترسی به مدل را مشخص می‌کنید.
همان‌طور که قبلاً در این صفحه توضیح داده شد، اگر یکی از کارهای زیر را انجام دهید، یک الگوی پیام‌واره سرور به‌طور خودکار برای همه
مناطق پشتیبانی‌شده برای Firebase AI Logic (ازجمله global) ارائه می‌شود:
- الگو را بااستفاده از واسط کاربر راهنمایی‌شده در کنسول Firebase ایجاد کنید.
- الگو را ازطریق REST API ایجاد کنید و مکان آن را روی
globalتنظیم کنید.
این یعنی می‌توانید مکان را در درخواست برنامه‌تان روی هرکدام از مناطق دردسترس برای Firebase AI Logic تنظیم کنید و الگو دردسترس خواهد بود.
لازم نیست مکان را در درخواست برنامه‌تان برای global تنظیم کنید.
بااین‌حال، اگر می‌خواهید الگوی شما
فقط در مکان خاصی دردسترس باشد، باید الگو را ازطریق REST API ایجاد کنید و آن مکان خاص را به‌طور صریح تنظیم کنید. مکان را روی global تنظیم نکنید.
با فراخوانی
projects.locations.templates.createنقطه پایانی، الگو را ایجاد کنید.locationالگو را (برای مثال،europe-west4) به‌عنوان بخشی از ایجادPromptTemplateمشخص کنید.در درخواست برنامه‌تان، مطمئن شوید مکانی که از آن به مدل دسترسی دارید با مکان الگو (
eu) مطابقت داشته باشد.
به موارد زیر توجه کنید:
فهرست الگوها در کنسول Firebase فقط الگوهایی را نشان می‌دهد که (حداقل) در مکان
globalفراهم شده‌اند.اگر از REST API برای تدارک دیدن الگو در مکان خاصی استفاده می‌کنید (که
globalنیست)، مکانی که در درخواست برنامه‌تان به مدل دسترسی پیدا می‌کنید باید با مکان تنظیم‌شده برای الگو مطابقت داشته باشد. اگر مکان‌ها مطابقت نداشته باشند، درخواست ناموفق خواهد بود (به‌دلیل خط‌مشی‌های جداسازی منطقه‌ای).
الگو را به‌صورت فایل ارائه دهید
می‌توانید محتوای فایل الگوی پیام‌واره سرور را با فراخوانی نقطه پایانی projects.locations.templates.create ارائه دهید.