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