הוספת Cloud Firestore ואימות לאפליקציית 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: בכרטיס שמופיע, אפשר להתאים אישית את ההגדרה:

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

    הסוכן מקשר באופן אוטומטי את האפליקציה לפרויקט Firebase ויוצר את הקודים הנדרשים Cloud Firestore ו-Authentication, כולל קובץ /src/lib/firebase.ts וקובץ firestore.rules.

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

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

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

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

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

מדד מכסה
נתונים מאוחסנים ‫1GiB סה"כ
תעבורת נתונים יוצאת מהרשת ‫10GiB לחודש
יחידות כתיבה ‫40,000 כתיבות ביום
קריאת יחידות ‫50,000 קריאות ביום
יחידות עדכון בזמן אמת ‫50,000 עדכונים ביום

(אופציונלי) הוספת חיוב כדי לקבל מכסת 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 נשארים בקבוצת המכסה המשותפת. כדי להפעיל הרחבה מלאה בתשלום למסד נתונים ספציפי, צריך להוציא אותו מהקבוצה באופן ידני באמצעות פקודה curl.

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

  • ‫DATABASE_ID : מזהה מסד הנתונים Cloud Firestore, שיהיה זהה למזהה האפלט. כדי למצוא את מזהה מסד הנתונים הזה במסוף Firebase, עוברים אל Databases & Storage (מסדי נתונים ואחסון) > הדף Firestore ואז מחפשים בעמודה Name (שם).

    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": false}'

אימות שדרוג מסד הנתונים

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

  • בודקים את האפליקציה (מומלץ): הדרך הכי אמינה לוודא שהשדרוג בוצע היא להשתמש באפליקציה. ביצוע Cloud Firestore פעולות שבעבר חרגו מהמגבלות היומיות ללא עלות (לדוגמה, חריגה מספי ה-Cloud Firestore של מהדורת Enterprise של 50,000 יחידות קריאה או 40,000 יחידות כתיבה). הפעולות האלה אמורות להצליח עכשיו ללא שגיאות RESOURCE_EXHAUSTED.

  • בדיקת סטטוס מסד הנתונים באמצעות API: אפשר להשתמש בבקשת curl GET כדי לאחזר את הפרטים הנוכחיים של מסד הנתונים:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID"

    בודקים את תגובת ה-JSON. אם השדה freeTierLimited לא מופיע בתגובה, סימן שהשדרוג של מסד הנתונים בוצע בהצלחה וההגבלה הוסרה.

    .

    הסבר על freeTier לעומת freeTierLimited: סביר להניח שעדיין תראו את "freeTier": true בתשובה של GET. השדה הזה נפרד מההגדרה freeTierLimited ששיניתם. "freeTier": true קשור למקור של מסד הנתונים ולפוטנציאל השימוש ברמת המחירים ללא עלות. ההגדרה הזו לא אומרת שהמגבלות היומיות עדיין יחולו אחרי שתגדירו את freeTierLimited ל-false. אם המגבלות מושבתות בהצלחה, השדה freeTierLimited לא יופיע בתגובה GET.

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

יצירה 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. בכרטיס שמופיע, לוחצים על סמל ההגדרות .
  2. בוחרים את הפרויקט ולוחצים על שמירה.

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

Add Firestore to this app using project PROJECT_ID.

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

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

שימוש במסוף Firebase

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

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

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

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

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

ריכזנו בהמשך תשובות לשאלות נפוצות ומידע על פתרון בעיות שקשורות לשילוב של Firebase עם אפליקציית Google AI Studio.

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

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

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

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

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

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

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

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

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

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

בשלב הזה, סוכן Google AI Studio יכול ליצור רק אפליקציות אינטרנט. מידע נוסף על מה שנתמך בGoogle AI Studioמסמכי התיעוד של הסוכן

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

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

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

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

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

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

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

השגיאה הזו מתרחשת כשהאפליקציה מנסה לקרוא נתונים ממסד הנתונים 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 נועד לעזור בהקצאת המשאבים הנדרשים בשרת האחורי וליצור קוד ו-Security Rules. הסוכן עצמו לא יכול למחוק, לערוך או לשנות ישירות רשומות נתונים במסד הנתונים של Cloud Firestore, אבל הוא יכול לכתוב קוד באפליקציה שנועד לבצע את הפעולות האלה. כדי לבצע משימות של ניהול נתונים, כמו מחיקת רשומות, עוברים אל Databases & Storage > Firestore page במסוף Firebase.

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

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

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

  • במהלך איטרציה: אם כבר הפעלתם את 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.

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

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

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

קיבלתי אימייל מכתובת Google Cloud בנושא "מפתח API של Google עם גישה ציבורית לפרויקט 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'. בפרט, הרשימה לא יכולה לכלול Generative Language API.

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

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