הוספת Cloud Firestore ואימות לאפליקציית Google AI Studio

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

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

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

2. מפעילים את השילוב עם Firebase: בוחרים בצ'יפ Add Firebase backend (הוספת עורף Firebase). הסוכן יוצר את הקוד הנדרש, כולל קובץ /src/lib/firebase.ts וקובץ firestore.rules, ואז מקשר את האפליקציה ל-Cloud Firestore ול-Firebase Authentication.

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

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

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

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

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

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

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

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

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

   • ‫PROJECT_ID : מזהה הפרויקט ב-Firebase. אפשר למצוא את המזהה הזה בהגדרות הפרויקט במסוף Firebase.
   • ‫DATABASE_ID : Cloud Firestore מזהה מסד הנתונים, שזהה למזהה האפלט. אפשר למצוא את מזהה מסד הנתונים הזה בעמודה Name בדף מסדי הנתונים Cloud Firestore במסוף Firebase.

   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=limited_free_tier" \
   -d '{"limited_free_tier": false}'
   

‫Security Rules יצירה

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

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

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

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

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. כדי לגשת לפרויקטים שמשויכים ל-Google AI Studio, פועלים לפי השלבים הבאים:

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

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

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

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

הסוכן Google AI Studio מגדיר כניסה באמצעות חשבון Google כשמשתמשים בתכונה הוספת Firebase backend. כדי להגדיר שיטות נוספות, צריך להפעיל אותן במסוף Firebase ולבקש מהסוכן של 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 או לכתוב נתונים בו, אבל הבקשה נדחית על ידי 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, אבל הוא יכול לכתוב קוד באפלט שנועד לבצע את הפעולות האלה. כדי לבצע משימות של ניהול נתונים, כמו מחיקת רשומות, עוברים אל דף מסד הנתונים Cloud Firestore במסוף Firebase.

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

מוודאים שפרויקט Firebase ממוקם בתוך Google Cloudתיקייה של ארגון מסוים:

1. יוצרים את פרויקט Firebase באופן ידני מראש.

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

   Add Firestore to this app using project PROJECT_ID.
   

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

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

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

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

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

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

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