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

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

‫App Prototyping agent הוא תהליך פיתוח יעיל ללא קוד שמשתמש ב-AI גנרטיבי כדי לפתח, לבדוק, לשפר ולפרסם אפליקציית אינטרנט מלאה. אתם מתארים את הרעיון שלכם לאפליקציה בשפה טבעית, ואם רוצים אפשר גם להוסיף תמונה. הסוכן יוצר תוכנית לאפליקציה, קוד ותצוגה מקדימה של האפליקציה באינטרנט. כדי לעזור לכם לפתח ולפרסם את אפליקציית ה-full-stack,‏ Firebase Studio יכול להקצות באופן אוטומטי את השירותים הבאים:

  • אם האפליקציה שלכם משתמשת ב-AI: Firebase Studio מוסיף את Gemini Developer API לאפליקציה שלכם באמצעות Genkit זרימות כדי לעבוד עם Gemini. אתם יכולים להשתמש במפתח Gemini API משלכם או לאפשר ל-Firebase Studio להקצות לכם פרויקט ב-Firebase ומפתח Gemini API.
  • אם רוצים לפרסם את האפליקציה באינטרנט: Firebase Studio יוצר פרויקט ומספק דרך מהירה לפרסם את האפליקציה באמצעות Firebase App Hosting.

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

שנתחיל?

כדי להתחיל להשתמש ב-App Prototyping agent, פועלים לפי השלבים הבאים:

  1. מתחברים לחשבון Google ופותחים את Firebase Studio.

  2. בשדה Prototype an app with AI (יצירת אב טיפוס של אפליקציה באמצעות AI), מתארים את הרעיון לאפליקציה בשפה טבעית.

    לדוגמה, אפשר להזין הנחיה כמו זו כדי ליצור אפליקציה ליצירת מתכונים:

    Use secure coding practices to create an error-free web app that lets
users upload a photo or take a picture with their browser
camera. The app identifies the food in the picture and generates a
recipe and accompanying image that includes that food.

If no food product is identified, generate a random dessert recipe.

  3. אפשר להעלות תמונה שתצורף להנחיה. לדוגמה, אפשר להעלות תמונה שמכילה את ערכת הצבעים שרוצים שהאפליקציה תשתמש בה ולבקש מ-Firebase Studio להשתמש בה. התמונות חייבות להיות קטנות מ-3MiB.

  4. לוחצים על אב טיפוס עם AI.

    ‫App Prototyping agent יוצר תוכנית לאפליקציה על סמך ההנחיה שלכם, ומחזיר שם מוצע לאפליקציה, תכונות נדרשות והנחיות לגבי סגנון.

  5. בודקים את התוכנית. אם צריך, מבצעים כמה שינויים. לדוגמה, אתם יכולים לשנות את השם המוצע של האפליקציה או את ערכת הצבעים באמצעות אחת מהאפשרויות הבאות:

    • לוחצים על התאמה אישית ועורכים את תוכנית האב ישירות. מבצעים את השינויים ולוחצים על שמירה.

    • בשדה Describe... בחלונית הצ'אט, מוסיפים שאלות הבהרה והקשר. אפשר גם להעלות תמונות נוספות.

  6. לוחצים על Prototype this app (יצירת אב טיפוס של האפליקציה הזו).

  7. ‫App Prototyping agent מתחיל לקודד את האפליקציה.

    • אם האפליקציה שלכם משתמשת ב-AI, תתבקשו להוסיף או ליצור מפתח Gemini API. אם תלחצו על 'יצירה אוטומטית', מערכת App Prototyping agent תספק לכם פרויקט Firebase ומפתח Gemini API.

בדיקה, שיפור, ניפוי באגים ושינויים

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

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

  • הוספת Cloud Firestore ו-Firebase Authentication: בשלב האיטרציה, אפשר לבקש מ-App Prototyping agent להוסיף אימות משתמשים ומסד נתונים באמצעות Cloud Firestore ו-Firebase Authentication. לדוגמה, אפשר לתת למשתמשים את האפשרות לשמור ולהוריד מתכונים באמצעות הנחיה כמו הבאה:

    Add user authentication to the app. Authenticated users can:

  - Download the recipe and its generated image as a PDF (Print).

  - Save the recipe as public or private and make accessible to a search
    feature. For now, just save the text, not the image, to the database.

