הוספת Firebase לאפליקציה ב-Google AI Studio

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

סקירה כללית: הוספת קצה עורפי לאפליקציית Google AI Studio

1. מתארים את הרעיון: יוצרים אפליקציה חדשה ב-Google AI Studio ומתארים תכונה שדורשת מסד נתונים או אימות. לדוגמה, אפשר להזין את הפרומפט: Build a shared to-do list app using Firebase as a backend.

2. מפעילים את השילוב עם Firebase: בכרטיס שמופיע, מגדירים את ההגדרה:

   1. התאמה אישית של פרויקט או מיקום (אופציונלי): לוחצים על סמל ההגדרות settings, ואז בוחרים מיקום או את הפרויקט Google Cloud שרוצים להשתמש בו.

   2. מאשרים את הבחירה: כדי להמשיך, לוחצים על הלחצן הפעלת Firebase.

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

   • אפליקציות אינטרנט:

     • שירותים אפשריים: Cloud Firestore,‏ Authentication וגם Firebase Security Rules
     • הקבצים כוללים /src/lib/firebase.ts ו-firestore.rules

3. פריסה: כשהאפליקציה מוכנה, משתמשים באפשרות שיתוף > פרסום כדי לפרוס את אפליקציית האינטרנט ב-Cloud Run. האפליקציה תיפרס אוטומטית לאותו פרויקט שבחרתם במהלך ההגדרה.

   לפני שמשתפים, מפרסמים או פורסים את האפליקציה, חשוב גם לבחון את Firebase Security Rules שנוצר על ידי AI.

הוספת Firebase לאפליקציה במהלך הפיתוח

אם רוצים להוסיף את השילוב עם Firebase לאפליקציה שעובדים עליה ב-Google AI Studio, אפשר לעשות זאת בכל שלב במהלך שלב האיטרציה באמצעות אחת מהאפשרויות הבאות:

• לדבר עם הסוכן: מבקשים מהסוכן להוסיף תכונה שדורשת מסד נתונים או אימות (לדוגמה, Add a Firestore database to this app).
• שימוש בתפריט ההגדרות: עוברים אל הגדרות > שילובים ולוחצים על האריח Firebase Firestore & Auth.

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

אחרי שמפעילים את השילוב, אפשר לבדוק את ההגדרה שלו בכל שלב. כדי לעשות את זה, עוברים אל Settings (הגדרות) > Integrations (שילובים) ולוחצים על האריח Firebase Firestore & Auth (אימות ו-Firestore של Firebase). ההגדרה כוללת את הפרויקט, המיקום, כתובת האימייל לתמיכה באפליקציה ומזהה מסד הנתונים.

הסבר על המכסה המשותפת של Cloud Firestore

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

• מכסת נפח אחסון משותפת: כל מסדי הנתונים בקבוצה חולקים מכסת נפח אחסון משותפת (פרטים בהמשך).
• לא נדרש חשבון Cloud Billing: אתם יכולים ליצור ולבדוק את האפליקציה בלי להוסיף חיוב. בהמשך מפורטות האפשרויות להוספת חיוב.
• איפוס יומי: אם תגיעו למכסת שימוש יומית (לדוגמה, 50,000 קריאות ביום), השירות יושהה את כל מסדי הנתונים בקבוצה וימשיך לפעול ביום הבא בסביבות חצות לפי שעון החוף הפסיפי.

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

(אופציונלי) הוספת חיוב כדי לקבל מכסת Cloud Firestore גדולה יותר

אם האפליקציה שלכם צוברת פופולריות ואתם צריכים להשתמש ב-Cloud Firestore מעבר למגבלות של התוכנית ללא עלות, אתם יכולים להוסיף אמצעי תשלום ולשדרג את פרויקט Firebase למינוי Blaze בתשלום לפי שימוש.

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

שלב 1. הוספת פרטי חיוב (אם עדיין לא עשיתם את זה)

אפשר להגדיר את החיוב ישירות ב-Google AI Studio.

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

שלב 2: שדרוג מסד הנתונים

גם אחרי שמוסיפים חיוב, מסדי נתונים של Cloud Firestore שנוצרו על ידי סוכן Google AI Studio נשארים בקבוצת המכסה המשותפת. כדי להפעיל שדרוג מלא בתשלום למסד נתונים ספציפי, צריך לשדרג אותו ידנית.

