תכונת ביצוע הקוד של Gemini API מאפשרת למודל ליצור ולהריץ קוד Python, וללמוד באופן איטרטיבי מהתוצאות עד שהוא מגיע לפלט הסופי. אפשר להשתמש ביכולת הזו של ביצוע הקוד כדי לפתח אפליקציות שיפיקו תועלת מחשיבה מבוססת-קוד ומפיקות פלט טקסט. לדוגמה, אתם יכולים להשתמש בביצוע קוד באפליקציה שפותרת משוואות או מעבדת טקסט.
ביצוע קוד זמין גם ב-AI Studio וגם ב-Gemini API. ב-AI Studio, אפשר להפעיל את הפעלת הקוד בחלונית השמאלית בקטע כלים. Gemini API מספק הפעלת קוד ככלי, בדומה להפעלת פונקציות. אחרי שמוסיפים הפעלת קוד ככלי, המודל מחליט מתי להשתמש בו.
סביבת ביצוע הקוד כוללת את הספריות הבאות: altair, chess, cv2, matplotlib, mpmath, numpy, pandas, pdfminer, reportlab, seaborn, sklearn, statsmodels, striprtf, sympy ו-tabulate. אתם לא יכולים להתקין ספריות משלכם.
לפני שמתחילים
לפני שמפעילים את Gemini API, צריך לוודא שה-SDK שבחרתם מותקן ושהגדרתם מפתח Gemini API מוכן לשימוש.
התחלת העבודה עם ביצוע קוד
קלט/פלט (I/O)
החל מ-Gemini 2.0 Flash, הרצת הקוד תומכת בקלט של קבצים ובפלט של תרשים. באמצעות יכולות הקלט והפלט החדשות, אפשר להעלות קובצי CSV וקובצי טקסט, לשאול שאלות לגבי הקבצים וליצור תרשימים של Matplotlib כחלק מהתשובה.
תמחור I/O
כשמשתמשים בקלט/פלט של הפעלת קוד, מחויבים על אסימוני קלט ואסימוני פלט:
אסימוני קלט:
- הנחיה למשתמש
אסימוני פלט:
- הקוד שנוצר על ידי המודל
- הפלט של ביצוע הקוד בסביבת הקוד
- הסיכום שנוצר על ידי המודל
פרטי קלט/פלט (I/O)
כשאתם עובדים עם קלט/פלט של ביצוע קוד, חשוב לשים לב לפרטים הטכניים הבאים:
- זמן הריצה המקסימלי של סביבת הקוד הוא 30 שניות.
- אם סביבת הקוד יוצרת שגיאה, המודל עשוי להחליט ליצור מחדש את פלט הקוד. זה יכול לקרות עד 5 פעמים.
- גודל הקלט המקסימלי של הקובץ מוגבל על ידי החלון של אסימון המודל. ב-AI Studio, באמצעות Gemini Flash 2.0, הגודל המקסימלי של קובץ קלט הוא מיליון אסימונים (בערך 2MB לקובצי טקסט של סוגי הקלט הנתמכים). אם מעלים קובץ גדול מדי, אי אפשר לשלוח אותו באמצעות AI Studio.
| תור אחד | דו-כיווני (Multimodal Live API) | |
|---|---|---|
| דגמים נתמכים | כל הדגמים של Gemini 2.0 | רק מודלים ניסיוניים של Flash |
| סוגי קלט של קבצים נתמכים | .png, .jpeg, .csv, .xml, .cpp, .Java, .py, .js, .ts | .png, .jpeg, .csv, .xml, .cpp, .Java, .py, .js, .ts |
| ספריות נתמכות בתרשים | Matplotlib | Matplotlib |
| שימוש במספר כלים | לא | כן |
חיוב
ההפעלה של קוד מ-Gemini API לא כרוכה בתשלום נוסף. נחייב אותך בתעריף הנוכחי של אסימוני הקלט והפלט בהתאם למודל Gemini שבו השתמשת.
כמה דברים נוספים שכדאי לדעת לגבי חיוב עבור ביצוע קוד:
- מחויבים רק פעם אחת על אסימוני הקלט שמעבירים למודל, ומחויבים על אסימוני הפלט הסופי שהמודל מחזיר.
- אסימונים שמייצגים קוד שנוצר נספרים כאסימוני פלט. הקוד שנוצר יכול לכלול טקסט ופלט מרובה מצבים, כמו תמונות.
- תוצאות של ביצוע קוד נספרות גם כאסימוני פלט.
מודל החיוב מוצג בתרשים הבא:
- החיוב מתבצע לפי התעריף הנוכחי של אסימוני הקלט והפלט בהתאם למודל Gemini שבו משתמשים.
- אם Gemini משתמש בהפעלת קוד בזמן יצירת התשובה, ההנחיה המקורית, הקוד שנוצר והתוצאה של קוד ההרצה מסומנים בתווית אסימוני ביניים ומחויבים כאסימוני קלט.
- לאחר מכן Gemini יוצר סיכום ומחזיר את הקוד שנוצר, את התוצאה של הקוד להרצה ואת הסיכום הסופי. הם מחויבים כאסימוני פלט.
- Gemini API כולל ספירה של אסימוני ביניים בתגובת ה-API, וכך אפשר להבין למה אתם מקבלים אסימוני קלט נוספים מעבר להנחיה הראשונית.
מגבלות
- המודל יכול רק ליצור ולהריץ קוד. הוא לא יכול להחזיר ארטיפקטים אחרים, כמו קובצי מדיה.
- במקרים מסוימים, הפעלת קוד יכולה להוביל לרגרסיות בתחומים אחרים של פלט המודל (למשל כתיבת סיפור).
- יש הבדלים מסוימים ביכולת של המודלים השונים להשתמש בהצלחה בהפעלת קוד.