רשימת משימות לשימוש ב-Firebase AI Logic

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

כללי

עיון ברשימת המשימות הכללית להשקה

לפני שמשיקים אפליקציית Firebase בסביבת הייצור, כדאי לעיין ברשימת המשימות להשקה של Firebase כדי לראות שיטות מומלצות חשובות.

שיטות מומלצות לפרויקטים ב-Firebase

השתמשו בפרויקטים נפרדים ב-Firebase לפיתוח, לבדיקה ולייצור. שיטות מומלצות נוספות לניהול פרויקטים

אבטחה וגישה

עיון ברשימות המשימות לאבטחה

כדאי לעיין ברשימת משימות האבטחה של Firebase וברשימת משימות האבטחה הייעודית של Firebase AI Logic כדי לקבל שיטות מומלצות חשובות בנושא גישה ואבטחה.

אכיפה Firebase App Check

אוכפים את Firebase App Check כדי להגן על Gemini API מפני ניצול לרעה כשקוראים לו ישירות מהאפליקציה. כשאוכפים את App Check, הוא מאמת שהבקשות הנכנסות מגיעות מהאפליקציה האותנטית ו/או ממכשיר שלא בוצעו בו שינויים.

‫App Check תומך בספקי אימות לפלטפורמות של Apple‏ (DeviceCheck,‏ App Attest או reCAPTCHA Enterprise), Android‏ (Play Integrity או reCAPTCHA Enterprise) ואינטרנט (reCAPTCHA Enterprise). הוא תומך בכל הספקים האלה גם לאפליקציות Flutter ו-Unity.

כדאי גם לאכוף הגנה מפני הפעלה חוזרת, כלומר שהאסימונים יהיו לשימוש חד-פעמי בלבד. האפשרות הזו מציעה הגנה משופרת מעבר להגנה הבסיסית, ומאפשרת לכם להגדיר רמת הגנה שמתאימה לאפליקציה ולתרחישי השימוש שלכם.

הגדרת הגבלות על מפתחות ה-API של Firebase

מפתחות ה-API של Firebase מזהים את פרויקט Firebase והאפליקציה שלכם כשאתם שולחים בקשות. כדי למנוע שימוש לא מורשה במפתחות ה-API:

  • מגדירים את Application restrictions במסוף Google Cloud כדי להגביל את השימוש במפתח רק לבקשות ממזהה החבילה הספציפי של האפליקציה (Apple), משם החבילה ומטביעת האצבע מסוג SHA-1‏ (Android) או מהמפנה ב-HTTP (אינטרנט).

  • בודקים את רשימת ההיתרים API restrictions של כל מפתח:

שימו לב שממשקי API שקשורים ל-Firebase משתמשים במפתחות API רק כדי לזהות את הפרויקט או האפליקציה ב-Firebase, ולא כדי לאשר את הקריאה ל-API.

הגבלת הבקשות למשתמשים מאומתים בלבד

כדאי לשקול לאכוף את מצב המשתמשים המאומתים, כדי שכל הבקשות דרך Firebase AI Logic יכללו פרטי כניסה תקינים מ-Firebase Authentication. אם הבקשה מגיעה ממשתמש קצה לא מאומת, היא נדחית ומוצגת השגיאה 401: unauthenticated.

מעקב, מגבלות וחיוב

הגדרת מעקב אחרי שימוש בתכונות AI במסוף Firebase

הגדירו מעקב אחרי שימוש ב-AI במסוף Firebase כדי לקבל תובנות לגבי מדדי ביצועים מרכזיים, כמו מספר הבקשות, זמן האחזור, השימוש בטוקנים ושיעורי השגיאות. אפשר גם לבדוק מעקבים ספציפיים במסוף Google Cloud.

הגדרת מגבלות קצב וניהול מכסות

כדי להגן על הפרויקט מפני עלייה חדה ובלתי צפויה בשימוש ומתקפות DoW:

התראות ותקרות הוצאה שימנעו הפתעות בחשבון

אם הפרויקט ב-Firebase נמצא בתוכנית התמחור Blaze בתשלום לפי שימוש:

ניהול הגדרות אישיות

שימוש בגרסת מודל יציבה באפליקציה בסביבת הייצור

באפליקציה בסביבת הייצור, השתמשו רק בגרסאות יציבות של המודל (כמו gemini-3.8-flash). אל תשתמשו בגרסת תצוגה מקדימה או בגרסה ניסיונית, או בכינוי -latest.

שימוש בתבניות לפרומפטים ב-Firebase Remote Config או בשרת

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

  • (מומלץ מאוד) לשנות לפי הצורך את שם המודל שמשמש את תכונת ה-AI, כשמודלים חדשים מתפרסמים או כשמודלים אחרים מושבתים. איך משתמשים ב-Remote Config או בתבניות לפרומפטים בשרת

  • (אופציונלי) לשלוט באופן דינמי ואפילו מותנה בפרמטרים אחרים של תכונת ה-AI, למשל הגדרות המודל (כמו מספר האסימונים המקסימלי בפלט), הגדרות הבטיחות, הוראות המערכת ונתוני ההנחיות. איך משתמשים ב-Remote Config או בתבניות לפרומפטים בשרת

  • (אופציונלי) מגדירים פרמטר minimum_version ב-Remote Config כדי להשוות בין הגרסה הנוכחית של האפליקציה לבין הגרסה העדכנית שמוגדרת ב-Remote Config, וכך להציג למשתמשים התראה על שדרוג או לאלץ אותם לשדרג.

הגדרת המיקום לגישה למודל

האפשרות הזו זמינה רק כשמשתמשים ב-Agent Platform Gemini API (formerly Vertex AI) כספק ה-API.

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

אם לא מציינים מיקום, ברירת המחדל היא global (כשמשתמשים בתחביר החדש של Agent Platform לאתחול). אפשר להגדיר את המיקום הזה במהלך ההפעלה, או להשתמש ב-Firebase Remote Config כדי לשנות את המיקום באופן דינמי על סמך המיקום של כל משתמש.