Important: Only authenticated users can download the PDF.

  • תיקון שגיאות שמתרחשות: ברוב המקרים, App Prototyping agent יציג הנחיות לתיקון שגיאות שמתרחשות. לוחצים על תיקון השגיאה כדי לאפשר לו לנסות לתקן אותה.

    אם אתם מקבלים שגיאות שלא מוצגות לכם הנחיות לתיקון שלהן באופן אוטומטי, אתם יכולים להעתיק את השגיאה ואת ההקשר הרלוונטי (למשל, "Can you fix this error in my Firebase initialization code?" [האם תוכל לתקן את השגיאה הזו בקוד האתחול של Firebase?]) לחלון הצ'אט ולשלוח אותה אל Gemini.

  • בדיקה ושיפור באמצעות שפה טבעית: כדאי לבדוק את האפליקציה ביסודיות ולעבוד עם App Prototyping agent כדי לשפר את הקוד ואת תוכנית הפעולה עד שתהיו מרוצים מהם.

    כשאתם בתצוגה של Prototyper, אתם יכולים להשתמש גם בתכונות הבאות:

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

    • לוחצים על בחירת סמל בחירה כדי לבחור רכיב ספציפי ולהזין הוראות לApp Prototyping agent. כך תוכלו לטרגט במהירות סמל, לחצן, קטע טקסט או רכיב אחר ספציפיים. כשלוחצים על תמונה, אפשר גם לחפש ולבחור תמונה ממאגר התמונות של Unsplash.

    אופציונלי: אפשר ללחוץ על סמל הקישור שיתוף קישור לתצוגה מקדימה כדי לשתף את האפליקציה באופן ציבורי וזמני באמצעות Firebase Studio תצוגות מקדימות ציבוריות.

  • יצירת פרויקט Firebase: App Prototyping agent יוצרת פרויקט Firebase בשמכם כשאתם:

    • יצירה אוטומטית של מפתח Gemini API
    • בקשה לקישור האפליקציה לפרויקט Firebase
    • לבקש עזרה בחיבור האפליקציה לשירותי Firebase, כמו Cloud Firestore או Firebase Authentication
    • לוחצים על הלחצן פרסום ומגדירים את Firebase App Hosting

    כדי לשנות את פרויקט Firebase שמקושר למרחב העבודה, מזינים את מזהה הפרויקט שרוצים להשתמש בו במקום App Prototyping agent. לדוגמה, "עבור לפרויקט Firebase עם המזהה <your-project-id>".

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

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

    כשמבקשים מ-App Prototyping agent להוסיף Cloud Firestore, הוא כותב ומטמיע בשבילכם כללים למסד הנתונים של Cloud Firestore. בודקים את הכללים במסוף Firebase.

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

    בתצוגה של Code, אפשר גם להשתמש בתכונות המועילות הבאות:

    • Firebase Studioהשתמשו בתכונות המובנות לניפוי באגים ולדיווח כדי לבדוק, לנפות באגים ולבצע ביקורת באפליקציה.

    • עזרה מ-AI באמצעות Gemini השלמה אוטומטית של קוד או באמצעות Geminiצ'אט אינטראקטיבי (שניהם זמינים כברירת מחדל). הצ'אט האינטראקטיבי יכול לאבחן בעיות, לספק פתרונות ולהריץ כלים שיעזרו לכם לתקן את האפליקציה מהר יותר. כדי לגשת לצ'אט, לוחצים על הסמל sparkGemini בתחתית סביבת העבודה.

    • גישה ל-Firebase Local Emulator Suite כדי להציג נתונים של מסד נתונים ואימות. כדי לפתוח את האמולטור בסביבת העבודה:

      1. לוחצים על סמל של החלפת קוד מעבר לקוד ופותחים את התוסף Firebase Studio (Ctrl+',Ctrl+' או Cmd+',Cmd+' ב-MacOS).

      2. גוללים אל Backend ports ומרחיבים אותו.

      3. בעמודה פעולות שמתאימה ליציאה 4000, לוחצים על פתיחה בחלון חדש.

  • בדיקה ומדידה של הביצועים של תכונות מבוססות-AI גנרטיבי: אתם יכולים להשתמש בGenkit Developer UI כדי להריץ את תהליכי ה-AI שלכם, לבדוק, לנפות באגים, ליצור אינטראקציה עם מודלים שונים, לשפר את ההנחיות ועוד.Genkit

    כדי לטעון את התהליכים של Genkit ב-Genkit Developer UI ולהתחיל בבדיקה:

    1. בטרמינל בסביבת העבודה Firebase Studio, מריצים את הפקודה הבאה כדי לאתר את המפתח Gemini API ולהפעיל את השרת Genkit:

       npm run genkit:watch

    2. לוחצים על הקישור Genkit Developer UI. החלון החדש ייפתח עם התהליכים, ההנחיות, רכיבי ההטמעה ומבחר של מודלים שונים שזמינים לכם.Genkit Developer UI

    מידע נוסף על Genkit Developer UI זמין במאמר Genkit Developer Tools.