1. עוברים אל Firebase המסוף ובוחרים את הפרויקט שמכיל את מסד הנתונים שרוצים לשדרג.
2. בחלונית הניווט הימנית, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Firestore.
3. אם הפרויקט מכיל כמה מופעים של מסד נתונים Cloud Firestore, בוחרים את המופע שרוצים לשדרג.
4. מחפשים באנר בחלק העליון של הדף שבו מצוין שמסד הנתונים כפוף למגבלות מכסה משותפות של AI. כדי לשדרג את מסד הנתונים, לוחצים על שדרוג מסד הנתונים > שדרוג לתשלום לפי שימוש.אם הבאנר הזה לא מופיע, יכול להיות שמסד הנתונים לא נוצר על ידי סוכן Google AI Studio והוא לא חלק מקבוצת מכסת הנפח המשותפת, או שהוא כבר שודרג.

השינוי להשבתת המכסה המשותפת ולהפעלת חיוב לפי שימוש במסד הנתונים אמור להיכנס לתוקף תוך כמה דקות.

יצירת Security Rules

Google AI Studio הסוכן יוצר באופן אוטומטי Firebase Security Rules על סמך הלוגיקה של האפליקציה. ההרשאות האלה Security Rules מוגדרות כ'דחייה כברירת מחדל', כלומר משתמשי הקצה של האפליקציה יכולים לגשת רק לנתונים שבבעלותם.

שימו לב: אם תשנו את Security Rules באופן ידני ישירות במסוף Firebase, סוכן Google AI Studio לא ידע על השינויים והם יימחקו במהלך איטרציות עתידיות של האפליקציה. מומלץ להשתמש בסוכן Google AI Studio כדי לשנות את Firebase Security Rules ולוודא שהשינויים נשמרים ומתאימים ללוגיקה של האפליקציה.

שימוש בפרויקט קיים

כשמפעילים את השילוב עם Firebase בפעם הראשונה, אפשר לבחור פרויקט קיים Google Cloud שבבעלותכם:

1. בכרטיס שמופיע, לוחצים על סמל ההגדרות settings.
2. בוחרים את הפרויקט ולוחצים על הפעלת Firebase.

במהלך הפיתוח של האפליקציה, אפשר גם להנחות את הסוכן להשתמש בפרויקט אחר באמצעות הנחיה כמו:

Add Firestore to this app using project PROJECT_ID.

כשבוחרים פרויקט, הפעולות הבאות מתבצעות:

• מסד נתונים חדש של Cloud Firestore יוקצה לפרויקט הזה באמצעות המכסה המשותפת.
• Firebase Authentication עם כניסה באמצעות חשבון Google.
• תינתן גישה לחשבון שירות למסד הנתונים Cloud Firestore. כדי לאפשר גישת אדמין מ-Google AI Studio, יוענקו הרשאות גישה למסד הנתונים Cloud Firestore לחשבון שירות חדש בשם ais-sandbox@PROJECT_ID.iam.gservice.com. החשבון הזה משויך רק לאפליקציות של Google AI Studio.
• מגבלות: אם בפרויקט Firebase כבר יש מסד נתונים Cloud Firestore, הסוכן לא יוכל להוסיף עוד אחד. תצטרכו לבחור פרויקט אחר או ליצור פרויקט חדש וריק כדי להשתמש בו.

שימוש במסוף Firebase

אפשר לראות את הנתונים וההגדרות של האפליקציה במסוף Firebase. כך ניגשים לפרויקט Firebase שמשויך ל-Google AI Studio:

1. עוברים אל Firebase המסוף ובוחרים את הפרויקט עם התווית AI Studio.

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

   • כדי לראות ולערוך את נתוני Cloud Firestore המאוחסנים, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > Firestore.
   • כדי לראות או להגדיר את ההגדרות והנתונים של Authentication, עוברים אל אבטחה > אימות.

פתרון בעיות ושאלות נפוצות

במאמר הזה מפורטות תשובות לשאלות נפוצות ומוסבר איך לפתור בעיות שקשורות לשילוב של Firebase באפליקציית Google AI Studio.

איך נבחרים Google Cloud / פרויקט ומיקום ב-Firebase?

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

• התאמה אישית של הפרויקט או המיקום (אופציונלי): לוחצים על סמל ההגדרות settings, בוחרים מיקום או את הפרויקט Google Cloud שרוצים להשתמש בו, ואז לוחצים על הפעלת Firebase.

זכור את הנקודות הבאות:

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

אילו שיטות אימות נתמכות?

Google AI Studioהסוכן מגדיר כניסה באמצעות חשבון Google כשמבקשים להגדיר Authentication או מסך כניסה. כך מוסיפים שיטות כניסה נוספות לאפליקציה:

