برای Firebase AI Logic، کنسول Firebase میانای کاربر راهنمایی‌شده‌ای برای شما فراهم می‌کند تا محتوای الگو را مشخص کنید. بااین‌حال، چندین مورد استفاده وجود دارد که در آن‌ها ممکن است به روش‌های پیشرفته‌تری برای راه‌اندازی الگو نیاز داشته باشید، ازجمله:
گردش‌های کار پیشرفته‌ای که در این صفحه توضیح داده شده است از Firebase AI Logic REST API استفاده می‌کنند.
اطلاعات مهم درباره استفاده از REST API
اگر قفل الگویی باز باشد، می‌توانید بااستفاده از شناسه الگوی یکسان در تماس «میانای برنامه کاربردی REST»، الگو را بازنویسی کنید. الگوی قفل‌شده نمی‌تواند رونویسی شود.
وقتی قالب پیام‌واره سرور را ازطریق «میانای برنامه‌سازی کاربردی REST» ایجاد می‌کنید و مکان آن را روی
globalتنظیم می‌کنید، قالب پیام‌واره سرور به‌طور خودکار در همه مکان‌ها (ازجملهglobal) آماده می‌شود و برای استفاده با هر دو ارائه‌دهنده Gemini API دردسترس قرار می‌گیرد. بااین‌حال، اگر هنگام ایجاد الگو ازطریق REST API مکان دیگری را تنظیم کنید، الگو فقط برای Agent Platform Gemini API (formerly Vertex AI) دردسترس خواهد بود. در ادامه این صفحه، درباره تنظیم مکان خاص برای الگو بیشتر بدانید.توجه داشته باشید که وقتی از واسط کاربر هدایت‌شده در کنسول Firebase استفاده می‌کنید، الگو هم به‌طور خودکار در همه مکان‌ها (ازجمله
global) آماده می‌شود، و برای استفاده با هر دو ارائه‌دهنده Gemini API دردسترس است.برای دسترسی به الگوی پیام‌واره سرور در درخواست
templateGenerateContentیاtemplateStreamGenerateContentازطریق میانای برنامه‌سازی کاربردی REST، باید از نقطه پایانی مختص ارائه‌دهنده 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» برای آماده‌سازی الگو در مکان خاصی استفاده می‌کنید (که
globalنیست)، مکانی که در آن به مدل در درخواست برنامه خود دسترسی پیدا می‌کنید باید با مکان تنظیم‌شده برای الگو مطابقت داشته باشد. اگر مکان‌ها مطابقت نداشته باشند، درخواست ناموفق خواهد بود (به‌دلیل خط‌مشی‌های جداسازی منطقه‌ای).
الگو را به‌صورت فایل ارائه دهید
با فراخوانی
نقطه پایانی projects.locations.templates.create می‌توانید محتوای فایل الگوی پیام‌واره سرور را ارائه دهید.