פרסום האפליקציה באמצעות Firebase App Hosting

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

כשמגדירים את App Hosting, המערכת יוצרת עבורכם פרויקט Firebase (אם לא נוצר כבר פרויקט כזה על ידי יצירה אוטומטית של מפתח Gemini API או שירותי קצה עורפי אחרים) ומנחה אתכם בתהליך הקישור של חשבון Cloud Billing.Firebase Studio

כדי לפרסם את האפליקציה:

  1. לוחצים על פרסום כדי להגדיר את פרויקט Firebase ולפרסם את האפליקציה. החלונית פרסום האפליקציה מופיעה.

  2. בשלב פרויקט Firebase, מוצג App Prototyping agent פרויקט Firebase שמשויך למרחב העבודה. אם פרויקט Firebase לא קיים, App Prototyping agent יוצר פרויקט חדש בשבילכם. כדי להמשיך, לוחצים על הבא.

  3. בשלב Link Cloud Billing account (קישור חשבון Cloud Billing), בוחרים באחת מהאפשרויות הבאות:

    • בוחרים את Cloud Billing החשבון שרוצים לקשר לפרויקט ב-Firebase.

    • אם אין לכם חשבון Cloud Billing או שאתם רוצים ליצור חשבון חדש, לוחצים על יצירת חשבון Cloud Billing. מסוף Google Cloud ייפתח, ובו תוכלו ליצור חשבון חדש בשירות עצמי של Cloud Billing. אחרי שיוצרים את החשבון, חוזרים אל Firebase Studio ובוחרים את החשבון מהרשימה קישור אל Cloud Billing.

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

    App Hosting

  5. לוחצים על הגדרת שירותים. App Prototyping agent מתחיל להקצות שירותי Firebase.

  6. לוחצים על פרסום עכשיו. ‫Firebase Studio מגדיר את שירותי Firebase ואז מפעיל את App Hosting ההשקה. התהליך עשוי להימשך כמה דקות. מידע נוסף על מה שקורה מאחורי הקלעים זמין במאמר בנושא תהליך build של App Hosting.

  7. כששלב הפרסום מסתיים, מופיע הדף סקירה כללית של האפליקציה עם כתובת URL ותובנות לגבי האפליקציה שמבוססות על App Hosting יכולת צפייה. כדי להשתמש בדומיין מותאם אישית (כמו example.com או app.example.com) במקום בדומיין שנוצר על ידי Firebase, אפשר להוסיף דומיין מותאם אישית במסוף Firebase.

מידע נוסף על App Hosting זמין במאמר הסבר על App Hosting ואיך הוא פועל.

אבטחת האפליקציה באמצעות Firebase App Check ו-reCAPTCHA Enterprise

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

מומלץ להוסיף את App Check לכל אפליקציה שאתם מפרסמים באופן ציבורי כדי להגן על משאבי ה-Backend מפני שימוש לרעה.

בקטע הזה נסביר איך להגדיר App Check בתוך Firebase Studio באמצעות reCAPTCHA Enterprise עבור אפליקציית אינטרנט שנוצרה על ידי App Prototyping agent, אבל אפשר להגדיר App Check בכל אפליקציה שמטמיעה שירותי Firebase ויכולה להטמיע ספקי אימות מותאמים אישית. מידע נוסף זמין בכתובת Firebase App Check.

‫reCAPTCHA Enterprise מספק עד 10,000 בדיקות ללא עלות.

שלב 1: הגדרת reCAPTCHA Enterprise לאפליקציה

  1. פותחים את הקטע reCAPTCHA Enterprise במסוף Google Cloud.

  2. בוחרים את השם של פרויקט Firebase מתוך כלי לבחירת פרויקטים במסוף Google Cloud.

  3. אם תתבקשו להפעיל את reCAPTCHA Enterprise API, תצטרכו לעשות זאת.

  4. לוחצים על תחילת העבודה ומוסיפים שם לתצוגה למפתח האתר של reCAPTCHA.

  5. מאשרים את מפתח סוג האפליקציה Web שמוגדר כברירת מחדל.

  6. לוחצים על הוספת דומיין ומוסיפים דומיין. כדאי להוסיף את הדומיין App Hosting (לדוגמה, App Hosting) וכל דומיין מותאם אישית שאתם משתמשים בו באפליקציה או מתכננים להשתמש בו באפליקציה.studio--PROJECT_ID.REGION.hosted.app

  7. לוחצים על השלב הבא.

  8. לא מסמנים את התיבה האם תשתמשו באתגרים?.

  9. לוחצים על Create key.

  10. מעתיקים את מזהה המפתח ושומרים אותו, ואז ממשיכים אל הגדרת App Check.