1. במסוף Firebase, עוברים אל Security > Authentication > Sign-in method page ומגדירים את שיטות הכניסה הרצויות.

2. חוזרים אל Google AI Studio ומבקשים מהסוכן של Google AI Studio עזרה בעדכון בסיס הקוד בשיטת הכניסה החדשה.

האם אפשר ליצור אפליקציה לנייד (למשל ל-Android או ל-iOS) באמצעות Google AI Studio?

הסוכן Google AI Studio תומך ביצירה של אפליקציות אינטרנט וגם של אפליקציות ל-Android.

עם זאת, חשוב לזכור שהשילוב עם Firebase (הוספה של Cloud Firestore ו-Authentication) נתמך כרגע רק באפליקציות אינטרנט, ולא באפליקציות ל-Android. אם אתם מפתחים אפליקציה ל-Android, אתם צריכים לשלב את Firebase באופן ידני אם אתם צריכים את השירותים האלה.

אי אפשר ליצור אפליקציות ל-iOS ב-Google AI Studio. עם זאת, כמו כל אפליקציות האינטרנט, אפשר לגשת לאפליקציות האינטרנט ש-Google AI Studio יוצרת כאפליקציות אינטרנט לנייד מדפדפנים שמותקנים במכשירים ניידים (כולל iOS).

מידע נוסף על פיתוח אפליקציות ל-Android זמין במסמכי התיעוד של Google AI Studio.

מהו קובץ firebase-blueprint.json?

זהו קובץ ביניים שסוכן Google AI Studio משתמש בו כדי להבין את בסיס הקוד של האפליקציה. אל תשנו את הקובץ הזה באופן ידני, כי זה עלול לגרום לסוכן ליצור קוד שגוי או Security Rules לא מאובטח.

מה עושים אם מוצגת השגיאה 'חרגת מהמכסה'?

הגעה לCloud Firestoreמגבלת מכסה פירושה שהאפליקציה הגיעה למגבלת השימוש היומית שלה בCloud Firestoreקבוצת המכסות המשותפות של מסד הנתונים. יש שתי דרכים לפתור את הבעיה:

• אפשרות 1: לחכות: המכסות מתאפסות מדי יום בסביבות חצות לפי שעון החוף המערבי.
• אפשרות 2: שדרוג: שדרוג למינוי Blaze בתשלום לפי שימוש.
  • אם Google AI Studioהסוכן הגדירCloud Firestore בשבילכם את מסד הנתונים, תצטרכו ללחוץ על הלחצן שדרוג מסד הנתונים שמתואר במאמר הוספת חיוב כדי לקבל מכסת Cloud Firestore גדולה יותר כדי להעביר את מסד הנתונים למצב רגיל בתשלום. אם הגדרתם את Cloud Firestore באופן ידני, לא צריך להשתמש בלחצן שדרוג מסד הנתונים.

מה עושים אם מקבלים את השגיאה 'חסרות הרשאות או שההרשאות לא מספיקות'?

השגיאה הזו מתרחשת כשהאפליקציה מנסה לקרוא נתונים ממסד הנתונים Cloud Firestore או לכתוב נתונים למסד הנתונים, אבל הבקשה נדחית על ידי Security Rules. השגיאה הזו מציינת שההרשאות Security Rules לא מאפשרות את הפעולה שניסיתם לבצע, בהתבסס על מצב האימות הנוכחי או על נתיב הנתונים. לוחצים על הלחצן תיקון השגיאה כדי להנחות את סוכן Google AI Studio לנסות לתקן את Security Rules.

מה קורה ל-backend של Firebase כשמוחקים את האפליקציה Google AI Studio?

מחיקת האפליקציה ב-Google AI Studio לא גורמת למחיקה אוטומטית של פרויקט Firebase המקושר, של מסד הנתונים Cloud Firestore או של ההגדרות Firebase Authentication.

אם הוספתם קצה עורפי של Firebase, אתם צריכים להיכנס ידנית למסוף Firebase ולמחוק את הפרויקט או לנקות משאבים ספציפיים (כמו מופע מסד הנתונים Cloud Firestore וספקי Authentication) כדי לוודא שכל הנתונים וההגדרות הוסרו.

האם סוכן Google AI Studio יכול למחוק או לערוך נתונים במסד הנתונים של Cloud Firestore?

