این صفحه برخی از بهترین شیوه‌ها و ملاحظات مربوط به قالب‌های اعلان سرور، از جمله ویژگی‌هایی که هنوز پشتیبانی نمی‌شوند را شرح می‌دهد. توجه داشته باشید که بسیاری از این ویژگی‌ها فقط در نسخه اولیه قالب‌های اعلان سرور در دسترس نیستند، بنابراین برای به‌روزرسانی‌ها، یادداشت‌های انتشار را بررسی کنید!
بهترین شیوه‌ها
بسیاری از این بهترین شیوه‌ها همچنین در مدیریت الگوهای شما به تفصیل شرح داده شده‌اند.
قالب‌های خود را نسخه‌بندی کنید
شناسه‌های قالبی ایجاد کنید که به نسخه‌ای که از نسخه‌بندی معنایی (semver) استفاده می‌کند، ضمیمه شده باشند.
از Firebase Remote Config استفاده کنید تا بتوانید به راحتی قالب و سایر مقادیر درخواست خود را تغییر دهید.
از قالب خود محافظت کنید
قبل از رفتن به مرحله تولید، قالب خود را قفل کنید. و از ویرایش قالب‌هایی که در مرحله تولید استفاده می‌شوند، خودداری کنید.
قفل کردن یک الگو به عنوان محافظت در برابر ویرایش غیرعمدی عمل می‌کند، اما قفل کردن به طور کامل ویرایش را مسدود نمی‌کند . یک عضو پروژه با مجوزهای مناسب همیشه می‌تواند یک الگو را برای ویرایش باز کند.
ما توصیه می‌کنیم قالب‌هایی را که به طور فعال توسط کد استفاده می‌شوند - به خصوص کد عملیاتی - قفل کنید.
اعتبارسنجی ورودی قوی برای متغیرهای ورودی خود بنویسید، که می‌تواند در موارد زیر کمک کند:
- می‌تواند به محافظت در برابر تزریق سریع کمک کند.
- می‌تواند به اطمینان از موفقیت درخواست‌ها و پاسخ‌های مورد انتظار کمک کند.
ویژگی‌هایی که هنوز پشتیبانی نمی‌شوند
بسیاری از این ویژگی‌های پشتیبانی‌نشده، فقط در نسخه اولیه در دسترس نیستند، بنابراین برای به‌روزرسانی‌ها، یادداشت‌های انتشار را بررسی کنید!
قابلیت‌های هنوز پشتیبانی نشده‌ی Firebase AI Logic
قالب‌های اعلان سرور هنوز از قابلیت‌های زیر در Firebase AI Logic پشتیبانی نمی‌کنند . تعدادی از این قابلیت‌ها به زودی اضافه خواهند شد!
- چت
- استفاده از ابزارها (از جمله فراخوانی تابع و اتصال به زمین با جستجوی گوگل)
- ویرایش تکراری تصاویر (چت) با مدل‌های Gemini (نیاز به چت)
- ویرایش تصاویر با مدل‌های Imagen
- پخش دو طرفه (Gemini Live API)
- هیبرید روی دستگاه
- محدود کردن خروجی به لیستی از enumها
- پیکربندی تنظیمات مربوط به تفکر
- پیکربندی تنظیمات ایمنی
همچنین توجه داشته باشید که اگر از مانیتورینگ هوش مصنوعی در کنسول Firebase استفاده می‌کنید، شناسه الگو هنوز در هیچ رکوردی پر نشده است.
عناصر رایج Dotprompt که هنوز پشتیبانی نمی‌شوند
قالب‌های اعلان سرور احتمالاً به زودی از عناصر رایج زیر در Dotprompt پشتیبانی خواهند کرد:
استفاده از مشخصات طرحواره JSON برای طرحواره‌های ورودی و خروجی در frontmatter شما.
- توجه داشته باشید که این مشخصات در درخواست‌های الگوی غیر سرور نیز پشتیبانی نمی‌شود. ما در حال حاضر فقط از مشخصات طرحواره OpenAPI پشتیبانی می‌کنیم.
اعلام تعریف فیلد wildcard با استفاده از
*.استفاده از
@keyیا به طور کلی پیمایش فیلدهای یک ورودی شیء (که در این مورد از@keyاستفاده می‌شود).استفاده از
@root که به شما امکان می‌دهد صرف نظر ازthisفعلی، به زمینه متغیر ریشه ارجاع دهید.
قالب‌های اعلان سرور احتمالاً از عناصر رایج زیر در Dotprompt پشتیبانی نمی‌کنند :
- استفاده از partialها، که قطعه کدهای قالب قابل استفاده مجدد هستند و می‌توانند در قالب‌های دیگر گنجانده شوند.
ملاحظات دیگر
به طور پیش‌فرض، وقتی از رابط کاربری هدایت‌شده در کنسول Firebase استفاده می‌کنید، ما قالب را در تمام مناطق موجود برای Firebase AI Logic ارائه می‌دهیم. اگر از API Vertex AI Gemini استفاده می‌کنید و اگر مورد استفاده شما نیاز به محدودیت‌های مبتنی بر مکان دارد، می‌توانید مکان قالب خود را با استفاده از REST API مشخص کنید .
اگر می‌خواهید یک الگوی اعلان سرور را به عنوان یک فایل ارائه دهید (به جای استفاده از رابط کاربری هدایت‌شده کنسول Firebase )، می‌توانید از REST API استفاده کنید. توجه داشته باشید که الگوهای اعلان سرور از طرحواره‌ای که در کد برنامه تعریف شده و به الگو ارسال می‌شود، پشتیبانی نمی‌کنند .
حتی اگر قالب روی سرور باشد، نمی‌تواند مستقیماً با سایر منابع سمت سرور پروژه Firebase شما (مانند پایگاه داده) تعامل داشته باشد ، به جز Cloud Storage for Firebase (که می‌توانند به عنوان متغیرهای ورودی ارائه شوند).