פיתוח אפליקציות ב-Google AI Studio

בדף הזה מוסבר איך להשתמש ב-Google AI Studio כדי ליצור במהירות (או "לכתוב קוד בהשראה") ולפרוס אפליקציות שבודקות את היכולות העדכניות של Gemini, כמו Nano Banana ו-Live API. ‫Google AI Studio תומך עכשיו בזמני ריצה מלאים, ומאפשר לכם ליצור אפליקציות חזקות עם לוגיקה בצד השרת, ניהול מאובטח של סודות ותמיכה בחבילות npm, והכול באמצעות הנחיות בשפה טבעית.

שנתחיל?

מתחילים לתכנת בשיטת Vibe code במצב הבנייה של Google AI Studio. יש כמה דרכים להתחיל לבנות:

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

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

מה נוצר?

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

  • צד הלקוח: חזית אתר (React היא ברירת המחדל).
  • בצד השרת: סביבת זמן ריצה של Node.js שמאפשרת לבצע קריאות מאובטחות ל-API, חיבורים למסדי נתונים ושימוש בחבילות npm.

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

הסוכן של Antigravity

‫Antigravity Agent הוא פונקציית ה-AI העיקרית ב-Google Antigravity, ועכשיו רכיבי הליבה של agent harness מפעילים את חוויית השימוש במצב Build ב-Google AI Studio. הוא לא רק יוצר קוד פשוט, אלא גם שומר על ההקשר של הפרויקט כולו, מנהל קבצים מרובים ומבין הוראות מורכבות כדי ליצור אפליקציות חזקות עם סט מלא של טכנולוגיות.

היכולות העיקריות:

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

יכולות פול סטאק

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

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

מידע נוסף על פיתוח אפליקציות Full-stack

המשך בנייה

אחרי ש-Google AI Studio יוצר את הקוד הראשוני לאפליקציה, אפשר להמשיך ולשפר אותו:

פיתוח ב-Google AI Studio

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

פיתוח חיצוני

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

  • הורדה ופיתוח מקומיים: מייצאים את הקוד שנוצר כקובץ ZIP ומייבאים אותו לעורך הקוד.
  • דחיפה ל-GitHub: כדי לשלב את הקוד בתהליכי הפיתוח והפריסה הקיימים, דוחפים אותו למאגר ב-GitHub.

תכונות עיקריות

‫Google AI Studio כולל כמה תכונות שהופכות את תהליך הבנייה לאינטואיטיבי ולוויזואלי:

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

פריסה או העברה לארכיון של האפליקציה

אחרי שהאפליקציה מוכנה, אפשר לפרוס אותה:

  • ‫Google Cloud Run: פריסת האפליקציה כשירות ניתן להרחבה. יכול להיות שיחול תמחור על Google Cloud Run בהתאם לשימוש.
  • ‫GitHub: ייצוא הפרויקט למאגר ב-GitHub.

מגבלות

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

אבטחה של מפתח API

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

פריסה מחוץ ל-Google AI Studio

  • אפשר לפרוס את האפליקציה ב-Cloud Run לכתובת URL ציבורית, אבל בהגדרה הזו מפתח ה-API ישמש את כל המשתמשים לקריאות ל-Gemini API.
    • אפליקציות JavaScript מופעלות בצד הלקוח, ולכן חשוב לוודא שלמפתחות ה-API יש גישה מינימלית בלבד כדי למנוע דליפות נתונים או שימוש לרעה. לדוגמה, יכול להיות שלמשתמשים תהיה גישה למאגרי מידע אחרים של חיפוש קבצים מאותו פרויקט באמצעות המנגנון הזה.
  • פריסה חיצונית מאובטחת: כדי להפעיל אפליקציה בצורה מאובטחת מחוץ ל-AI Studio (למשל, אחרי שמורידים את קובץ ה-ZIP), צריך להעביר את הלוגיקה שמשתמשת במפתח ה-API לרכיב בצד השרת כדי למנוע חשיפה של המפתח למשתמשי הקצה. הפעולה הזו לא נדרשת אם פורסים באמצעות Cloud Run.
  • אזהרה לגבי חשיפת מפתח: לא מומלץ להחליף את ה-placeholder במפתח API אמיתי בסביבת צד לקוח, כי המפתח יהיה גלוי לכל משתמש.

שגיאה בשיתוף אפליקציות

אם שיתפתם את האפליקציה ומשתמש הקצה נתקל בשגיאה 403 Access Restricted בזמן השימוש בכתובת ה-URL ששותפה, יכול להיות שהסיבה לכך היא אחת מהאפשרויות הבאות:

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