הסוכן Google AI Studio נועד לעזור בהקצאת משאבי ה-Backend הנדרשים וליצור קוד ו-Security Rules. הסוכן עצמו לא יכול למחוק, לערוך או לשנות רשומות נתונים במסד הנתונים שלכם ב-Cloud Firestore, אבל הוא יכול לכתוב קוד באפליקציה שנועד לבצע את הפעולות האלה. כדי לבצע משימות של ניהול נתונים, כמו מחיקת רשומות, עוברים אל Databases & Storage > Firestore page במסוף Firebase.

אני שייך לארגון שמשתמש ב-Google Cloud. האם אוכל לקשר את אפליקציית Google AI Studio שלי לפרויקט קיים בסביבת Google Cloud של הארגון שלי?

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

• במהלך ההפעלה: כשמפעילים את השילוב עם Firebase בפעם הראשונה ב-Google AI Studio, בוחרים את הפרויקט הקיים בכרטיס שמופיע. לוחצים על סמל ההגדרות settings ובוחרים את הפרויקט.

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

    Add Firestore to this app using project PROJECT_ID.
  

למה לא הצלחתי למצוא מסמכים מסוימים במסוף Firebase?

כשסוכן ב-AI Studio שומר נתונים בנתיב מקונן (כמו /users/user1/messages/msg1) בלי ליצור קודם את מסמך האב (user1), הוא יוצר מה שנקרא מסמך אב שלא קיים. המסמכים האלה לא מוצגים במסוף Firebase, ולכן קשה למצוא אותם כשמעיינים במסד הנתונים Cloud Firestore. למרות שהבעיה הזו לא משפיעה על האופן שבו האפליקציה פועלת, אפשר לתאר את הבעיה לסוכן של AI Studio כדי להנחות אותו ליצור את מסמכי האב שחסרים.

פרטים נוספים זמינים במאמר בנושא מסמכי אב שלא קיימים.

האם אפשר לבחור את המיקום של מסד הנתונים Cloud Firestore?

כן. כשמפעילים את השילוב עם Firebase ב-Google AI Studio בפעם הראשונה, אפשר לבחור את המיקום של Cloud Firestore מסד הנתונים.

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

אחרי שמשדרגים מסד נתונים של Cloud Firestore, אפשר להחזיר אותו לקבוצת המכסות המשותפת?

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

• ‫PROJECT_ID : מזהה הפרויקט ב-Firebase. המספר הזה מופיע בדף כללי של מסוף Firebase, בקטע settings הגדרות.

• ‫DATABASE_ID : מזהה מסד הנתונים Cloud Firestore, שיהיה זהה למזהה האפלט. כדי למצוא את מזהה מסד הנתונים הזה ב-Google AI Studio, עוברים אל הגדרות > שילובים ולוחצים על האריח Firebase Firestore & Auth.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
-d '{"free_tier_limited": true}'

איך Google משתמשת בנתונים שלי (לדוגמה, קוד והנחיות) ב-Google AI Studio?

פרטים על אופן השימוש בנתונים שלכם מופיעים בתנאים ובהגבלות הנוספים של Gemini API.

קיבלתי אימייל מ-Google Cloud בנושא "מפתח Google API עם גישה ציבורית לפרויקט Google Cloud שלך". מה עליי לעשות?

אם קיבלתם אימייל מכתובת Google Cloud בנושא "מפתח Google API שנגיש לציבור בפרויקט Google Cloud" ומפתח ה-API שמופיע באימייל הוא מפתח Firebase API, עליכם לוודא שמפתח ה-API עומד בדרישות הבאות כדי שתוכלו לכלול אותו בקוד או בקובצי ההגדרות שלכם בצורה בטוחה. בדף APIs & Services > Credentials במסוף Google Cloud אפשר לבדוק את הפרטים הבאים:

• זהו מפתח ה-API שבו אתם משתמשים באפליקציית Firebase ורק בשירותי Firebase. המקשים האלה נקראים בדרך כלל Browser key (auto created by Firebase) או Android key (auto created by Firebase) או iOS key (auto created by Firebase).
• המפתח כולל את כל ממשקי ה-API שקשורים ל-Firebase ונדרשים, שמופיעים ברשימת ההיתרים של 'הגבלות על API' במפתח.
• לא מופיעים בו ממשקי API אחרים ברשימת ההיתרים 'API restrictions'. בפרט, הרשימה לא צריכה לכלול Generative Language API.

בנוסף, חשוב לוודא שאתם משתמשים ב-Firebase Security Rules וב-App Check כמומלץ במוצרי Firebase שבהם אתם משתמשים.

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