שלב 2: הגדרה של App Check

  1. פותחים את מסוףFirebase ובתפריט הניווט לוחצים על Build (פיתוח) > App Check (בדיקת אפליקציות).

  2. לוחצים על שנתחיל? ואז על הרשמה לצד האפליקציה.

  3. לוחצים כדי להרחיב את ReCAPTCHA ומדביקים את מזהה המפתח שיצרתם עבור reCAPTCHA Enterprise.

  4. לוחצים על שמירה.

שלב 3: מוסיפים App Check לקוד

  1. חוזרים אל Firebase Studio ובתצוגה Code מוסיפים את מפתח האתר שיצרתם לקובץ .env:

    NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  2. אם עדיין לא שמרתם את ההגדרה של Firebase ב-.env, אתם צריכים להשיג אותה:

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

    • מתוך תצוגת הטרמינל ב-Code:

      1. מתחברים ל-Firebase: firebase auth login
      2. בוחרים את הפרויקט: firebase use FIREBASE_PROJECT_ID
      3. מקבלים את התצורה של Firebase: firebase apps:sdkconfig

  3. מוסיפים את ההגדרה לקובץ .env כך שהוא ייראה כך:

    NEXT_PUBLIC_FIREBASE_API_KEY=FIREBASE_API_KEY
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=FIREBASE_AUTH_DOMAIN
NEXT_PUBLIC_FIREBASE_PROJECT_ID=FIREBASE_PROJECT_ID
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=FIREBASE_STORAGE_BUCKET
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=FIREBASE_MESSAGING_SENDER_ID
NEXT_PUBLIC_FIREBASE_APP_ID=FIREBASE_APP_ID
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  4. מוסיפים את App Check לקוד האפליקציה. אפשר לבקש מ-Gemini להוסיף את App Check עם reCAPTCHA Enterprise לאפליקציה (חשוב לציין "reCAPTCHA Enterprise" ולבדוק שוב!), או לפעול לפי השלבים במאמר Initialize App Check.

  5. מפרסמים מחדש את האתר בכתובת App Hosting. מנסים לבדוק את מסד הנתונים ואת תכונות האימות כדי ליצור נתונים.

  6. כדי לוודא שמערכת App Check מקבלת בקשות, פותחים את המסוף Firebase ועוברים אל Build (גרסה) > App Check (בדיקת אפליקציה).

  7. לוחצים על סמל הבדיקה Cloud Firestore. אחרי שמוודאים שהבקשות מגיעות, לוחצים על Enforce (אכיפה) כדי לאכוף את App Check.

  8. חזרו על תהליך האימות והאכיפה עבור Firebase Authentication.

אם אחרי שרשמתם את האפליקציה שלכם ל-App Check, אתם רוצים להריץ אותה בסביבה ש-App Check בדרך כלל לא מסווגת כסביבה תקפה, כמו בסביבה מקומית במהלך פיתוח או בסביבת שילוב רציף (CI), אתם יכולים ליצור גרסת ניפוי באגים של האפליקציה שמשתמשת בספק ניפוי הבאגים של App Check במקום בספק אימות אמיתי. מידע נוסף על שימוש ב-App Check עם ספק ניפוי הבאגים באפליקציות אינטרנט

מעקב אחרי האפליקציה

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

  • לוחצים על פרסום כדי לפרסם גרסה חדשה של האפליקציה.
  • משתפים את הקישור לאפליקציה או פותחים את האפליקציה ישירות דרך הכניסה לאפליקציה.
  • עיון בסיכום של ביצועי האפליקציה ב-7 הימים האחרונים, כולל המספר הכולל של הבקשות והסטטוס של ההשקה האחרונה. לחיצה על הצגת פרטים תאפשר לכם לגשת למידע נוסף בFirebase מסוף.
  • אפשר לראות תרשים של מספר הבקשות שהאפליקציה קיבלה ב-24 השעות האחרונות, עם פירוט לפי קוד סטטוס של HTTP.
  • לראות את סטטוס ההפעלה של שירותי Firebase כמו Firebase Authentication ו-Cloud Firestore.

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

מידע נוסף על ניהול והשקה של גרסאותApp Hosting

