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

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

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

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

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

כשהמצב 'תבניות בלבד' נאכף

כשמצב 'תבניות בלבד' נאכף, חשוב לשים לב לדברים הבאים:

• ההגדרה הזו היא הגדרה בכל הפרויקט של Firebase AI Logic.

  • היא חלה על כל האפליקציות שרשומות בפרויקט.
  • היא חלה רק על הפרויקט שבו היא נאכפת.

• ההגדרה הזו חלה על כל הבקשות דרך Firebase AI Logic אל Gemini Developer API וגם אל Vertex AI Gemini API.

• ההגדרה הזו חוסמת כל בקשה דרך Firebase AI Logic שלא משתמשת בתבניות של הנחיות לשרת. האיסור הזה כולל חסימת בקשות מהאפליקציה שלכם שמשתמשות ביכולות של תבניות הנחיות לשרת שעדיין לא נתמכות.

• ההגדרה הזו לא חוסמת בקשות של Gemini API בפרויקט שלא מגיעות דרך Firebase AI Logic.

• אם משתמשים ב-Firebase AI Logic REST API:

  • ההגדרה הזו לא חוסמת בקשות למסקנות שמשתמשות בתבניות של הנחיות לשרת (למשל, שימוש ב-templateGenerateContent או ב-templateStreamGenerateContent).
  • ההגדרה הזו לא חוסמת בקשות של control-plane (כמו בקשות לניהול תבניות והגדרות).

• ההגדרה הזו לא חוסמת בקשות אל countTokens (Count Tokens API).

לפני שמפעילים את המצב 'תבניות בלבד'

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

• אם יש לכם גרסאות קיימות של האפליקציה שלא משתמשות בתבניות של הנחיות לשרת:

  • ההגדרה הזו תחסום בקשות דרך Firebase AI Logic מגרסאות קיימות של האפליקציה.
  • חשוב לוודא שכל הלקוחות הפעילים מעודכנים לשימוש בתבניות של הנחיות לשרת לפני שמפעילים את המצב של שימוש בתבניות בלבד.

• אם האפליקציה משתמשת ביכולות של תבניות הנחיות לשרת שעדיין לא נתמכות:

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

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

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

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

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

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

כדי להפעיל את מצב התבניות בלבד בפרויקט Firebase:

1. אם עדיין לא עשיתם את זה, כדאי לעיין בשיקולים החשובים למצב של תבניות בלבד שמופיעים בהמשך המדריך הזה.

2. במסוף Firebase, עוברים אל AI Services (שירותי AI) > AI Logic (לוגיקת AI) > הכרטיסייה Settings (הגדרות).

3. בקטע מצב תבנית, מעבירים את המתג של אכיפת מצב של תבנית בלבד למצב נאכף.

4. בודקים את תיבת הדו-שיח לאישור ולוחצים על אישור.

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

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

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

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

1. במסוף Firebase, עוברים אל AI Services (שירותי AI) > AI Logic (לוגיקת AI) > הכרטיסייה Settings (הגדרות).

2. בקטע מצב תבנית, משביתים את האפשרות החלת מצב 'רק תבניות'.

3. בודקים את תיבת הדו-שיח לאישור ולוחצים על אישור.