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

אתם יכולים לאכוף מצב של תבניות בלבד בפרויקט 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.

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

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

• ההגדרה הזו לא חוסמת בקשות אל 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. קוראים את תיבת הדו-שיח לאישור ולוחצים על אישור.