החזרה של הפריסה

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

  • כדי לחזור לגרסה קודמת של אתר שפורסם:

    1. פותחים את App Hosting במסוף Firebase.

    2. מאתרים את הקצה העורפי של האפליקציה, לוחצים על תצוגה ואז על השקות.

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

    מידע נוסף על ניהול השקות והפצות

  • כדי להסיר את הדומיין App Hosting מהאינטרנט:

    1. במסוף Firebase, פותחים את App Hosting ולוחצים על View בקטע של אפליקציית Firebase Studio.

    2. בקטע Backend information (פרטי השרת), לוחצים על Manage (ניהול). הדף Domains (דומיינים) נטען.

    3. לצד הדומיין, לוחצים על סמל האפשרויות הנוספות ואז בוחרים באפשרות השבתת הדומיין ומאשרים.

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

שימוש ב-Genkit Monitoring לתכונות שפרסתם

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

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

שלב 1: מוסיפים טלמטריה לקוד של זרימת Genkit ב-Firebase Studio

כדי להגדיר מעקב בקוד:

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

  2. בודקים את package.json כדי לוודא איזו גרסה של Genkit מותקנת.

  3. פותחים את הטרמינל (Ctrl-Shift-C או Cmd-Shift-C ב-MacOS).

  4. לוחצים בתוך הטרמינל ומתקינים את הפלאגין של Firebase באמצעות הגרסה שתואמת לקובץ package.json. לדוגמה, אם חבילות Genkit ב-package.json הן בגרסה 1.0.4, צריך להריץ את הפקודה הבאה כדי להתקין את הפלאגין:

    npm i --save @genkit-ai/firebase@1.0.4

  5. בסייר, מרחיבים את src > ai > flows. קובץ אחד או יותר של TypeScript שמכילים את זרימות Genkit מופיעים בתיקייה flows.

  6. לוחצים על אחד מהזרימות כדי לפתוח אותו.

  7. בתחתית הקטע imports (ייבוא) בקובץ, מוסיפים את השורה הבאה כדי לייבא ולהפעיל את FirebaseTelemetry:

    import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry();

שלב 2: הגדרת הרשאות

‫Firebase Studio הפעיל את ממשקי ה-API הנדרשים בשבילכם כשהוא הגדיר את פרויקט Firebase, אבל אתם צריכים גם לתת הרשאות לחשבון השירות App Hosting.

כדי להגדיר הרשאות:

  1. במסוף Google Cloud, נכנסים לדף IAM ובוחרים את פרויקט Firebase.

  2. מקצים את התפקידים הבאים לחשבון השירות של App Hosting:

    • כותב מדדי מעקב (roles/monitoring.metricWriter)
    • ‫Cloud Trace Agent ‏ (roles/cloudtrace.agent)
    • Logs Writer (roles/logging.logWriter)

  3. פרסום מחדש של האפליקציה ב-App Hosting.

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

שלב 3: מעקב אחרי תכונות מבוססות-AI גנרטיבי במסוף Firebase

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

כדי לעקוב אחרי תכונות מבוססות-AI שהוטמעו באמצעות Genkit:

  1. אחרי חמש דקות, במסוף Firebase, עוברים אל AI Services > Genkit כדי לבדוק את ההנחיות והתשובות מ-Genkit.

  2. אפשר לעיין במדדי היציבות הבאים שנאספו על ידי Genkit:

    • סך כל הבקשות: המספר הכולל של הבקשות שהתקבלו בתהליך.
    • שיעור ההצלחה: אחוז הבקשות שעובדו בהצלחה.
    • זמן האחזור במאיון ה-95: זמן האחזור במאיון ה-95 של התהליך, שהוא הזמן שנדרש לעיבוד של 95% מהבקשות.

    • השימוש בטוקנים:

      • טוקנים של קלט: מספר הטוקנים שנשלחו למודל בהנחיה.
      • טוקנים של פלט: מספר הטוקנים שהמודל יצר בתגובה.

    • Image usage:

      • תמונות קלט: מספר התמונות שנשלחו למודל בהנחיה.
      • תמונות פלט: מספר התמונות שנוצרו על ידי המודל בתגובה.

  3. אפשר להרחיב את מדדי היציבות כדי לראות את התרשימים המפורטים הבאים:

    • נפח הבקשות לאורך זמן.
    • שיעור ההצלחה לאורך זמן.
    • טוקנים של קלט ופלט לאורך זמן.
    • השהיה (האחוזון ה-95 וה-50) לאורך זמן.

מידע נוסף על Genkit מופיע במסמכי התיעוד שלו.

השלבים הבאים