שאלות נפוצות

מה זה Build ב-AI Studio?

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

למה Build שולח קריאה ל-Gemini API מקוד בצד הלקוח?

בדרך כלל, השיטה המומלצת היא לשלוח קריאה ל-Gemini API מצד השרת, כדי לא לחשוף את מפתח ה-API. אבל ל-AI Studio יש Proxy ל-Gemini API לקריאות בצד הלקוח, שמצרף את מפתח ה-API בלי לחשוף אותו בקוד. בשלב הזה אנחנו יוצרים קריאות בצד הלקוח כדי להשתמש ב-proxy הזה, כי זה מפשט את הקוד ומאפשר לכם לשתף את האפליקציה עם אחרים בלי לספק מפתח API.

האם מפתח ה-API שלי נחשף כשמשתפים אפליקציות?

אל תשתמשו במפתח API אמיתי באפליקציה. במקום זאת, השתמשו בערך placeholder. הערך של process.env.GEMINI_API_KEY מוגדר כ-placeholder שאפשר להשתמש בו. כשמשתמש אחר משתמש באפליקציה שלכם, AI Studio מעביר את הקריאות ל-Gemini API, ומחליף את ערך ה-placeholder במפתח ה-API של המשתמש (ולא שלכם). אל תשתמשו במפתח API אמיתי באפליקציה, כי הקוד גלוי לכל מי שיכול לראות את האפליקציה.

מי יכול לראות את האפליקציות שלי?

כברירת מחדל, האפליקציה שלכם פרטית. אתם יכולים לשתף את האפליקציה עם משתמשים אחרים כדי לאפשר להם להשתמש בה. משתמשים ששיתפתם איתם את האפליקציה יכולים לראות את הקוד שלה ולבצע Fork (פיצול) כדי להשתמש בו למטרות שלהם. אם משתפים את האפליקציה עם הרשאת עריכה, משתמשים אחרים יכולים לערוך את הקוד של האפליקציה.

האם אפשר להפעיל אפליקציות מחוץ ל-AI Studio?

אפשר לפרוס את האפליקציה ב-Cloud Run מ-AI Studio, וכך האפליקציה תקבל כתובת URL ציבורית. היא נפרסת יחד עם שרת proxy שישמור על מפתח ה-API שלכם כפרטי, אבל האפליקציה שנפרסה תשתמש במפתח ה-API שלכם לכל הקריאות ל-Gemini API של המשתמשים. אפשר גם להוריד את האפליקציה כקובץ ZIP. אם מחליפים את ערך ה-placeholder במפתח API אמיתי, הוא עדיין אמור לפעול. אבל לא מומלץ לפרוס את האפליקציה בצורה הזו, כי כל משתמש יוכל לראות את מפתח ה-API. כדי להפעיל אפליקציה בצורה מאובטחת מחוץ ל-AI Studio, צריך להעביר חלק מהלוגיקה לצד השרת, כדי שמפתח ה-API לא ייחשף יותר.

האם אפשר לפתח אפליקציות באופן מקומי באמצעות כלים משלי ואז לשתף אותן כאן?

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

איך אפשר להשתמש במסד נתונים או באחסון אחר באפליקציות שלי?

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

אנחנו מתכננים להוסיף בעתיד תמיכה ישירה באחסון, שאותה תוכלו להגדיר ישירות ב-AI Studio.

כדי לוודא שהצופים מודעים לשימוש של האפליקציה במצלמת האינטרנט או במכשירים אחרים שלהם, אנחנו דורשים אישור נוסף לפני שהאפליקציה מקבלת גישה לממשקי ה-API של Navigator. יוצרי אפליקציות יכולים להוסיף את בקשות ההרשאה האלה לקובץ metadata.json של האפליקציה שלהם. לדוגמה:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

הערכים הנתמכים של requestFramePermissions הם קבוצת משנה של התכונות הרגילות שמבוקרות על ידי מדיניות.

איך אפשר להשתמש ב-GitHub עם האפליקציות שלי?

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

האם אפשר לתת למשתמשים אחרים גישת עריכה לאפליקציה שלי?

האפשרות הזו עדיין לא נתמכת, אבל היא תהיה זמינה בקרוב.

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

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

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

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

מה האחריות שלי כמפתח אפליקציות?

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

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

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

התנאים וההגבלות הנוספים של Gemini API חלים על השימוש באפליקציות שמוצגות בגלריית האפליקציות ב-AI Studio, אלא אם צוין אחרת.

המאמרים הבאים