Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

Gemini 4 Argon is now available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-4-argon, gemini-3.8-flash, or gemini-nano-banana-2.1). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

החלת מצב 'תבניות בלבד'

אתם יכולים לאכוף מצב של תבניות לפרומפט בלבד בפרויקט Firebase, כך שכל הבקשות של Gemini API דרך Firebase AI Logic יצטרכו להשתמש בתבניות לפרומפט בשרת.

כשבקשה נחסמת, התגובה תהיה שגיאת 403: unauthorized.

שיקולים חשובים

חשוב לשים לב לשיקולים הבאים לגבי מצב "תבנית בלבד".

כשאוכפים את מצב "תבניות בלבד"

כשמצב "תבניות בלבד" מופעל, חשוב לשים לב לדברים הבאים:

ההגדרה הזו היא הגדרה ברמת הפרויקט ב-Firebase AI Logic.
- היא חלה על כל האפליקציות שרשומות בפרויקט.
- היא חלה רק על הפרויקט שבו היא נאכפת.
ההגדרה הזו חלה על כל הבקשות דרך Firebase AI Logic גם ל-Gemini Developer API וגם ל-Agent Platform Gemini API (formerly Vertex AI).
ההגדרה הזו חוסמת בקשות דרך Firebase AI Logic שלא משתמשות בתבניות לפרומפטים בשרת. זה כולל חסימת בקשות מהאפליקציה שמשתמשות ביכולות שעדיין לא נתמכות בתבניות לפרומפטים בצד השרת.
ההגדרה הזו לא חוסמת בקשות של Gemini API בפרויקט שלא נשלחות דרך Firebase AI Logic.
אם אתם משתמשים ב-API ל-REST של Firebase AI Logic:
- ההגדרה הזו לא חוסמת בקשות להסקה שמשתמשות בתבניות לפרומפטים בשרת (כמו שימוש ב-templateGenerateContent או ב-templateStreamGenerateContent).
- ההגדרה הזו לא חוסמת בקשות של מישור הבקרה (כמו בקשות לניהול תבניות והגדרות).
ההגדרה הזו לא חוסמת בקשות ל-countTokens (Count Tokens API).

לפני אכיפת מצב "תבניות בלבד"

לפני שאתם אוכפים את מצב "תבניות בלבד", חשוב לשים לב לנקודות הבאות:

אם יש לכם גרסאות קיימות של האפליקציה שלא משתמשות בתבניות לפרומפטים בצד השרת:
- ההגדרה הזו תחסום בקשות דרך Firebase AI Logic מגרסאות האפליקציה הקיימות האלה.
- לפני שאתם אוכפים את מצב "תבניות בלבד", ודאו שכל הלקוחות הפעילים מעודכנים כך שישתמשו בתבניות לפרומפטים בצד השרת.
אם האפליקציה משתמשת ביכולות שעדיין לא נתמכות בתבניות לפרומפטים בצד השרת:
- ההגדרה הזו תחסום בקשות דרך Firebase AI Logic ליכולות האלה שעדיין לא נתמכות, כי הן לא משתמשות (ולא יכולות להשתמש) בתבניות לפרומפטים בשרת.
- לפני שאתם אוכפים את מצב "תבניות בלבד", ודאו שהאפליקציה שלכם (כולל גרסאות קודמות) לא משתמשת באופן פעיל באחת מהיכולות האלה שעדיין לא נתמכות.

ניהול ההגדרה של מצב "תבניות בלבד"

אתם יכולים לנהל את ההגדרה של מצב "תבניות בלבד" במסוף Firebase.

הרשאות ותפקידים נדרשים ב-IAM

כדי לנהל את ההגדרה של מצב "תבניות בלבד", נדרשת ההרשאה firebasevertexai.configs.update, שכלולה כברירת מחדל בתפקידי ה-IAM הבאים: בעלים, עריכה, אדמין ב-Firebase ואדמין ב-Firebase AI Logic.

אכיפת מצב "תבניות בלבד"

כך אוכפים את מצב "תבניות בלבד" בפרויקט Firebase:

אם עדיין לא עשיתם זאת, קראו את השיקולים החשובים לגבי מצב "תבנית בלבד" שמופיעים בתחילת המדריך הזה.
במסוף Firebase, נכנסים לכרטיסייה AI Services ‏> AI Logic ‏> Settings.
בקטע מצב תבנית, מעבירים את המתג אכיפת מצב תבנית בלבד למצב נאכף.
קוראים את תיבת הדו-שיח לאישור ולוחצים על אישור.

הפסקת האכיפה של מצב "תבניות בלבד"

אם אתם מפסיקים את האכיפה של מצב "תבניות בלבד", חשוב לשים לב לנקודות הבאות:

בקשות דרך Firebase AI Logic שלא משתמשות בתבניות לפרומפטים בשרת יאושרו.
זו הגדרה ברמת הפרויקט ב-Firebase AI Logic.

כך מפסיקים את האכיפה של מצב "תבנית בלבד" בפרויקט Firebase:

במסוף Firebase, נכנסים לכרטיסייה AI Services ‏> AI Logic ‏> Settings.
בקטע מצב תבנית, משביתים את האפשרות אכיפת מצב תבנית בלבד.
קוראים את תיבת הדו-שיח לאישור ולוחצים על אישור.